$brainstorm — Clarify Goals Before Planning Purpose: Separate WHAT from HOW. Explore the problem space before committing to a solution. Two modes runs in one of two modes (complementary, not exclusive): | Mode | Use when | Shape | |------|----------|-------| | Goal-clarification (default; the four phases below) | The goal names ONE specific capability ( , ) | Sharpen the WHAT, explore the HOW for that single goal. | | Ideation (open-ended; see below) | The goal is open-ended ( , ) OR Phase 1 returns with no single goal OR is passed | Generate MANY candidate improvements, winnow ruthlessly, op…

\"\n\necho \"\"; echo \"Results: $PASS passed, $FAIL failed\"\n[ $FAIL -eq 0 ] && exit 0 || exit 1\n","content_type":"application/x-sh; charset=utf-8","language":"bash","size":450,"content_sha256":"88a23f5b7ebdfca4375b15a1c397e249ba555833962bb148307b8d6fabc9ca72"}],"content_json":{"type":"doc","content":[{"type":"heading","attrs":{"level":1},"content":[{"text":"$brainstorm — Clarify Goals Before Planning","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Purpose:","type":"text","marks":[{"type":"strong"}]},{"text":" Separate WHAT from HOW. Explore the problem space before committing to a solution.","type":"text"}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Two modes","type":"text"}]},{"type":"paragraph","content":[{"text":"$brainstorm","type":"text","marks":[{"type":"code_inline"}]},{"text":" runs in one of two modes (complementary, not exclusive):","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Mode","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Use when","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Shape","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Goal-clarification","type":"text","marks":[{"type":"strong"}]},{"text":" (default; the four phases below)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"The goal names ONE specific capability (","type":"text"},{"text":"\"add JWT auth\"","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"\"fix the login bug\"","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Sharpen the WHAT, explore the HOW for that single goal.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Ideation","type":"text","marks":[{"type":"strong"}]},{"text":" (open-ended; see below)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"The goal is open-ended (","type":"text"},{"text":"\"improve the project\"","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"\"what should we build next\"","type":"text","marks":[{"type":"code_inline"}]},{"text":") OR Phase 1 returns ","type":"text"},{"text":"exploring","type":"text","marks":[{"type":"code_inline"}]},{"text":" with no single goal OR ","type":"text"},{"text":"--ideate","type":"text","marks":[{"type":"code_inline"}]},{"text":" is passed","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Generate MANY candidate improvements, winnow ruthlessly, operationalize the survivors.","type":"text"}]}]}]}]},{"type":"paragraph","content":[{"text":"Four phases (goal-clarification mode):","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Assess clarity","type":"text","marks":[{"type":"strong"}]},{"text":" — Is the goal specific enough?","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Understand idea","type":"text","marks":[{"type":"strong"}]},{"text":" — What problem, who benefits, what exists?","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Explore approaches","type":"text","marks":[{"type":"strong"}]},{"text":" — Generate options, compare tradeoffs","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Capture design","type":"text","marks":[{"type":"strong"}]},{"text":" — Write structured output for ","type":"text"},{"text":"$plan","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Quick Start","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"$brainstorm \"add user authentication\" # full 4-phase process\n$brainstorm # prompts for goal","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Codex Lifecycle Guard","type":"text"}]},{"type":"paragraph","content":[{"text":"When this skill runs in Codex hookless mode (","type":"text"},{"text":"CODEX_THREAD_ID","type":"text","marks":[{"type":"code_inline"}]},{"text":" is set or ","type":"text"},{"text":"CODEX_INTERNAL_ORIGINATOR_OVERRIDE","type":"text","marks":[{"type":"code_inline"}]},{"text":" is ","type":"text"},{"text":"Codex Desktop","type":"text","marks":[{"type":"code_inline"}]},{"text":"), ensure startup context before ideation:","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"ao codex ensure-start 2>/dev/null || true","type":"text"}]},{"type":"paragraph","content":[{"text":"ao codex ensure-start","type":"text","marks":[{"type":"code_inline"}]},{"text":" is the single startup guard for Codex skills. It records startup once per thread and skips duplicate startup automatically. Leave ","type":"text"},{"text":"ao codex ensure-stop","type":"text","marks":[{"type":"code_inline"}]},{"text":" to closeout skills; ","type":"text"},{"text":"$brainstorm","type":"text","marks":[{"type":"code_inline"}]},{"text":" is a start-path skill.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Execution Steps","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 1: Assess Clarity","type":"text"}]},{"type":"paragraph","content":[{"text":"If the user provided a goal string, evaluate it. Otherwise prompt for one.","type":"text"}]},{"type":"paragraph","content":[{"text":"Ask the user with options to gauge clarity:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"clear","type":"text","marks":[{"type":"strong"}]},{"text":" — Goal is specific and actionable (e.g., \"add JWT auth to the API\")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"vague","type":"text","marks":[{"type":"strong"}]},{"text":" — Goal exists but needs narrowing (e.g., \"improve security\")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"exploring","type":"text","marks":[{"type":"strong"}]},{"text":" — No firm goal yet, just a direction (e.g., \"something with auth\")","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"If ","type":"text"},{"text":"vague","type":"text","marks":[{"type":"strong"}]},{"text":" or ","type":"text"},{"text":"exploring","type":"text","marks":[{"type":"strong"}]},{"text":", ask follow-up questions to sharpen the goal before proceeding. Do NOT move to Phase 2 until you have a concrete problem statement (one sentence, testable).","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 2: Understand the Idea","type":"text"}]},{"type":"paragraph","content":[{"text":"Answer these questions (use codebase exploration as needed):","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What problem does this solve?","type":"text","marks":[{"type":"strong"}]},{"text":" — State the pain point in concrete terms.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Who benefits?","type":"text","marks":[{"type":"strong"}]},{"text":" — End users, developers, operators, CI pipeline?","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What exists today?","type":"text","marks":[{"type":"strong"}]},{"text":" — Current state, prior art in the codebase, adjacent systems.","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What constraints matter?","type":"text","marks":[{"type":"strong"}]},{"text":" — Performance, compatibility, security, timeline.","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Summarize findings before moving on. If anything is unclear, ask the user.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 3: Explore Approaches","type":"text"}]},{"type":"paragraph","content":[{"text":"Generate ","type":"text"},{"text":"2-3 distinct approaches","type":"text","marks":[{"type":"strong"}]},{"text":". For each:","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Name","type":"text","marks":[{"type":"strong"}]},{"text":" — Short label (e.g., \"JWT middleware\", \"OAuth proxy\", \"Session cookies\")","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"How it works","type":"text","marks":[{"type":"strong"}]},{"text":" — 2-3 sentences","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Pros","type":"text","marks":[{"type":"strong"}]},{"text":" — What it gets right","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Cons","type":"text","marks":[{"type":"strong"}]},{"text":" — What it gets wrong or defers","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Effort","type":"text","marks":[{"type":"strong"}]},{"text":" — Rough scope (small / medium / large)","type":"text"}]}]}]},{"type":"heading","attrs":{"level":4},"content":[{"text":"Phase 3b: Adversarial Critique","type":"text"}]},{"type":"paragraph","content":[{"text":"Before asking the user to choose, stress-test each approach:","type":"text"}]},{"type":"paragraph","content":[{"text":"For each approach, answer these ","type":"text"},{"text":"red team questions","type":"text","marks":[{"type":"strong"}]},{"text":" (read ","type":"text"},{"text":"references/red-team-checklist.md","type":"text","marks":[{"type":"code_inline"}]},{"text":"):","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What breaks first?","type":"text","marks":[{"type":"strong"}]},{"text":" — Under load, edge cases, or adversarial input","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What's the hidden cost?","type":"text","marks":[{"type":"strong"}]},{"text":" — Maintenance burden, technical debt, learning curve","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"What assumption is wrong?","type":"text","marks":[{"type":"strong"}]},{"text":" — The unstated belief that makes this approach seem good","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"Who disagrees?","type":"text","marks":[{"type":"strong"}]},{"text":" — What would a senior engineer with the opposite preference say?","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Mark any approach that fails 2+ red team questions as ","type":"text"},{"text":"HIGH RISK","type":"text","marks":[{"type":"strong"}]},{"text":" in the comparison.","type":"text"}]},{"type":"paragraph","content":[{"text":"If all approaches fail 2+ questions, generate a 4th \"hybrid\" approach addressing the weaknesses.","type":"text"}]},{"type":"paragraph","content":[{"text":"Present the comparison and ask the user to pick an approach or request a hybrid.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Phase 4: Capture Design","type":"text"}]},{"type":"paragraph","content":[{"text":"Generate a date slug: ","type":"text"},{"text":"YYYY-MM-DD-\u003cgoal-slug>","type":"text","marks":[{"type":"code_inline"}]},{"text":" (lowercase, hyphens, no spaces).","type":"text"}]},{"type":"paragraph","content":[{"text":"Write the output file to ","type":"text"},{"text":".agents/brainstorm/YYYY-MM-DD-\u003cslug>.md","type":"text","marks":[{"type":"code_inline"}]},{"text":":","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"markdown"},"content":[{"text":"---\nid: brainstorm-YYYY-MM-DD-\u003cgoal-slug>\ntype: brainstorm\ndate: YYYY-MM-DD\n---\n# Brainstorm: \u003cGoal>\n## Problem Statement\n## Approaches Considered\n## Selected Approach\n## Open Questions\n## Next Step: $plan","type":"text"}]},{"type":"paragraph","content":[{"text":"All five sections must be populated. The \"Next Step\" section should contain a concrete ","type":"text"},{"text":"$plan","type":"text","marks":[{"type":"code_inline"}]},{"text":" invocation suggestion with the selected approach as context.","type":"text"}]},{"type":"paragraph","content":[{"text":"Create the ","type":"text"},{"text":".agents/brainstorm/","type":"text","marks":[{"type":"code_inline"}]},{"text":" directory if it does not exist.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Ideation Mode (open-ended generate-winnow)","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Additive to the four-phase flow above — it does not replace it.","type":"text","marks":[{"type":"strong"}]},{"text":" Ideation mode is for \"improve the project\"-style goals where the WHAT is unknown and you must generate a portfolio and select, rather than clarify ONE known goal.","type":"text"}]}]},{"type":"paragraph","content":[{"text":"Trigger:","type":"text","marks":[{"type":"strong"}]},{"text":" the ","type":"text"},{"text":"exploring","type":"text","marks":[{"type":"code_inline"}]},{"text":" clarity path (Phase 1) when no single goal emerges, OR an explicit ","type":"text"},{"text":"--ideate","type":"text","marks":[{"type":"code_inline"}]},{"text":" flag, OR an open-ended goal string.","type":"text"}]},{"type":"paragraph","content":[{"text":"The methodology is ","type":"text"},{"text":"generate → winnow → expand → operationalize → refine","type":"text","marks":[{"type":"strong"}]},{"text":". Steps 1-3 belong to ","type":"text"},{"text":"$brainstorm","type":"text","marks":[{"type":"code_inline"}]},{"text":"; steps 4-5 are handed to ","type":"text"},{"text":"$discovery","type":"text","marks":[{"type":"code_inline"}]},{"text":" on its open-ended path.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 1 — Ground in reality","type":"text"}]},{"type":"code_block","attrs":{"wrap":false,"language":"bash"},"content":[{"text":"cat AGENTS.md # or CLAUDE.md — rules, constraints, non-goals\nbd list --json # open work — don't duplicate\nbd list --status closed --json # closed work — don't re-propose cut ideas\nbd ready --json # what is actionable now","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 2 — Generate 30, winnow to 5 (ranked, with rationale)","type":"text"}]},{"type":"paragraph","content":[{"text":"Generate ","type":"text"},{"text":"30","type":"text","marks":[{"type":"strong"}]},{"text":" candidate improvements (criteria = the rubric dimensions: robust, reliable, performant, intuitive, user-friendly, ergonomic, useful, compelling, while staying obviously ","type":"text"},{"text":"accretive","type":"text","marks":[{"type":"strong"}]},{"text":" and ","type":"text"},{"text":"pragmatic","type":"text","marks":[{"type":"strong"}]},{"text":"). Think each one through: ","type":"text"},{"text":"how it works","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"how users perceive it","type":"text","marks":[{"type":"strong"}]},{"text":", ","type":"text"},{"text":"how we implement it","type":"text","marks":[{"type":"strong"}]},{"text":". Then ","type":"text"},{"text":"winnow ruthlessly to the VERY best 5","type":"text","marks":[{"type":"strong"}]},{"text":", presented ","type":"text"},{"text":"ranked best-to-worst","type":"text","marks":[{"type":"strong"}]},{"text":" with full rationale and rubric scores. Stress-test survivors with the red team questions (Phase 3b). Do NOT stop at the first 5 — generate the full 30 first.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Step 3 — Expand with the next 10 (→ 15)","type":"text"}]},{"type":"paragraph","content":[{"text":"Generate the ","type":"text"},{"text":"next best 10","type":"text","marks":[{"type":"strong"}]},{"text":" (each with rationale) for a ranked portfolio of ","type":"text"},{"text":"15","type":"text","marks":[{"type":"strong"}]},{"text":" — #6-15 are often complementary to the top 5.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Steps 4-5 — Operationalize + refine (handed to ","type":"text"},{"text":"$discovery","type":"text","marks":[{"type":"code_inline"}]},{"text":")","type":"text"}]},{"type":"paragraph","content":[{"text":"Carry the ranked 15 (with how/perceive/implement notes + rubric scores + red-team findings) forward. ","type":"text"},{"text":"$discovery","type":"text","marks":[{"type":"code_inline"}]},{"text":" operationalizes them into self-documenting ","type":"text"},{"text":"bd","type":"text","marks":[{"type":"code_inline"}]},{"text":" beads (deps + explicit test tasks) and refines 4-5x in plan space.","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"Output","type":"text"}]},{"type":"paragraph","content":[{"text":"Standalone (","type":"text"},{"text":"$brainstorm --ideate","type":"text","marks":[{"type":"code_inline"}]},{"text":"): write the ranked portfolio to ","type":"text"},{"text":".agents/brainstorm/YYYY-MM-DD-\u003cslug>-ideation.md","type":"text","marks":[{"type":"code_inline"}]},{"text":". Invoked by ","type":"text"},{"text":"$discovery","type":"text","marks":[{"type":"code_inline"}]},{"text":": return the ranked portfolio inline for the operationalize step.","type":"text"}]},{"type":"blockquote","content":[{"type":"paragraph","content":[{"text":"Tracking is ","type":"text","marks":[{"type":"strong"}]},{"text":"bd","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":", never ","type":"text","marks":[{"type":"strong"}]},{"text":"br","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":"/","type":"text","marks":[{"type":"strong"}]},{"text":"bv","type":"text","marks":[{"type":"code_inline"},{"type":"strong"}]},{"text":" — this is AgentOps.","type":"text"}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Termination","type":"text"}]},{"type":"paragraph","content":[{"text":"Phase 4 output written = done. No further phases, no loops.","type":"text"}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Validation","type":"text"}]},{"type":"paragraph","content":[{"text":"After writing the output file, verify:","type":"text"}]},{"type":"ordered_list","attrs":{"order":1,"listStyle":"number"},"content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"File exists at the expected path","type":"text"}]}]},{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"All 5 sections (","type":"text"},{"text":"Problem Statement","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Approaches Considered","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Selected Approach","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Open Questions","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Next Step: $plan","type":"text","marks":[{"type":"code_inline"}]},{"text":") are present and non-empty","type":"text"}]}]}]},{"type":"paragraph","content":[{"text":"Report the file path to the user.","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Examples","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 1: Specific goal","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"User: $brainstorm \"add rate limiting to the API\"\n\nPhase 1: Goal is clear — add rate limiting to the API.\nPhase 2: Problem is uncontrolled request volume causing timeouts.\n Benefits operators and end users. No rate limiting exists today.\nPhase 3: Three approaches — token bucket middleware, API gateway,\n per-route decorators. User picks token bucket.\nPhase 4: Writes .agents/brainstorm/2026-02-17-rate-limiting.md","type":"text"}]},{"type":"paragraph","content":[{"text":"Example 2: Vague goal","type":"text","marks":[{"type":"strong"}]}]},{"type":"code_block","attrs":{"wrap":false,"language":""},"content":[{"text":"User: $brainstorm \"improve performance\"\n\nPhase 1: Goal is vague. Asks: \"Which part? API response times,\n build speed, database queries, or something else?\"\n User says: \"API response times on the search endpoint.\"\nPhase 2: Investigates search endpoint, finds N+1 queries.\nPhase 3: Approaches — query optimization, caching layer, pagination.\nPhase 4: Writes .agents/brainstorm/2026-02-17-search-performance.md","type":"text"}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"Troubleshooting","type":"text"}]},{"type":"table","attrs":{"layout":null},"content":[{"type":"tr","content":[{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Problem","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Cause","type":"text"}]}]},{"type":"th","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Solution","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Brainstorm loops in Phase 1 without advancing","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Goal remains too vague after follow-up questions","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Provide a concrete, testable problem statement (e.g., \"reduce API search latency below 200ms\" instead of \"improve performance\").","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Output file missing one or more required sections","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Phase 4 was interrupted or the skill terminated early","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Re-run ","type":"text"},{"text":"$brainstorm","type":"text","marks":[{"type":"code_inline"}]},{"text":" with the same goal; verify all 5 sections (","type":"text"},{"text":"Problem Statement","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Approaches Considered","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Selected Approach","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Open Questions","type":"text","marks":[{"type":"code_inline"}]},{"text":", ","type":"text"},{"text":"Next Step: $plan","type":"text","marks":[{"type":"code_inline"}]},{"text":") are present in the output.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":".agents/brainstorm/","type":"text","marks":[{"type":"code_inline"}]},{"text":" directory not created","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"The skill could not create the directory (permissions or path issue)","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Manually create it with ","type":"text"},{"text":"mkdir -p .agents/brainstorm","type":"text","marks":[{"type":"code_inline"}]},{"text":" and re-run.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"$plan","type":"text","marks":[{"type":"code_inline"}]},{"text":" invocation in \"Next Step\" section is generic or incomplete","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"The selected approach was not specific enough to generate a concrete plan command","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Edit the output file to refine the selected approach, then craft a ","type":"text"},{"text":"$plan","type":"text","marks":[{"type":"code_inline"}]},{"text":" invocation that includes the approach name and key constraints.","type":"text"}]}]}]},{"type":"tr","content":[{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Brainstorm produces only one approach in Phase 3","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"The problem space is narrow or the goal is overly constrained","type":"text"}]}]},{"type":"td","attrs":{"colspan":1,"rowspan":1,"colwidth":null,"alignment":""},"content":[{"type":"paragraph","content":[{"text":"Widen the goal slightly or explicitly ask for alternative approaches (e.g., \"consider a caching approach and a query optimization approach\").","type":"text"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}},{"type":"heading","attrs":{"level":2},"content":[{"text":"See Also","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"../plan/SKILL.md","type":"text","marks":[{"type":"link","attrs":{"href":"../plan/SKILL.md","title":null}}]},{"text":" — Decompose the selected approach into actionable issues","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Reference Documents","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"references/red-team-checklist.md","type":"text","marks":[{"type":"link","attrs":{"href":"references/red-team-checklist.md","title":null}}]},{"text":" — Adversarial critique template for Phase 3b","type":"text"}]}]}]},{"type":"heading","attrs":{"level":2},"content":[{"text":"Local Resources","type":"text"}]},{"type":"heading","attrs":{"level":3},"content":[{"text":"scripts/","type":"text"}]},{"type":"bullet_list","content":[{"type":"list_item","content":[{"type":"paragraph","content":[{"text":"scripts/validate.sh","type":"text","marks":[{"type":"code_inline"}]}]}]}]},{"type":"hr","attrs":{"markup":"---"}}]},"metadata":{"date":"2026-06-05","name":"brainstorm","author":"@skillopedia","source":{"stars":375,"repo_name":"agentops","origin_url":"https://github.com/boshu2/agentops/blob/HEAD/skills-codex/brainstorm/SKILL.md","repo_owner":"boshu2","body_sha256":"13717cfdce2616e673cd0556e1c609c3938203dea9110b7cf949ac70813cfba1","cluster_key":"2c952625cf36048decb5d356255059d76d4e8d6d5c09588bc2ff1a62a6cb5381","clean_bundle":{"format":"clean-skill-bundle-v1","source":"boshu2/agentops/skills-codex/brainstorm/SKILL.md","attachments":[{"id":"bcb2624f-dd67-5c0d-bc77-abd6077775ff","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/bcb2624f-dd67-5c0d-bc77-abd6077775ff/attachment.json","path":".agentops-generated.json","size":274,"sha256":"80836f409b44b9853e085947bad4c7cfb8d521da16261848b70c308117b58eb5","contentType":"application/json; charset=utf-8"},{"id":"ec9477e0-217d-5fb3-b47a-7bd63e5161cc","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/ec9477e0-217d-5fb3-b47a-7bd63e5161cc/attachment.md","path":"prompt.md","size":952,"sha256":"6dbff41aa3ad8dc1e236a18ec5f57bf6b8473bc54977b33f974db2acc22e007d","contentType":"text/markdown; charset=utf-8"},{"id":"da31774f-65a2-5fd3-bb4e-f7b30324de45","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/da31774f-65a2-5fd3-bb4e-f7b30324de45/attachment.md","path":"references/red-team-checklist.md","size":2263,"sha256":"9c0b5499af112c9cd3b4234c2981c02df555b6ff2a933e5d15fcdd1b23375489","contentType":"text/markdown; charset=utf-8"},{"id":"8ff22647-007c-567a-b626-da89bbc0048a","key":"uploads/10433ee7-ad12-4ae0-b34e-97553e46c6c8/8ff22647-007c-567a-b626-da89bbc0048a/attachment.sh","path":"scripts/validate.sh","size":450,"sha256":"88a23f5b7ebdfca4375b15a1c397e249ba555833962bb148307b8d6fabc9ca72","contentType":"application/x-sh; charset=utf-8"}],"bundle_sha256":"4cebef71216197ae106aeb7d7679cc102e2b2c505f05d9cadf8c96cc2930ebb9","attachment_count":4,"text_attachments":4,"attachment_storage":"skillopedia-attachments-v1","binary_attachments":0,"excluded_attachments":[]},"cluster_size":1,"skill_md_path":"skills-codex/brainstorm/SKILL.md","import_metadata":{"date":"2026-06-05","author":"@skillopedia","version":"v1","category":"software-engineering","category_label":"Engineering"},"exact_dupes_collapsed_into_this":0},"version":"v1","category":"software-engineering","import_tag":"clean-skills-v1","description":"Separate goals from implementation."}},"renderedAt":1782981119293}

$brainstorm — Clarify Goals Before Planning Purpose: Separate WHAT from HOW. Explore the problem space before committing to a solution. Two modes runs in one of two modes (complementary, not exclusive): | Mode | Use when | Shape | |------|----------|-------| | Goal-clarification (default; the four phases below) | The goal names ONE specific capability ( , ) | Sharpen the WHAT, explore the HOW for that single goal. | | Ideation (open-ended; see below) | The goal is open-ended ( , ) OR Phase 1 returns with no single goal OR is passed | Generate MANY candidate improvements, winnow ruthlessly, op…