spec-brainstorm

Solid

Conversational design workshop for substantial work. Interviews the human one question at a time, explores 2-3 approaches with trade-offs, and presents the design section by section for approval before writing only design.md, then stops. Combines requirements discovery with codebase research and architecture design. Use when the user explicitly requests a spec or when atelier-orchestrator selects a Spec-backed Plan. Ambiguous design or discovery requests route through atelier-orchestrator.

AI & Automation 46 stars 4 forks Updated 1 months ago MIT

Install

View on GitHub

Quality Score: 81/100

Stars 20%
56
Recency 20%
75
Frontmatter 20%
70
Documentation 15%
100
Issue Health 10%
50
License 10%
100
Description 5%
100

Skill Content

# Spec Brainstorm Conversational design workshop for substantial work that produces a focused, reviewed spec. One question at a time. Multiple approaches explored. Design approved in sections. Ruthless scope control. No implementation until design is approved. Run this skill only after `atelier-orchestrator` selects a Spec-backed Plan or the human explicitly requests a spec. Bounded work should go directly to `spec-plan` for an Inline Plan. Do not reclassify the planning mode here. ## Artifact ``` docs/specs/YYYY-MM-DD-<feature>/ └── design.md ← This skill's output ``` Requirements are inline — no separate requirements.json needed. ### Exclusive output contract This skill may create or update only the `design.md` shown above. It may inspect the repository and discuss drafts in conversation, but it must not modify any other file, create `plan.json`, create tracker entries, invoke another workflow skill, or write implementation code. This boundary still applies when the human asks to brainstorm, plan, and implement in one request. Finish `design.md`, report it, and stop. --- ## Lessons These principles apply to every spec, every time. ### Specs must earn their cost Persisted specs are for work whose discovery, architecture, dependencies, or coordination needs justify a durable artifact. Do not pull bounded work into this workflow merely because it touches multiple files or takes time. That work belongs in an Inline Plan. ### Design for isolation and clarity Brea...

Details

Author
martinffx
Repository
martinffx/atelier
Created
8 months ago
Last Updated
1 months ago
Language
TypeScript
License
MIT

Integrates with

Bundled in these plugins

Similar Skills

Semantically similar based on skill content — not just same category