SuperAPI AI Directory

fork

Coding & development

View repository

Updated 10-23 23:07

About this skill

Your objective is to create a git worktree for isolated exploration.

Before proceeding, verify that .cocoplus/ exists. If not: output "CocoPlus not initialized in this directory. Run $pod init to begin." Then stop.

Usage

$fork [branch-name] — creates a worktree on branch explore/[branch-name]

If no branch-name provided: output "Usage: $fork [branch-name] — e.g., $fork try-new-schema" Then stop.

Create Worktree

BRANCH_NAME="explore/[branch-name]"
WORKTREE_PATH="../[project-dir]-explore-[branch-name]"
git worktree add "$WORKTREE_PATH" -b "$BRANCH_NAME"

Output

Output:

Exploration worktree created.
Branch: explore/[branch-name]
Path: [worktree-path]

In the new worktree, all .cocoplus/ state is shared (same files).
Your changes in the worktree are isolated on the explore/[branch-name] branch.

To merge back:  git merge explore/[branch-name]
To discard:     git worktree remove [worktree-path] && git branch -d explore/[branch-name]

Anti-Rationalization

Shortcut / Temptation Why It Fails
Create a branch without using a worktree A branch without a worktree shares the working directory; changes in the exploration bleed into the main session
Use a flat branch name instead of explore/ prefix The explore/ prefix clearly marks the branch as temporary exploration; flat names get lost among feature branches

Exit Criteria

  • A git worktree exists at [project-dir]-explore-[branch-name] path
  • Branch explore/[branch-name] exists in the git repository
  • Output shows worktree path, branch name, merge command, and discard command