k97 stage-gate
Three quality gates, one at each boundary of a feature cycle.
| Gate | Run it when | It checks | Writes |
|---|---|---|---|
--plan |
a plan exists, no code written yet | assumptions, ambiguity, simpler paths, runnable success criteria | no |
--dev |
code is written, not yet pushed | every hunk traces to the request | no |
--release |
the branch is merged or released | lessons captured, memory file lean and armed | yes |
Run each gate at its boundary even when the work looks finished. That is the moment the gate is for, and the moment it is easiest to skip.
Picking a gate
An explicit flag wins. With no flag, infer from state — then say which gate you picked and why before running it:
- uncommitted or unpushed diff →
--dev - no diff, but a plan in the conversation or a recent plan file →
--plan - clean tree on the default branch →
--release
Gates may be requested together when a request spans two boundaries — "verify and release" is --dev then --release. Run them in cycle order, each with its own artifact, reviewer, and verdict; never merge the reports, and let a blocking --dev stop the sequence. There is no --full: --plan never co-occurs with the others, since by the time there is a diff it has passed or been skipped.
Reference paths below resolve against this skill's own directory; the working directory is the user's project.
Gate 1 — plan review (--plan)
After planning, before any code. Read references/plan-gate.md — it carries the procedure for locating the plan, which is often a file rather than a conversation turn, and the checks to run against it. Send it to a fresh reviewer, not yourself: references/reviewer-separation.md.
Verdict is Ready to build or Needs answers, blocking questions listed. Do not start implementing — the gate ends when the verdict is delivered.
Gate 2 — diff review (--dev)
After coding, before push or PR. Read references/diff-review.md — it carries the procedure for establishing the diff, the three lenses (Simplicity, Surgical, Verification), and the report format. Dispatch to a fresh reviewer per references/reviewer-separation.md; an author reviewing their own diff has every justification still loaded.
Verdict is Ship or Trim first. This gate reports only; fixing the diff is a separate request.
Gate 3 — hygiene pass (--release)
After merge or release. The only gate that writes. Read references/memory-hygiene.md, which resolves the repo's memory file and rules location from references/agents.md. Two jobs, in order:
- Capture lessons from this cycle as rules in the agent's rules location.
- Keep the memory file lean and armed — line-count triage, plus a
## Verificationsection, the coding guardrails, and the gate-trigger block. That block is what makes these gates fire from workflow state instead of waiting to be remembered, so it must sit in the memory file itself.
The reference carries the thresholds, the fast no-op check that makes this affordable every cycle, and the day-zero bootstrap for a repo with no memory file yet.
Edit the working tree and stop — no git add, no git commit. Review and commit belong to the user.
Sources
references/sources.md — provenance, MIT attribution, and why these gates do not replace always-on rules.