harness-mini

Implement code test-first via the red→green→refactor loop. Use in the implement stage for every issue. Never write implementation before a failing test; never refactor on red. The generator's core working rhythm.

Entropy garbage-collection. Periodically scan for drift — stale docs, dead "always-loaded" context, smells, mismatched conventions — and open small targeted fixes. Use to keep the smart zone smart and the repo coherent for future agent runs. Runs orthogonally to the main lifecycle.

Drive a long-running "work → check → repeat" loop until an exit condition is met, max iterations hit, or a human-judgment flag is raised. Use for autonomous long tasks where an agent does work and an evaluator decides whether it passes (e.g. "keep fixing until all reviewers pass"). Backed by bin/ralph.sh.

Grade work against the plan's acceptance criteria from a SEPARATE context — tiered by risk (L0 self-check, L1 lightweight reviewer [default], L2 full evaluator). Use in the evaluate stage. The anti-self-praise firewall — the agent that built the work must never be the one that grades it. Returns pass/fail per criterion with evidence.

View and advance the lifecycle stage of every requirement. Main-agent only — the single authority that moves a plan through intake→prd→issues→implement⇄evaluate→checkpoint→done. Use to see what stage work is in, route simple vs complex requests, and promote a plan (no sub-agent may self-promote).

Write a committed handoff checkpoint so a fresh session can resume with zero loss. Use when crossing the 40% context line, on every stage transition, and at session end. Writes .trace/checkpoints/<plan>-<seq>.md while the agent is still sharp.

Cut a versioned release of harness-mini — bump VERSION, roll the CHANGELOG, tag, and publish a GitHub release. Use when shipping a new version. Wraps `bin/harness.sh release`; covers the human-judgment steps (semver choice, changelog curation) the script can't make.

The horizontal+vertical coding constraint. Use in the implement stage to decide build order and enforce layering. Vertical = one feature end-to-end as a thin walking skeleton first; Horizontal = forward-only dependencies through a fixed layer stack. Read before writing code.

Fan out the horizontal expansion of the implement stage to parallel generators. Use AFTER the vertical walking skeleton passes evaluate, to build independent features concurrently. The main agent dispatches one generator per issue; parallelism is gated on disjoint file footprints. Vertically related, horizontally independent.

Decompose a PRD into atomic, testable issues — the executable work units the generator implements one at a time. Use in the issues stage. Each issue is independently verifiable and maps to one vertical slice or a step within one.

The forward code-quality constraint (Clean Code). Use while writing code in the implement stage and as a review lens in evaluate. Intention-revealing names, small single-responsibility functions, no duplication, comments that explain why not what.

Apply Elon Musk's Five-Step Algorithm to any requirement or plan before building. Use in the intake/plan stages to question, delete, simplify, accelerate, and automate — in that order. Prevents the expensive mistake of optimizing or automating something that should have been deleted.

Greenfield-only intake gate. Apply founder/startup best-practice (from the Founder's Playbook) before any PRD on a NEW project — who is the user, the smallest valuable slice, the riskiest assumption, the build-measure-learn loop. Skip for existing projects.

The recovery code-quality constraint (Refactoring). Use to improve code structure without changing behavior — smell → named refactoring, always under green tests, one move at a time. Used by the generator (in the tdd refactor step) and the gardener (entropy cleanup).

Turn a raw idea or requirement into an executable PRD document — a versioned artifact the harness treats as a first-class source of truth. Use in the prd stage after founder-check/five-step. Output is agent-readable, testable, and committed.