Initial commit

2026-05-25 05:47:28 +00:00
commit 4d6495ffda
97 changed files with 13403 additions and 0 deletions
@@ -0,0 +1,117 @@
+# Design Status Template
+
+Use this file as `design/feature/<feature-slug>/status.md`.
+It tracks feature-level discovery/decomposition, workflow slices, and per-slice progress through the downstream pipeline.
+
+## Feature
+
+- Name: `<feature-name>`
+- Feature slug: `<feature-slug>`
+- Current phase: `Feature Discovery | Context & Workflow Decomposition | Slice Discovery | Core Sketch | Blueprint | Design Security Review | Assembly | Implementation Security Review | Refactor Diagnosis | Refactor Execution | Done`
+- Overall status: `In Progress | Blocked | Ready for Next Phase | Complete`
+- Security verification status: `Not Started | Design Review Needed | Design Review Complete | Implementation Review Needed | Implementation Review Complete`
+- Current workflow slice: `<bounded-context-slug>/<workflow-slug> | none`
+
+## Feature Artifacts
+
+- [ ] `design/feature/<feature-slug>/discovery.md`
+- [ ] `design/feature/<feature-slug>/design.md`
+- [ ] `design/feature/<feature-slug>/status.md`
+
+## Feature Discovery Gate
+
+- [ ] feature goal and actor intents captured
+- [ ] commands and events identified at feature level
+- [ ] business rules and invariants captured at feature level
+- [ ] edge cases captured at feature level
+- [ ] candidate bounded contexts identified
+- [ ] candidate workflow inventory identified
+- [ ] project-wide shared-language updates captured
+- [ ] approved for context and workflow decomposition
+
+## Context & Workflow Decomposition Gate
+
+- [ ] bounded contexts confirmed
+- [ ] feature steps mapped to workflow slices
+- [ ] cross-context handoffs recorded
+- [ ] per-context shared-language files created or updated
+- [ ] workflow folders created with `01-decomposition.md`
+- [ ] recommended slice order recorded
+- [ ] approved to begin slice discovery
+
+## Workflow Slice Tracker
+
+| Bounded Context  | Workflow Slice    | Slice Discovery | Core Sketch   | Blueprint     | Design Security | Assembly      | Impl Security | Refactor      | Notes    |
+| :--------------- | :---------------- | :-------------- | :------------ | :------------ | :-------------- | :------------ | :------------ | :------------ | :------- |
+| `<context-slug>` | `<workflow-slug>` | `Not Started`   | `Not Started` | `Not Started` | `Not Started`   | `Not Started` | `Not Started` | `Not Started` | `<note>` |
+| `<context-slug>` | `<workflow-slug>` | `Not Started`   | `Not Started` | `Not Started` | `Not Started`   | `Not Started` | `Not Started` | `Not Started` | `<note>` |
+
+## Current Slice Gates
+
+### Slice Discovery Gate
+
+- [ ] selected slice named explicitly
+- [ ] happy path captured
+- [ ] edge cases captured
+- [ ] business rules and invariants captured
+- [ ] handoff assumptions captured
+- [ ] context shared-language updates captured
+- [ ] approved for core sketch
+
+### Core Sketch Gate
+
+- [ ] required state is explicit
+- [ ] command and events are explicit
+- [ ] policy signature is explicit
+- [ ] slice boundaries are explicit
+- [ ] no cross-context decision logic inside the slice
+- [ ] approved for blueprint
+
+### Blueprint Gate
+
+- [ ] domain types make illegal states harder to express
+- [ ] shared concepts reused appropriately
+- [ ] policy is pure
+- [ ] reducer/apply shape is explicit
+- [ ] workflow contract is explicit
+- [ ] approved for design security review or assembly
+
+### Design Security Gate
+
+- [ ] trust boundaries reviewed
+- [ ] authority and least privilege reviewed
+- [ ] sink and data-flow risks reviewed
+- [ ] blocking findings resolved or explicitly accepted
+- [ ] approved for assembly
+
+### Assembly Gate
+
+- [ ] tests added
+- [ ] implementation completed
+- [ ] types pass
+- [ ] tests passing
+- [ ] effect AST checks run for modified Effect files
+- [ ] approved for implementation security review or next slice
+
+### Implementation Security Gate
+
+- [ ] implementation security review completed or explicitly deferred
+- [ ] blocking findings resolved or explicitly accepted
+- [ ] approved for refactor consideration or next slice
+
+### Refactor Gate
+
+- [ ] diagnosis completed if structural changes were needed
+- [ ] execution completed if approved
+- [ ] verification rerun after refactor
+- [ ] slice complete
+
+## Open Questions / Blockers
+
+- `<question or blocker>`
+
+## Context Handoff Notes
+
+- Read first: `<artifact paths>`
+- Current focus: `<next slice or current gate>`
+- Do not change: `<frozen decisions or constraints>`