# Brainstorm

> Scan codebase, propose improvements AND features autonomously

- Skill: `majiayu000/brainstorm-11` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds add majiayu000/brainstorm-11`
- Raw SKILL.md: https://api.skillmd.com/api/skills/majiayu000/brainstorm-11/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: majiayu000 (https://skillmd.com/u/majiayu000)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/majiayu000/brainstorm-11

---


# Brainstorm

**Philosophy:** User doesn't know what to focus on. YOU scan, analyze, propose, and create stories - without asking.

## Usage

| Command | Behavior |
|---------|----------|
| `brainstorm` | Full: quality scan + feature ideas |
| `brainstorm auth` | Targeted: ideas for auth specifically |
| `brainstorm features` | Skip quality scan, only feature ideas |

## Phase 1: Quality Scan (Parallel)

Launch 4 scans simultaneously using Task tool with `run_in_background: true`:

```typescript
Task({ subagent_type: "Explore", model: "haiku", run_in_background: true,
  prompt: "Find TODOs/FIXMEs in [PROJECT_PATH]. Report: count, file:line, content." })

Task({ subagent_type: "Explore", model: "haiku", run_in_background: true,
  prompt: "Find console.log statements in [PROJECT_PATH] (skip test files). Report: count, files." })

Task({ subagent_type: "Explore", model: "haiku", run_in_background: true,
  prompt: "Find hardcoded colors (text-white, bg-black, #hex, rgb) in [PROJECT_PATH]. Report: count, files." })

Task({ subagent_type: "Explore", model: "haiku", run_in_background: true,
  prompt: "Find large files (>300 lines) and 'any' type usage in [PROJECT_PATH]. Report: file, lines, issues." })
```

## Phase 2: Feature Ideation (Autonomous)

After scans complete, read project context:
- `CLAUDE.md` - goals, roadmap, known issues
- `README.md` - what the app does
- `package.json` - name, description, dependencies

Then analyze and propose 3-8 features:
- **Missing features** - what similar apps have that this doesn't
- **UX improvements** - based on component structure found
- **Integration opportunities** - based on installed packages
- **Performance wins** - based on patterns observed

**Be specific:** "Add Cmd+K search modal" not "Improve UX"

## Phase 3: Present Everything

```
Brainstorm Complete
═══════════════════
Scanned 247 files in 45 seconds.

Quality Issues
┌──────────────────┬───────┬──────────────────┐
│ Category         │ Count │ Status           │
├──────────────────┼───────┼──────────────────┤
│ TODOs/FIXMEs     │ 0     │ ✅ Clean         │
│ console.log      │ 12    │ ⚠️ In 4 files    │
│ Hardcoded colors │ 6     │ ⚠️ In shadcn/ui  │
│ Large files      │ 3     │ ⚠️ >500 lines    │
└──────────────────┴───────┴──────────────────┘

Feature Ideas
┌───┬─────────────────────────────────┬────────┐
│ # │ Idea                            │ Effort │
├───┼─────────────────────────────────┼────────┤
│ 1 │ Add keyboard shortcuts (Cmd+K) │ Medium │
│ 2 │ Offline mode (PWA ready)        │ High   │
│ 3 │ Export to PDF                   │ Low    │
└───┴─────────────────────────────────┴────────┘

Create stories?
- "quality" → cleanup tasks only
- "features" → feature tasks only
- "all" → everything
```

## Targeted Mode

When user says `brainstorm X`:
- Skip quality scan entirely
- Read files related to X topic
- Propose 3-5 specific ideas for X
- Immediately create stories

## Rules

- **Never ask "what do you want?"** - analyze and propose
- **Don't over-generate** - 3-8 feature ideas max
- **Be specific** - concrete features, not vague improvements
- **Note effort** - Low/Medium/High for each
- **Skip shadcn/ui colors** - note them but don't prioritize (library defaults)
- **Auto-create for top recommendation** - then offer more

## Token Cost

- 4 parallel Haiku scans: ~20K tokens
- Context reads: ~5K tokens
- Time: 30-60 seconds
- Much cheaper than reading entire codebase