← ClaudeAtlas

brainstorminglisted

Design before code: turns an idea into an approved design and implementation plan, asking in rounds only the judgment calls the codebase can't answer, then saves a dated design doc under docs/plans/. Use before building a non-trivial feature, component, or architectural change, or when the user describes a multi-step system to create ('I want to build', 'how should I design', 'brainstorm', 'tôi muốn làm', 'thiết kế', 'lên kế hoạch'). Not for a small self-contained change like one helper function.
viettdann/arclight-kit · ★ 0 · AI & Automation · score 62
Install: claude install-skill viettdann/arclight-kit
# Brainstorming Ideas Into Designs ## Overview Help turn ideas into fully formed designs and specs through natural collaborative dialogue. Start from a high-level description of what the user wants to build and the current project context, then ask questions to refine the idea until Understanding is done, then present the design. ## The Process ### Understanding the Idea - **Grasp the idea first.** Ask the user for a high-level description of what they want to build (1-2 sentences is enough to proceed) - **Targeted codebase discovery:** informed by the user's stated intent: - If the project is empty or the user explicitly states it's a greenfield/new project, skip codebase discovery entirely and note this assumption - Otherwise, search and read the local codebase - When the change touches one member of a family (one endpoint, one worker, one handler), list its siblings and which of them share the gap - Grep `docs/plans/` for designs that overlap the topic; when one does, name it and ask whether to build on it or start fresh - Summarize findings before proceeding: enough for the user to check your reading of the codebase, and no more - **Self-verify before asking.** Before formulating any question for the user, apply this gate: - **Answerable from the codebase?** (installed deps, patterns in use, available APIs) → Resolve it yourself and state it as a resolved constraint, not a question - **Answerable from an external dependency?** (see Research) → Resolve