agentic-workflow

Scaffold the four durable workflow artifacts (SPEC, ASSUMPTIONS, DECISIONS, LESSONS) in the current project.

Extract every premise a spec takes for granted, rank by cost-if-false, and write ASSUMPTIONS.md. Run as a fresh instance with the spec as the only input, before implementation. Use after a spec or PRP is drafted.

Investigate observed wrong behavior, reproduce-first, and record the understanding (ruled-out hypotheses, root cause) — not just the diff. Use when starting any non-trivial bug, as distinct from implementing a spec item.

Elicit a spec by interviewing the user as a domain expert, then draft SPEC.md / PRPs from their answers. Use at the start of a new project or feature, before any implementation, when requirements are not yet written down.

Run a deletion-only refactor session — remove code, consolidate duplicates, reduce special cases, with zero new behavior and all validation gates passing. Also prune the journals. Use on a cadence (e.g. every N PRPs) or when entropy has accumulated.

Run the end-of-session distillation by hand — capture dead ends in LESSONS.md and non-obvious choices in DECISIONS.md. Use before wrapping up a session, or when the Stop-hook distillation prompt fires.

4 hooks across 4 events