executing-plans
executing-plans
Use when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available
gateVerification before completion claims. Use when about to say "done", "fixed", or "complete". Runs checklist by workflow type with evidence requirements.
Independent GitHub snapshot · Automated classification · Original documentation governs
Verify before claiming completion.
Before claiming: "done", "fixed", "complete", "working", "ready"
Run before substantial work begins. Blocks execution if missing.
□ Verification method locked (not "assumption")
→ What type: execution output / observation / measurement?
→ What evidence will you show?
□ At least 2 "must NOT" criteria exist
→ What should this NOT do?
→ What scope should NOT expand?
□ Fit score determined workflow shape
→ <25: BLOCKED - clarify first
→ 25-29: Colleague-shaped (iterate each step)
→ 30-39: Tool-with-review (checkpoint major steps)
→ 40+: Tool-shaped (milestones only)
If any missing: STOP. Complete before proceeding.
□ Feature executes without errors (show output)
□ Edge cases tested (empty, null, boundary)
□ Rollback tested if Type 2B/1
□ Dependencies verified
□ Root cause identified with evidence
□ Fix tested and resolves symptom
□ Prevention added (test/automation/guard)
□ Related bugs checked (same class)
□ Existing tests pass unchanged
□ Behavior identical (output comparison)
□ Deletion complete (no orphans)
□ No new abstraction without justification
| Type | Description | Sufficient for SHIP? |
|---|---|---|
execution output | Ran command, showed result | ✓ Yes |
observation | Screenshot, debugger session | ✓ Yes |
measurement | Metrics, benchmark data | ✓ Yes |
reasoned inference | Logic-based conclusion | ⚠️ Flag, don't block |
code review | Inspection only | ⚠️ Weak |
assumption | Not verified | ⚠️ Flag with warning |
Default: Require execution output, observation, or measurement before completion claims.
Gates advise, never prevent. User owns their work.
Gate exists to surface risk, not to block legitimate intuition.
Before claiming completion, define how you'll verify:
| Verification Type | Evidence Required | Time Cost |
|---|---|---|
| Execution output | Command output, test results | < 1 min |
| Observation | Screenshot, debugger inspection | 1-5 min |
| Measurement | Metrics, benchmarks, profiling | 5-15 min |
| Code review | Manual inspection only | Variable |
| Assumption | No verification | 0 (blocks SHIP) |
| Stakes | Minimum Verification |
|---|---|
| High | Execution output + Observation |
| Medium | Execution output |
| Low | Code review acceptable |
| Claim | Problem | Required |
|---|---|---|
| "Should work" | Speculation | Actual output |
| "Looks good" | No verification | Test results |
| "Fixed the issue" | No proof | Before/after |
| "I think this resolves it" | No confidence % | X-Y% + basis |
When blocked, state:
Trivial changes (< 1 min rollback): completion allowed without full gate. Document undo command.
| Thought | Reality |
|---|---|
| "The tests passed" | Tests ≠ verification. Did you run the ACTUAL command? |
| "It should work" | "Should" = assumption. Show evidence. |
| "I already checked" | When? Show the output. |
| "The user is waiting" | Rushed verification = rework later. |
| "It's a simple change" | Simple changes break production too. |
| "I'm pretty sure it works" | Pretty sure ≠ evidence. Run it. |