Files
PaperClipAI/maps/feature-map/projects.md
DottaandPaperclip 473c80d13f Automatically import and update project repository skills (#16066)
Automatically import skills from new GitHub project repositories and update enabled sources in the background. Preserve project-derived access, saved selections, immutable execution versions and explicit pins; add legacy adoption, refresh and connection repair in Sources.

Include durable scheduling and bounded work credits, production Storybook journeys, real GitHub-to-routine acceptance receipts and final-head CI/security/Greptile qualification.

Co-Authored-By: Paperclip <noreply@paperclip.ing>
2026-10-13 16:11:43 -05:00

3.5 KiB

navigation
navigation
section sectionOrder order
Projects and execution 40 10

Projects and repositories

People group tasks into projects, attach goals and repositories, and configure the context and defaults used by project work.

Implementation: project list, project detail.

Agent access: companion.

Sub-features

  • lifecycle: create, name, organize, and archive projects.
  • task-context: inspect project tasks and create work in the selected project.
  • repositories: configure repository/workspace sources and verify usable checkouts.
  • defaults: maintain project instructions, environment, goal, and budget context where offered.

How to get to it (user POV)

project-list

Open /projects, create a project, and enter its overview or Issues view.

repository-settings

Open /projects/:projectId/configuration and its repository/workspace settings.

Driving it with Playwright and the Paperclip CLI

Preconditions: follow the baseline. Use a disposable project and a small repository you can access; record checkout and credential ownership.

project-list

Automated: projects UI and project detail are component tests.

Manual: Create a project, add a task from its view, and reload. Verify the task belongs to that project, list counts are plausible, and links preserve company scope. Archive only the disposable project and inspect list/task behavior.

repository-settings

Automated: repository persistence and repository browser suite cover configured repository workflows.

Manual: Attach a small repository, save, and create a project task. Inspect the actual checkout/revision used by its run. Test an invalid repository and missing credentials without treating a saved URL as a working workspace.

Gotchas

  • /overview now selects Configuration, not a distinct overview page. Personal join/leave and star controls have their own persistence and should be checked when affected; Star/Unstar {project name} is the visible star action.

  • Project name slugs change on rename and have no historical alias lookup. Reopen a renamed project through its stable UUID route, wait for the current Configuration form, and record the newly normalized URL before reloading.

  • Project repository configuration and a provisioned execution workspace are different records.

  • See workspaces, goals, and budgets for those features.

  • Do not assume a deleted or archived project should erase its historical task evidence.

Automatic repository skills

Creating or attaching a GitHub repository enqueues skill import without another setup step. Check Skills → Sources and the installed library afterward. Ordinary edits to older projects do not adopt their repositories; explicit adoption belongs in Sources. Removing a repository retains installed skills and originating project access but stops its automatic tracking. Changing the ref does not retarget existing skill references.

Documentation scope: Projects and execution workspaces

Provider-specific provisioning, multi-repository/submodule edge cases, Git reconciliation variants, and all service exposure combinations require deeper recipes.