Add Project Branch

Creates a new project branch from an external GitHub repository.

Usage

/add-project

Instructions

When this command is invoked:

1. •

   Ask the user for required information:

   • •Project name (will be used as branch name and subtree prefix)
   • •GitHub repository URL (e.g., https://github.com/user/repo.git)
   • •Git branch/tag to use from the repository (e.g., main, master, v1.0.0)
2. •

   Verify current state:

   • •Ensure we're on the main branch
   • •Check for uncommitted changes (warn if any exist)
   • •Confirm the project name doesn't conflict with existing branches
3. •

   Create the project branch:

   bash

   git checkout main
   git checkout -b <project-name>
   

4. •

   Add the repository as a git subtree:

   bash

   git subtree add --prefix=<project-name> <github-url> <branch> --squash
   

5. •

   Set up dependencies:

   • •Check if pyproject.toml exists at the root level (it will if the subtree has one)
   • •If it exists: Add the following to the existing pyproject.toml:
     • •Add dev to the [dependency-groups] section:
       toml

       dev = [
         "autopsy",
         "pytest-timeout>=2.4.0",
       ]
       

     • •Add [tool.uv.sources] section (if not already present):
       toml

       [tool.uv.sources]
       autopsy = { path = "autopsy-repo", editable = true }
       

   • •If it doesn't exist: Create a root-level pyproject.toml with:
     toml

     [build-system]
     requires = ["setuptools", "wheel"]
     
     [dependency-groups]
     dev = [
         "autopsy",
         "pytest>=9.0.2",
         "pytest-timeout>=2.4.0",
     ]
     
     [tool.uv.sources]
     autopsy = { path = "autopsy-repo", editable = true }
     

   • •Commit the dependency changes:
     bash

     git add pyproject.toml
     git commit -m "Add autopsy debugging tool dependency"
     

6. •

   Provide next steps:

   • •Suggest running /rebase-branches to propagate changes
   • •Remind user to create bug branches from this project branch using /add-bug

Context

Project branches serve as the base for debugging challenges. Each project branch contains:

• •A complete external repository (via git subtree)
• •Python dependencies managed with uv
• •A clean, working codebase that bug branches will branch from

The project branch itself should NOT contain bugs - it's the baseline. Bugs are added in separate bug branches created with /add-bug.