| name | spec-continue |
| description | Resume an in-progress spec: audit inherited work for drift, then continue execution |
| argument-hint | <spec folder or plan file path> |
Continue a Spec
Resume a spec started in another session. Read spec-execute first - all its phases and CRITICAL rules apply verbatim; this skill adds only the resume protocol. The resume failure mode is always the same: inherited code drifts from the spec, and new work gets stacked on the drift.
Resume protocol
- Read the spec end-to-end; find where work actually paused - from the last tick/commit, not from the top.
- Rebuild repo state:
git status, git log --oneline -20, git branch --show-current, gh pr list --head <branch>.
- Triage uncommitted working-tree changes not made by this session: diff each file against the spec's target shape, not against the last commit. Aligned - absorb and say so. Divergent - present an A-vs-B choice (revert to spec shape vs fix in place); never silently absorb, never
git restore someone's work without approval. Stage selectively (git add <file>), never git add -A on resume.
- Drain unacked PR feedback first:
gh pr checks <pr> + gh pr view <pr> --json reviews,comments, then git-review-pr-comments. Red lights before new work.
- Reconcile
tasks.md vs real commits: tick what shipped; a [x] with no matching commit is a regression to investigate.
- Audit the inherited last commit for cross-cutting drift: removed symbol still called elsewhere; migration landed but consumers stale; hand-rolled component where a shared one exists; pattern invented where a sibling covers it. Any hit - the next commit is a rescope to the spec, not a continuation.
- Re-read the plan's MUST READ FIRST preamble; then continue per
spec-execute Phase C verbatim.
Verify
- Inherited work reconciled (absorbed, rescoped, or surfaced); PR feedback drained; next task identified from the spec.
Scope / hand-off
- Fresh execution -
spec-execute; spec authoring - spec-create.
CRITICAL
- Never assume the spec reflects reality - re-sync with the repo first.
- Never delete or rewrite pushed work: fix-commit forward.
- Branch behind its base - ask merge or rebase; never silently diverge.
- "Reconcile with the spec's target shape" ranks above "tick the next checkbox".