plugins/ai-pilot/skills/brainstorming/SKILL.md
Use when user requests creative work - creating features, building components, adding functionality, or modifying behavior. Activates BEFORE APEX Analyze phase to refine requirements through structured questioning.
npx skillsauth add fusengine/agents brainstormingInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
Design-first approach: no code before design approval.
Before ANY brainstorming session, use TeamCreate to spawn agents:
After design approval, transition to APEX Analyze phase, passing along the explore-codebase and research-expert findings in the handoff (not just the design doc). APEX Analyze re-runs those same agents by default — carrying forward what was already gathered here avoids re-doing the same research twice.
| Scenario | Action | |----------|--------| | New feature | Full brainstorming (6 steps) | | Major change | Full brainstorming (6 steps) | | Component creation | Full brainstorming (6 steps) | | Trivial fix (1-3 lines) | Skip brainstorming, go to APEX | | Simple rename/typo | Skip brainstorming, go to APEX |
Gather context before asking questions:
git log --oneline -20 - Recent changes and directionAsk focused questions sequentially. Wait for each answer before the next.
Categories: purpose, constraints, success criteria, users, integrations.
See workflow.md for question categories
Generate ≥6-8 distinct approaches via a named technique (SCAMPER / reverse-brainstorming / analogies), judgment suspended — not 3 sizes of the same idea. Only then converge to 2-3 with trade-offs in table format:
| Approach | Pros | Cons | Recommendation | |----------|------|------|----------------| | Option A | ... | ... | ... | | Option B | ... | ... | ... | | Option C | ... | ... | ... |
Always include a clear recommendation with rationale.
Break design into digestible sections:
Wait for explicit user approval before proceeding.
Save approved design to: docs/plans/YYYY-MM-DD-<topic>-design.md
Hand off to APEX Analyze phase with the approved design as input.
| Topic | Reference | When to Consult | |-------|-----------|-----------------| | Workflow | workflow.md | Question categories, proposal format, design template | | Anti-Patterns | anti-patterns.md | Catching rationalizations to skip brainstorming |
1. Explore → git log, codebase, docs (agents in parallel)
2. Question → ONE AT A TIME, wait for answers
3. Diverge → 6-8 options (named technique), converge to 2-3 with trade-offs table
4. Design → Present sections, get approval
5. Save → docs/plans/YYYY-MM-DD-<topic>-design.md
6. Handoff → APEX Analyze with approved design + prior research (no re-research)
testing
Copy self-audit and ban-lists — filler verbs/hype adjectives, slop placeholder names, fake-precise numbers, Title Case headlines, humor in error copy ('Oops!'), em-dash crutch, one copy register per page.
development
Logged-in web apps — dashboards, auth flows, settings, onboarding, data tables, command palettes, modals, toasts. Register `product`: density and glance-speed over marketing polish, no hero/CTA-tricks, every data surface covers empty/loading/error explicitly, tables and dataviz follow preattentive-processing rules.
development
Marketing sites, landing pages, campaign pages — register `brand` (design IS the product). Structure comes from the register's POV + a macrostructure pick, never from copying an inspiration site's section flow. Hero discipline, deviated section order, asymmetric grids, and a silhouette lookalike-test gate before ship.
development
Token-strategy core — OKLCH color rules, neutral tinting, accent-commitment levels, type scale, 8pt spacing grid, touch targets, and the canonical output format of design-system.md (the file the harness gates on). This is routing step 1 of design-method/SKILL.md — read it before design-web/design-webapp/design-ios/design-android, before picking or auditing a single color/type/spacing value.