Convention shift: epic folders + PRD filenames + frontmatter id
fields are now bare slugs. The created: timestamp (Phase 2) carries
the date; folder names don't repeat it. A future <task-id>-<slug>
shape (e.g. ClickUp) lands cleanly when that integration ships.
Renames (git mv preserves history):
- docs/work/2026-05-13-binder-wrap-helper/
-> docs/work/binder-wrap-helper/
- docs/work/2026-05-14-library-evaluation-policy/
-> docs/work/library-evaluation-policy/
- docs/work/2026-05-14-ci-security-and-supply-chain/
-> docs/work/ci-security-and-supply-chain/
- docs/work/prds/2026-05-13-binder-wrap-helper.prd.md
-> docs/work/prds/binder-wrap-helper.prd.md
- docs/work/prds/2026-05-13-coverage-architecture.prd.md
-> docs/work/prds/coverage-architecture.prd.md
- docs/work/prds/2026-05-14-library-evaluation-policy.prd.md
-> docs/work/prds/library-evaluation-policy.prd.md
- docs/work/prds/2026-05-14-ci-security-and-supply-chain.prd.md
-> docs/work/prds/ci-security-and-supply-chain.prd.md
Frontmatter updates inside the renamed files: epic id, epic prd,
story epic, PRD id, PRD builds-on all drop date prefixes.
System folder + state file move:
- New docs/work/_system/ holds framework-managed state.
- docs/work/_state.json -> docs/work/_system/_state.json.
- state-builder.mjs adds _system to SKIP_FOLDERS.
- cli.mjs + state-sync-guard.mjs + .husky/pre-commit point at the
new path.
template-reset-v1 epic deleted entirely (one-off cleanup epic from
the pre-date-convention era; status was already done).
Generator-template updates (so new artifacts ship in the right
shape):
- .sandcastle/decomposer.prompt.md emits bare-slug folder names +
ISO created: timestamp.
- .claude/skills/to-prd/SKILL.md template uses bare-slug filename +
bare-slug id field + ISO created: timestamp.
Doc reference updates: glossary, runbook, agent-first-workflow-
and-conformance, reviewer prompt, ADR-020, ADR-022, ADR-023 all
point at the new paths/slugs.
2.1 KiB
2.1 KiB
id, epic, title, type, status, feature, depends-on, blocks, created, updated
| id | epic | title | type | status | feature | depends-on | blocks | created | updated | |
|---|---|---|---|---|---|---|---|---|---|---|
| 03-update-generator-templates | binder-wrap-helper | Update feature generator templates to emit wireUseCase call shape | technical-story | done | core-shared |
|
2026-05-13T19:17:10+02:00 | 2026-05-14T19:16:52.691Z |
Goal
Update turbo/generators/templates/feature/src/di/bind-production.ts.hbs and bind-dev-seed.ts.hbs so that pnpm turbo gen feature scaffolds new features with wireUseCase calls instead of the longhand inline withSpan + withCapture form.
Why
New features scaffolded after the migration would otherwise drift back to the inline form, re-introducing the clone group. The generator is the canonical source for scaffolded binder shape; updating it closes the loop.
Done when
turbo/generators/templates/feature/src/di/bind-production.ts.hbsemitswireUseCase(...)calls (not inlinewithSpan + withCapture) for the placeholder use case.turbo/generators/templates/feature/src/di/bind-dev-seed.ts.hbsemitswireUseCase(...)calls for the placeholder use case.- Running
pnpm turbo gen feature testfeatureproduces binder files that callwireUseCaseand passpnpm typecheck && pnpm lint && pnpm test && pnpm conformance && pnpm fallow:audit && pnpm coverage:diff(or the generated feature is cleaned up after verification).
In scope
turbo/generators/templates/feature/src/di/bind-production.ts.hbsturbo/generators/templates/feature/src/di/bind-dev-seed.ts.hbs- Any supporting type imports in the templates that change as a result (e.g. dropping
ProductionUseCaseintermediate type if the helper absorbs it).
Out of scope
- Generator templates for events, jobs, realtime, or core-packages — those do not produce binder files with use-case wrapping.
- Runtime behaviour changes — the generated output must be semantically equivalent to the old inline form.
Tasks
- Update
bind-production.ts.hbsandbind-dev-seed.ts.hbsinturbo/generators/templates/feature/src/di/to emitwireUseCasecalls; verify a test-scaffold of a new feature produces correct binder output and all gates pass on this commit.