Cs Feat Design

This skill helps you create a clear design document for a new feature. It guides you from an idea to a written plan. The plan includes what to change, how it should work, and what to check later. You start by saying something like "start design" or "write a design doc." Then the skill helps you build a design file and a checklist. These files are the only input for later implementation and testing. This makes sure everyone agrees on what to build.

The skill works in three ways. You can describe the feature directly and let it draft the full design. You can ask it to create an empty intent draft so you can fill it in later. Or you can start from a roadmap item. In that case it reads the roadmap context and checks that dependencies are done. It then writes the design and updates the roadmap status. The output is always a {slug}-design.md file and a {slug}-checklist.yaml file.

The design focuses on what changes at the data level and the control flow level. It does not include code details or test choices. The design is meant to be read in about five minutes. Each section is kept short. Terms are locked early to avoid confusion. Examples come before formal definitions. New logic goes in new files to keep responsibilities clear. The skill also includes a health check to decide if a file or directory needs cleanup before writing new code.