Danijel Martinek
756e36c720
The previous layout placed epic folders directly under docs/work/
alongside prds/ and _system/. Tightening: epics now live in their
own docs/work/epics/ subfolder, peer to prds/ and _system/. Same
shape as the existing prds/ bucket.
Final docs/work/ layout:
README.md
prds/<slug>.prd.md
_system/_state.json
epics/<slug>/_epic.md + <story-folder>/_story.md
Renames (git mv preserves history):
- docs/work/binder-wrap-helper/
-> docs/work/epics/binder-wrap-helper/
- docs/work/library-evaluation-policy/
-> docs/work/epics/library-evaluation-policy/
- docs/work/ci-security-and-supply-chain/
-> docs/work/epics/ci-security-and-supply-chain/
Tooling updates:
- state-builder.mjs walks workRoot/epics/ directly; SKIP_FOLDERS
obsoleted (no more sibling folders to filter out).
- dispatch.mjs's findNextTask, tickStoryBulletInEpic, and
flipEpicDoneIfAllStoriesDone all join with "epics" segment.
- prd-ship.mjs's deriveShippingCommits walks workRoot/epics/ and
git-logs docs/work/epics/<epic>/.
- decomposer.prompt.md emits epics under docs/work/epics/<epic-id>/.
- handoff + grill-with-docs glossary references updated.
- Glossary entry for Epic updated.
Reserved future shape: when a task-tracker integration (ClickUp,
Linear) ships, the epics/ subfolder hosts <task-id>-<slug>/
folders. Today it just hosts bare slugs.
249 lines
7.3 KiB
JSON
249 lines
7.3 KiB
JSON
{
|
|
"updated_at": "2026-05-14T19:21:52.736Z",
|
|
"epics": {
|
|
"binder-wrap-helper": {
|
|
"status": "done",
|
|
"title": "Collapse binder duplication via wireUseCase helper",
|
|
"prd": "docs/work/prds/binder-wrap-helper.prd.md",
|
|
"stories": {
|
|
"01-wire-use-case-helper": {
|
|
"status": "done",
|
|
"title": "Introduce wireUseCase helper in core-shared",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [],
|
|
"blocks": [
|
|
"02-migrate-feature-binders",
|
|
"03-update-generator-templates"
|
|
]
|
|
},
|
|
"02-migrate-feature-binders": {
|
|
"status": "done",
|
|
"title": "Migrate all five feature binders to wireUseCase",
|
|
"ac_total": 5,
|
|
"ac_completed": 5,
|
|
"depends_on": [
|
|
"01-wire-use-case-helper"
|
|
],
|
|
"blocks": []
|
|
},
|
|
"03-update-generator-templates": {
|
|
"status": "done",
|
|
"title": "Update feature generator templates to emit wireUseCase call shape",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [
|
|
"01-wire-use-case-helper"
|
|
],
|
|
"blocks": []
|
|
}
|
|
}
|
|
},
|
|
"ci-security-and-supply-chain": {
|
|
"status": "done",
|
|
"title": "CI security + supply-chain enforcement stack",
|
|
"prd": "docs/work/prds/ci-security-and-supply-chain.prd.md",
|
|
"stories": {
|
|
"01-trace-schema-extensions": {
|
|
"status": "done",
|
|
"title": "Trace schema extensions (socketRisk + lastRevalidated)",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [],
|
|
"blocks": []
|
|
},
|
|
"02-socket-integration": {
|
|
"status": "done",
|
|
"title": "Socket integration (skill + CI)",
|
|
"ac_total": 2,
|
|
"ac_completed": 2,
|
|
"depends_on": [
|
|
"01-trace-schema-extensions"
|
|
],
|
|
"blocks": [
|
|
"08-reviewer-prompt-update"
|
|
]
|
|
},
|
|
"03-renovate-adoption": {
|
|
"status": "done",
|
|
"title": "Renovate adoption",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [],
|
|
"blocks": [
|
|
"09-ci-security-guide-and-docs"
|
|
]
|
|
},
|
|
"04-major-bump-reevaluation": {
|
|
"status": "done",
|
|
"title": "Major-bump re-evaluation flow",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [
|
|
"01-trace-schema-extensions"
|
|
],
|
|
"blocks": [
|
|
"05-trace-revalidation-workflow"
|
|
]
|
|
},
|
|
"05-trace-revalidation-workflow": {
|
|
"status": "done",
|
|
"title": "Trace revalidation workflow",
|
|
"ac_total": 2,
|
|
"ac_completed": 2,
|
|
"depends_on": [
|
|
"01-trace-schema-extensions",
|
|
"04-major-bump-reevaluation"
|
|
],
|
|
"blocks": [
|
|
"09-ci-security-guide-and-docs"
|
|
]
|
|
},
|
|
"06-codeql-and-audit-signatures": {
|
|
"status": "done",
|
|
"title": "CodeQL workflow + pnpm audit signatures",
|
|
"ac_total": 2,
|
|
"ac_completed": 2,
|
|
"depends_on": [],
|
|
"blocks": [
|
|
"08-reviewer-prompt-update"
|
|
]
|
|
},
|
|
"07-gitleaks-precommit": {
|
|
"status": "done",
|
|
"title": "Gitleaks pre-commit hook",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [],
|
|
"blocks": [
|
|
"09-ci-security-guide-and-docs"
|
|
]
|
|
},
|
|
"08-reviewer-prompt-update": {
|
|
"status": "done",
|
|
"title": "Sandcastle reviewer prompt update",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [
|
|
"02-socket-integration",
|
|
"06-codeql-and-audit-signatures"
|
|
],
|
|
"blocks": [
|
|
"09-ci-security-guide-and-docs"
|
|
]
|
|
},
|
|
"09-ci-security-guide-and-docs": {
|
|
"status": "done",
|
|
"title": "CI security guide + CLAUDE.md",
|
|
"ac_total": 2,
|
|
"ac_completed": 2,
|
|
"depends_on": [],
|
|
"blocks": []
|
|
}
|
|
}
|
|
},
|
|
"library-evaluation-policy": {
|
|
"status": "done",
|
|
"title": "Library evaluation policy — skill, traces, enforcement stack",
|
|
"prd": "docs/work/prds/library-evaluation-policy.prd.md",
|
|
"stories": {
|
|
"01-trace-schema-foundation": {
|
|
"status": "done",
|
|
"title": "Trace schema module + docs/library-decisions/ foundation",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [],
|
|
"blocks": []
|
|
},
|
|
"02-pre-commit-check-script": {
|
|
"status": "done",
|
|
"title": "Pre-commit check script for library trace presence",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [
|
|
"01-trace-schema-foundation"
|
|
],
|
|
"blocks": [
|
|
"06-sandcastle-reviewer-prompt"
|
|
]
|
|
},
|
|
"03-claude-hooks": {
|
|
"status": "done",
|
|
"title": "Claude PreToolUse / PostToolUse hooks for library-policy nudge",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [],
|
|
"blocks": []
|
|
},
|
|
"04-evaluate-library-skill": {
|
|
"status": "done",
|
|
"title": "evaluate-library skill (SKILL.md + supporting files)",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [
|
|
"01-trace-schema-foundation"
|
|
],
|
|
"blocks": [
|
|
"05-human-guide"
|
|
]
|
|
},
|
|
"05-human-guide": {
|
|
"status": "done",
|
|
"title": "Human reading-room guide — docs/guides/adding-a-library.md",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [
|
|
"04-evaluate-library-skill"
|
|
],
|
|
"blocks": [
|
|
"09-claude-md-update"
|
|
]
|
|
},
|
|
"06-sandcastle-reviewer-prompt": {
|
|
"status": "done",
|
|
"title": "Sandcastle reviewer prompt — Library-trace check section",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [
|
|
"02-pre-commit-check-script"
|
|
],
|
|
"blocks": []
|
|
},
|
|
"07-generator-pre-shipped-traces": {
|
|
"status": "done",
|
|
"title": "Generator templates — pre-shipped traces for optional core packages",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [
|
|
"01-trace-schema-foundation"
|
|
],
|
|
"blocks": []
|
|
},
|
|
"08-backfill-traces": {
|
|
"status": "done",
|
|
"title": "Backfill library traces for existing feature- and core-tier runtime deps",
|
|
"ac_total": 4,
|
|
"ac_completed": 4,
|
|
"depends_on": [
|
|
"01-trace-schema-foundation"
|
|
],
|
|
"blocks": []
|
|
},
|
|
"09-claude-md-update": {
|
|
"status": "done",
|
|
"title": "CLAUDE.md Key Conventions — library policy bullet",
|
|
"ac_total": 1,
|
|
"ac_completed": 1,
|
|
"depends_on": [
|
|
"05-human-guide"
|
|
],
|
|
"blocks": []
|
|
}
|
|
}
|
|
}
|
|
},
|
|
"ready": [],
|
|
"blocked": [],
|
|
"needs_prd_ship": []
|
|
}
|