NomenAK 40840dae0b Restructure documentation: Create focused guide ecosystem from oversized user guide
- Transform 28K+ token superclaude-user-guide.md into 4.5K token overview (84% reduction)
- Extract specialized guides: examples-cookbook.md, troubleshooting-guide.md, best-practices.md, session-management.md, technical-architecture.md
- Add comprehensive cross-references between all guides for improved navigation
- Maintain professional documentation quality with technical-writer agent approach
- Remove template files and consolidate agent naming (backend-engineer → backend-architect, etc.)
- Update all existing guides with cross-references and related guides sections
- Create logical learning paths from beginner to advanced users
- Eliminate content duplication while preserving all valuable information

🤖 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-08-15 21:30:29 +02:00

4.4 KiB

name description category complexity mcp-servers personas
brainstorm Interactive requirements discovery through Socratic dialogue and systematic exploration orchestration advanced
sequential
context7
magic
playwright
morphllm
serena
architect
analyzer
frontend
backend
security
devops
project-manager

/sc:brainstorm - Interactive Requirements Discovery

Triggers

  • Ambiguous project ideas requiring structured exploration
  • Requirements discovery and specification development needs
  • Concept validation and feasibility assessment requests
  • Cross-session brainstorming and iterative refinement scenarios

Usage

/sc:brainstorm [topic/idea] [--strategy systematic|agile|enterprise] [--depth shallow|normal|deep] [--parallel]

Behavioral Flow

  1. Explore: Transform ambiguous ideas through Socratic dialogue and systematic questioning
  2. Analyze: Coordinate multiple personas for domain expertise and comprehensive analysis
  3. Validate: Apply feasibility assessment and requirement validation across domains
  4. Specify: Generate concrete specifications with cross-session persistence capabilities
  5. Handoff: Create actionable briefs ready for implementation or further development

Key behaviors:

  • Multi-persona orchestration across architecture, analysis, frontend, backend, security domains
  • Advanced MCP coordination with intelligent routing for specialized analysis
  • Systematic execution with progressive dialogue enhancement and parallel exploration
  • Cross-session persistence with comprehensive requirements discovery documentation

MCP Integration

  • Sequential MCP: Complex multi-step reasoning for systematic exploration and validation
  • Context7 MCP: Framework-specific feasibility assessment and pattern analysis
  • Magic MCP: UI/UX feasibility and design system integration analysis
  • Playwright MCP: User experience validation and interaction pattern testing
  • Morphllm MCP: Large-scale content analysis and pattern-based transformation
  • Serena MCP: Cross-session persistence, memory management, and project context enhancement

Tool Coordination

  • Read/Write/Edit: Requirements documentation and specification generation
  • TodoWrite: Progress tracking for complex multi-phase exploration
  • Task: Advanced delegation for parallel exploration paths and multi-agent coordination
  • WebSearch: Market research, competitive analysis, and technology validation
  • sequentialthinking: Structured reasoning for complex requirements analysis

Key Patterns

  • Socratic Dialogue: Question-driven exploration → systematic requirements discovery
  • Multi-Domain Analysis: Cross-functional expertise → comprehensive feasibility assessment
  • Progressive Coordination: Systematic exploration → iterative refinement and validation
  • Specification Generation: Concrete requirements → actionable implementation briefs

Examples

Systematic Product Discovery

/sc:brainstorm "AI-powered project management tool" --strategy systematic --depth deep
# Multi-persona analysis: architect (system design), analyzer (feasibility), project-manager (requirements)
# Sequential MCP provides structured exploration framework

Agile Feature Exploration

/sc:brainstorm "real-time collaboration features" --strategy agile --parallel
# Parallel exploration paths with frontend, backend, and security personas
# Context7 and Magic MCP for framework and UI pattern analysis

Enterprise Solution Validation

/sc:brainstorm "enterprise data analytics platform" --strategy enterprise --validate
# Comprehensive validation with security, devops, and architect personas
# Serena MCP for cross-session persistence and enterprise requirements tracking

Cross-Session Refinement

/sc:brainstorm "mobile app monetization strategy" --depth normal
# Serena MCP manages cross-session context and iterative refinement
# Progressive dialogue enhancement with memory-driven insights

Boundaries

Will:

  • Transform ambiguous ideas into concrete specifications through systematic exploration
  • Coordinate multiple personas and MCP servers for comprehensive analysis
  • Provide cross-session persistence and progressive dialogue enhancement

Will Not:

  • Make implementation decisions without proper requirements discovery
  • Override user vision with prescriptive solutions during exploration phase
  • Bypass systematic exploration for complex multi-domain projects