← ClaudeAtlas

hedgehog-looplisted

Use for every unit of work once a Hedgehog project is bootstrapped — building one layer (schema, contract, repository, service, controller, hook, screen) per module, gated by `hedgehog verify` and committed one layer at a time. Triggers on "next step", "build this module", "what's next", or the start of any work session on a bootstrapped project. Also covers the Correction Protocol for fixing a wrong upstream step.
skyf0xx/hedgehog · ★ 38 · AI & Automation · score 78
Install: claude install-skill skyf0xx/hedgehog
# Hedgehog Loop The operating loop for a bootstrapped Hedgehog project: `hedgehog claim` reserves the packet(s) for ready layers, build them, `hedgehog verify` gates and commits each. The build graph (`.hedgehog/hedgehog.db`) is the live list — query it via `hedgehog status`/`hedgehog ready`, never re-derive state from prose. The step tables below mirror `src/golden-cores/full-stack-app/core.yaml`, the design source of truth for layer order, scope, and verify command per layer — read the tables for the human-readable shape, and the YAML when they seem to disagree. The packet, though, is what actually runs. `hedgehog plan` copies each layer's scope globs, verify command and commit message onto every task row at compile time; from then on the row — not `core.yaml` — is what `hedgehog claim` hands out and `hedgehog verify` gates against, and editing `core.yaml` afterwards does not reach tasks already compiled (a plain `hedgehog plan` re-run won't apply it either — it only reads intents still pending). `hedgehog status` prints a **DRIFT** section whenever the two have diverged, and `hedgehog plan --recompile` rewrites the layer-derived fields on not-yet-started tasks from the current `core.yaml`, refusing — and naming — every task already building, verifying, complete, or blocked. Never patch a task row in SQLite by hand: the DB is derived and gitignored, so `hedgehog db rebuild` drops the patch. ## Determine phase Before touching code, know which phase applies to the module