docs/data/project-kickstart-workflow/SKILL.md
Use when starting a new product or feature from scratch and need structured progression from idea to user stories. Guides through CIRCLES brief, EARS requirements, GO/PIVOT/KILL gate, personas, scenarios, conceptual model, and story mapping.
npx skillsauth add opcheese/context_forge_ts project-kickstartInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Take a raw idea through 8 structured steps to produce actionable user stories. Core principle: user-oriented thinking over feature lists, evidence over assumptions. Each step has explicit inputs, outputs, and a method — skip nothing.
Use for:
Do NOT use for:
| Step | Name | Method | Input | Output | |------|------|--------|-------|--------| | L0 | Brief | CIRCLES | Raw idea, transcript, notes | Problem statement + appetite | | L1 | IRD | EARS syntax | Brief | Testable requirements | | GATE | GO/PIVOT/KILL | Decision framework | Brief + IRD | Binary decision + rationale | | L2 | Personas | Proto-persona | IRD + Brief | 2-3 user archetypes | | L3 | Scenarios | Journey mapping | Personas + IRD | User journeys with touchpoints | | L3.5 | Mocks (opt) | Visual sketching | Scenarios + Personas | Key screen layouts | | L4 | Conceptual Model | Use-case driven | Scenarios + Personas + IRD | Domain glossary + relationships | | L5 | Stories | Story mapping | Model + Scenarios + Personas | Prioritized user stories |
Execute steps in order. Do not start a step until the previous step's output exists. The GATE is mandatory — it exists to prevent wasted effort on doomed projects.
This skill uses ContextForge's three-zone system:
Skipping the GATE. Investing in personas, scenarios, and stories for a project that should be killed. The GATE exists to save effort — use it honestly.
Gold-plating the Brief. The Brief is a working document, not a pitch deck. Get the problem statement and appetite down, then move on. You will refine understanding through later steps.
Writing stories before personas. Stories without user context are feature lists. Personas ground every story in a real user's goals and constraints.
Treating IRD as final. Requirements evolve as personas and scenarios reveal gaps. Return to the IRD and update it when new information surfaces — this is expected, not a failure.
Solution-first thinking. Starting with "we need a dashboard" before understanding what problem the dashboard solves. CIRCLES forces problem comprehension before solutions.
testing
A skill with references
testing
A simple test skill
tools
A skill with multiple workflow steps
development
Use when creating new Claude Code skills or improving existing ones. Covers TDD-based skill development workflow (RED/GREEN/REFACTOR), SKILL.md structure, frontmatter rules, CSO optimization, persuasion patterns, and token budgets. Import into ContextForge and save as template.