gm-complete

GM COMPLETE — Verification and Completion

You are in the VERIFY → COMPLETE phase. Files are written. Prove the whole system works end-to-end. Any new unknown = snake to planning, restart chain.

GRAPH POSITION: PLAN → EXECUTE → EMIT → [VERIFY] → UPDATE-DOCS → COMPLETE

• Entry: All EMIT gates passed. Entered from gm-emit.

TRANSITIONS

FORWARD:

• .prd items remain → invoke gm-execute skill (next wave)
• .prd empty + feature work pushed → invoke update-docs skill

BACKWARD:

• Verification reveals broken file output → invoke gm-emit skill, fix, re-verify, return
• Verification reveals logic error → invoke gm-execute skill, re-resolve, re-emit, return
• Verification reveals new unknown → invoke planning skill, restart chain
• Verification reveals requirements wrong → invoke planning skill, restart chain

TRIAGE on failure: broken file output → snake to gm-emit | wrong logic → snake to gm-execute | new unknown or wrong requirements → snake to planning

RULE: Any surprise = new unknown = snake to planning. Never patch around surprises.

MUTABLE DISCIPLINE

• witnessed_e2e=UNKNOWN until real end-to-end run produces witnessed output
• git_clean=UNKNOWN until exec:bash\ngit status --porcelain returns empty
• git_pushed=UNKNOWN until git log origin/main..HEAD --oneline returns empty
• prd_empty=UNKNOWN until .prd file is deleted (not just empty — file must not exist)

All four must resolve to KNOWN before COMPLETE. Any UNKNOWN = absolute barrier.

END-TO-END VERIFICATION

Run the real system with real data. Witness actual output.

NOT verification: docs updates, status text, saying done, screenshots alone, marker files.

exec:nodejs
const { fn } = await import('/abs/path/to/module.js');
console.log(await fn(realInput));

For browser/UI: invoke browser skill with real workflows. Server + client features require both exec:nodejs AND browser. After every success: enumerate what remains — never stop at first green.

CODE EXECUTION

exec: is the only way to run code. Bash tool body: exec:<lang>\n<code>

exec:nodejs (default) | exec:bash | exec:python | exec:typescript | exec:go | exec:rust | exec:java | exec:deno | exec:cmd

Only git in bash directly. Background tasks: exec:sleep\n<id>, exec:status\n<id>, exec:close\n<id>. Runner: exec:runner\nstart|stop|status.

Execution efficiency — pack every run:

• Combine multiple independent operations into one exec call using Promise.allSettled or parallel subprocess spawning
• Each independent idea gets its own try/catch with independent error reporting — never let one failure block another
• Target under 12s per exec call; split work across multiple calls only when dependencies require it
• Prefer a single well-structured exec that does 5 things over 5 sequential execs

CODEBASE EXPLORATION

exec:codesearch
<natural language description>

GIT ENFORCEMENT

exec:bash
git status --porcelain

Must return empty.

exec:bash
git log origin/main..HEAD --oneline

Must return empty. If not: stage → commit → push → re-verify. Local commit without push ≠ complete.

COMPLETION DEFINITION

All of: witnessed end-to-end output | all failure paths exercised | .prd empty | git clean and pushed | user_steps_remaining=0

DO NOT STOP

After end-to-end verification passes: read .prd from disk. If any items remain, immediately invoke gm-execute skill — do not respond to the user. Only respond when .prd is deleted AND git is clean AND all commits are pushed.

CONSTRAINTS

Never: claim done without witnessed output | uncommitted changes | unpushed commits | .prd items remaining | stop at first green | absorb surprises silently | respond to user while .prd has items

Always: triage failure before snaking | witness end-to-end | snake to planning on any new unknown | enumerate remaining after every success | check .prd after every verification pass

---

→ FORWARD: .prd items remain → invoke gm-execute skill (keep going, do not stop). → FORWARD: .prd deleted + feature work pushed → invoke update-docs skill. ↩ SNAKE to EMIT: file output wrong → invoke gm-emit skill. ↩ SNAKE to EXECUTE: logic wrong → invoke gm-execute skill. ↩ SNAKE to PLAN: new unknown or wrong requirements → invoke planning skill, restart chain.