Danijel Martinek
317ec518aa
Re-decomposes the approved binder-wrap-helper PRD after the previous 8-story attempt (dropped in71c04f5) sliced horizontally — its "write test" / "write impl" splits would have left intermediate commits red. The new shape obeys slice = task = PR = commit: - 01-wire-use-case-helper — 1 task: ship the wireUseCase helper (factory composition + container bind + brand stack) with its unit tests and barrel export in one green commit. Blocks 02 + 03. - 02-migrate-feature-binders — 5 tasks, one per feature (auth, blog, media, marketing-pages, navigation). Each task migrates that feature's bind-production.ts + bind-dev-seed.ts together and keeps all gates green. - 03-update-generator-templates — 1 task: update the feature generator's bind-*.hbs so future scaffolds emit wireUseCase directly instead of inline withSpan + withCapture. Output of the now-fixed sandcastle decompose dispatch — depends on the completionSignal + maxIterations wiring (eadbb7e,26aa97f).
docs/work — the local task system
Filesystem-backed Epic/Story/Task hierarchy used by AI agents and humans alike.
See docs/architecture/agent-first-workflow-and-conformance.md for the full
design. Until the work-system-v1 epic ships orchestration tooling, this
folder is human-driven — agents read the files for context, humans flip
checkboxes.
Layout
prds/<date>-<slug>.prd.md— source PRDs<epic-slug>/_epic.md— one folder per epic<epic-slug>/<story-slug>/_story.md— one folder per story<epic-slug>/<story-slug>/<task-slug>.task.md— one file per task_templates/— copy-paste templates (added in work-system-v1)_state.json— derived index (added in work-system-v1)
PRD lifecycle
PRD status frontmatter field: draft → in-review → approved → shipped.
- draft → in-review — author flips when ready for review (manual)
- in-review → approved — human reviewer flips on acceptance (manual)
- approved → shipped — auto-flipped by
pnpm work prd-ship <prd-id>when the seed epic finishes. The state-builder surfaces this signal under_state.json→needs_prd_ship[]so the orchestrator (or a reviewer running the sandcastle workflow) can act on it.
The decomposer refuses to run on draft PRDs. Once approved, the seed epic is generated; once the epic completes, the PRD is automatically flipped to shipped along with its commit list.