claude-tweaks:specify

Design doc decomposition breaks brainstorming documents into self-contained, agent-sized specs. Each specification includes structured sections for Deliverables, Acceptance Criteria, Prerequisites, and Manual Steps to guide downstream build and validation.

Turning brainstorming notes into actionable work units involves mapping design ideas to executable specs. This process preserves context and decisions by absorbing assumptions and constraints directly into each generated specification ready for build execution.

Project specifications for automated workflows are structured using Deliverables, Acceptance Criteria, Prerequisites, and Manual Steps. This format ensures each spec is self-contained, enabling structured planning and execution within the build and test phases.

You need a markdown design document path, such as docs/plans/project-name-design.md, to generate project management specs. The skill reads the brainstorming document and outputs the resulting specifications directly under the specs directory.

Automated spec decomposition should not be used when a design document lacks sufficient detail for mapping to actionable work units. The process requires clear assumptions and constraints within the brainstorming notes to generate effective executable specifications.

Generated specifications include standard project management structures like Deliverables and Acceptance Criteria, making them usable independently. However, they are specifically formatted to be self-contained for seamless integration within the claude-tweaks build workflow.