Files
typescript-decompiler/docs/reference/design-status-template.md
T
2026-05-25 05:47:28 +00:00

4.3 KiB

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>