build-stories

What problem does it solve?

This Skill breaks a plan and its supporting architecture into a sequence of self-contained, agent-sized story files so an orchestrator can reliably assign work without manual story authoring. It removes the friction of converting high-level specs into executable increments that fit an AI agent's context window and includes testing guidance and acceptance criteria so each increment is verifiable.

Core Features & Use Cases

• Plan decomposition: Reads the plan spec, plan-specific architecture, overall architecture, and roadmap, then decomposes them into ordered markdown stories.
• Agent assignment: Marks each story with the appropriate agent type (engineer or designer) and enforces the design→engineer pairing pattern where applicable.
• Deliverable guidance: Each story includes deliverables, implementation guidance, exact file paths, acceptance criteria, and testing guidance sized for a single AI session.
• Indexing and ordering: Produces a stories.md index with ordering, status, and a dependency graph to drive incremental execution.

Quick Start

Create ordered stories for plan-0-infrastructure by reading specs/plan-0-infrastructure.md, specs/plan-0-infrastructure/architecture.md, specs/architecture.md, and specs/roadmap.md and scanning the codebase for existing stories and artifacts.