Home
cd ../playbooks
Developer ToolsIntermediate

Idea-to-Design Brainstorming Gate

A hard approval gate before any implementation — classify every request as a Spike, Bounded change, or Architectural project, then design collaboratively and never write code until the design is explicitly approved.

5 minutes
By obra (superpowers)Source
#brainstorming#design-process#approval-gate#scope-classification#spec-writing#claude-code-basics

You asked for 'a quick fix' and three hours later there's a half-finished refactor touching six files you never approved — because 'simple' got treated as 'skip the design step' instead of 'keep the design short.'

Who it's for: developers who want Claude to stop implementing before checking in, teams tired of scope creep starting from an innocent-sounding request, tech leads wanting a consistent process for classifying work by size, anyone who's had an AI agent run ahead of what they actually approved, engineering managers standardizing how much process different sizes of work actually need

Example

"Add a dark mode toggle" → Classified out loud as Bounded (the theming flow already exists to read), a few clarifying questions about persistence and default state, a short design presented in chat, and an explicit stop-and-wait for approval before a single line of code is written — versus a request to "build a plugin system" correctly escalating to the full Architectural path with a written spec

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

# Idea-to-Design Brainstorming Gate

## Your Role

You turn ideas into fully-formed designs through collaborative dialogue — and you never start implementing before that design is explicitly approved. The ceremony scales with the size of the task; the approval gate never does.

**Hard gate, no exceptions:** do not write code, scaffold a project, or take any implementation action until you've told me what you intend to do and I've approved it. This applies to every task, however small it looks.

---

## Step 1: Classify Before Anything Else

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

A discipline for the moment right before implementation starts: classify the request's actual size (Spike, Bounded, or Architectural), scale the process to match, and never let implementation begin without an explicit approval — no matter how small the task looks. The classification is said out loud so you can correct it, and hidden complexity discovered mid-task always upgrades the classification, never the other way around.


Quick Start

Step 1: Create a Project Folder

mkdir brainstorming-gate && cd brainstorming-gate

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ./

Step 3: Start a Request

claude

Then describe what you want built — the classification and approval gate happen automatically before any code gets written.


The Three Paths

Path When Process
Spike A feasibility question — "can we...", "is it possible..." 2-3 sentence probe, a nod, cheap investigation, report a recommendation. No design doc.
Bounded A well-scoped change to something that already exists Clarifying questions, a short in-chat design, explicit approval, then implementation. No spec file.
Architectural New projects, new subsystems, interface changes others depend on Full process: questions, 2-3 approaches, sectioned design, written spec, self-review, your review, then implementation planning.

When in doubt, take the heavier path. The classification only ever escalates mid-task — it never downgrades.

Tips & Best Practices

  • "Simple" means a short design, not no design. Even a two-sentence design in chat needs an explicit approval before implementation — the artifact scales with simplicity, the approval step never does.
  • Bounded measures whether the flow already exists, not your familiarity with the category. Understanding "this kind of app" isn't enough to call something bounded — if there's no existing flow to modify, it's architectural, however routine it feels.
  • A spike's output is an answer, not code to keep. If the spike's throwaway code turns out to be worth keeping, that's a new request — reclassify it rather than quietly promoting it.
  • Decompose before you brainstorm, not during. If a request actually describes several independent subsystems, flag that immediately rather than spending questions refining details of something that needs splitting first.
  • Self-review a written spec before showing it to the requester — scan for placeholders, contradictions, and ambiguity, and fix them inline rather than making the reviewer catch them.

Limitations

  • This is a process discipline, not a design methodology — it structures when to design and when to stop and ask, not how to architect a specific system
  • The full Architectural path assumes a project convention for where specs get saved; adapt the file path to match your team's actual practice
  • Best suited for genuinely collaborative work where pausing for approval is wanted — a fully autonomous batch pipeline with no human in the loop needs a different pattern

$Related Playbooks

Developer Tools

Hookify Guardrails

Create custom Claude Code guardrails with lightweight markdown rule files instead of hand-editing hooks.json — pattern matching, no restart required, rules live-load on the next tool call.

5 minutes
Beginner
Developer Tools

GPT Taste Skill: Strict Anti-Slop UI Rules

A stricter, more deterministic anti-slop frontend ruleset with GSAP motion patterns, despite the GPT-oriented name it works as a standard CLAUDE.md in Claude Code

5 minutes
Intermediate
Developer Tools

GitHub Contributor

A phase-based playbook for shipping pull requests maintainers actually merge — discovery, CONTRIBUTING compliance, PR-size checks, minimal diffs, and post-submission interaction.

20 minutes
Intermediate
Developer Tools

GitHub Operations

Comprehensive GitHub operations using the gh CLI and REST/GraphQL APIs — PRs, issues, repositories, workflows, and bulk operations across public and Enterprise GitHub.

10 minutes
Intermediate
Developer Tools

i18n Expert

Set up, audit, and enforce internationalization in UI codebases — install the i18n framework, replace hard-coded strings, ensure locale coverage, and validate key parity and pluralization.

20 minutes
Intermediate
Developer Tools

Frontend UX Pattern Library

Concrete, research-backed patterns for SaaS dashboards, landing pages, and forms — plus accessibility requirements, Tailwind implementation gotchas, and a pre-delivery checklist that treats accessibility as a launch blocker, not a nice-to-have.

5 minutes
Intermediate
Developer Tools

Git Commit & PR Automation

Three streamlined git workflows: commit with an auto-drafted message matching your repo's style, ship a full commit-push-PR in one step, and clean up branches deleted on the remote.

5 minutes
Beginner
Developer Tools

AI Crawler Access Audit: Who Can Actually Read Your Site

Maps 14 AI crawlers against your robots.txt, meta tags, and HTTP headers, then returns an access score and the exact rules to change

10 minutes
Intermediate
Developer Tools

llms.txt Generator & Auditor

Generate and validate llms.txt, the root-level Markdown file that tells AI systems what your site is and which pages to cite

10 minutes
Intermediate
Developer Tools

GEO Schema: Structured Data for AI Citation

Audit and generate schema.org JSON-LD built for AI comprehension, with a sameAs entity graph, knowsAbout topics, and a 0-100 scoring rubric

10 minutes
Intermediate
Developer Tools

GEO Technical SEO Audit: 8 Categories, 100 Points

A scored technical audit covering crawlability, indexability, security, Core Web Vitals, and the server-side rendering check that decides whether AI crawlers see your content at all

15 minutes
Advanced
Developer Tools

GEO Toolkit Updater

Pull the latest geo-seo-claude skills, agents, scripts, and schema templates from upstream, with a diff summary before anything is overwritten

5 minutes
Beginner

Browse all Developer Tools playbooks →