task-from-spec

Generate tasks from a spec document by parsing an approved spec.md and metadata.json file to produce a complete, scored, and dependency-validated task state. The process outputs state.json, TODOs.md, and an updated index for project tracking.

Spec-to-task workflow automation translates approved specifications and acceptance criteria into granular, executable tasks. It coordinates task atomization, complexity scoring, and dependency graphing to organize phases for setup, core, integration, testing, and documentation.

Break down complex user stories by applying multi-pass decomposition that enforces complexity limits. This process atomizes user stories and acceptance criteria into ultra-granular tasks with clear ownership, test requirements, and phase-aligned grouping.

Create a dependency graph from acceptance criteria by extracting requirements from the spec metadata and mapping relationships between tasks. The generated state.json captures these dependencies for phase-organized execution.

Start project planning from a spec requires an approved spec.md document and a metadata.json file. These inputs provide the user stories and acceptance criteria needed to generate the complete task state.

Generated project tasks exceed complexity limits when initial decomposition fails to break down large tasks. The system applies multi-pass decomposition to enforce complexity limits, ensuring each task remains granular and executable.