Squid Plan

Step 4 — HUMAN GATE (blocking)

This is the only gate, and it is mandatory. It decides everything that touches the repo. Recap the decision inputs, then ask:

Feature: {title}
Tasks ({N}):
  1. {NNN-slug} — {title}
  2. ...
Glossary additions: {M new terms, or "none"}
Proposed ADR: {ADR-NNNN "title" — 1-line summary, or "none"}
Task storage (project default): {file → local tasks/*.md | gh → GitHub Issues}   ← from AGENTS.md TRACKER_MODE

Then ask with AskUserQuestion. The decisions come in two back-to-back asks — still ONE gate, with no repo writes between them: Part 2 only matters once the plan is approved, and AskUserQuestion caps at four questions per call.

Part 1 — the plan and its artifacts (ask together, then act on Q1):

1. Approve the plan? — write these {N} tasks? → Approve / Edit / Cancel
2. Store the tasks where? — → Local files (tasks/<NNN>-<slug>.md, committed to the repo) / GitHub Issues (one issue per task). Pre-select the project default (AGENTS.md TRACKER_MODE) and mark it Recommended.
3. Create the ADR? — write the proposed ADR to docs/adr/? → Create / Skip (omit this question entirely if no ADR was proposed)
4. Update the glossary? — apply the {M} drafted term(s) to docs/glossary.md? → Apply / Skip (omit this question entirely if the PA drafted no glossary additions)

• Cancel → stop and discard the drafts; nothing has been written or branched. Do not ask Part 2.
• Edit → ask what to add / remove / reorder / re-split; re-launch the PA (Step 2); loop back to this gate.
• Approve → ask Part 2, then go to Step 5 carrying every answer.

Part 2 — workspace and build (only on Approve):

5. Workspace? — where should branch feat/{slug} live? → New worktree (isolated ../{repo}-{slug} dir) / Current working tree (branch in place)
6. Build now? — what runs after setup? → /squid-implement-night (end-to-end to a validated PR) / /squid-implement-task loop (build + commit the tasks only, no review/CI) / Stop after planning

Step 5 — Execute the decisions (only after the final plan + Approve)

Do these in order.

A. Set up the workspace (Q5).

• New worktree:

  git rev-parse --abbrev-ref HEAD          # expect main; if not, ask the human how to proceed
  git pull
  WORKTREE_PATH="$(git rev-parse --show-toplevel)/../$(basename $(git rev-parse --show-toplevel))-{slug}"
  git worktree add -b feat/{slug} "$WORKTREE_PATH" main

  If it already exists (re-running after an abort): tell the human, ask reuse (r) / recreate (d) — default reuse.
• Current working tree:

  git pull
  git switch -c feat/{slug}                # if already on a feat/* branch, reuse it instead

  WORKTREE_PATH = the repo root.

B. Write the approved artifacts into the workspace. Write to absolute paths under $WORKTREE_PATH (for a new worktree the orchestrator's cwd is still the main repo — do NOT write the tasks into main):

• Tasks (Q2). Local files → one $WORKTREE_PATH/tasks/<NNN>-<slug>.md per task (status: pending) from the Step 2 drafts. GitHub Issues → gh issue create one issue per task from the same drafts, in NNN order (titles NNN — {slug}, body = the groomed spec). The chosen mode is this feature's tracker for the rest of the pipeline; if it differs from AGENTS.md TRACKER_MODE, it's a one-off override for this plan — don't rewrite AGENTS.md.
• Glossary (Q4). If Apply: apply the drafted additions to $WORKTREE_PATH/docs/glossary.md. If Skip (or none were drafted): discard them.
• ADR (Q3). If Create: write $WORKTREE_PATH/docs/adr/NNNN-<slug>.md (Status: Accepted) from the ADR draft. If Skip: discard the draft.
• Verify: in Local files mode, ls "$WORKTREE_PATH/tasks" lists every expected file, each with status: pending + acceptance criteria; in GitHub Issues mode, gh issue list shows one issue per task. If anything is missing, write it now — do not hand off an empty plan.

C. Kick off the build (Q6).

• /squid-implement-night → invoke /squid-implement-night with: feature {slug}, Working directory: $WORKTREE_PATH.
• /squid-implement-task loop → invoke /squid-implement-task with: the feature's pending tasks (tasks/<NNN>-*.md, status: pending), Working directory: $WORKTREE_PATH.
• Stop after planning → hand off and stop:

  Plan approved. {N} tasks in tasks/ (status: pending) on `feat/{slug}` ({worktree at $WORKTREE_PATH | current working tree}).
  Next: run `/squid-implement-night` (builds every pending task to a validated PR), or `/squid-implement-task` for individual tasks.

/squid-plan ends here.

Notes

• Task-file shape: see the tracker-workflow spec (squid-scaffold/specs/tracker-workflow.md); ADR rules live in the product-architect agent contract.