115 lines
4.2 KiB
YAML
Raw Normal View History

docs: massive documentation overhaul + introduce Paige (Documentation Guide agent) ## 📚 Complete Documentation Restructure **BMM Documentation Hub Created:** - New centralized documentation system at `src/modules/bmm/docs/` - 18 comprehensive guides organized by topic (7000+ lines total) - Clear learning paths for greenfield, brownfield, and quick spec flows - Professional technical writing standards throughout **New Documentation:** - `README.md` - Complete documentation hub with navigation - `quick-start.md` - 15-minute getting started guide - `agents-guide.md` - Comprehensive 12-agent reference (45 min read) - `party-mode.md` - Multi-agent collaboration guide (20 min read) - `scale-adaptive-system.md` - Deep dive on Levels 0-4 (42 min read) - `brownfield-guide.md` - Existing codebase development (53 min read) - `quick-spec-flow.md` - Rapid Level 0-1 development (26 min read) - `workflows-analysis.md` - Phase 1 workflows (12 min read) - `workflows-planning.md` - Phase 2 workflows (19 min read) - `workflows-solutioning.md` - Phase 3 workflows (13 min read) - `workflows-implementation.md` - Phase 4 workflows (33 min read) - `workflows-testing.md` - Testing & QA workflows (29 min read) - `workflow-architecture-reference.md` - Architecture workflow deep-dive - `workflow-document-project-reference.md` - Document-project workflow reference - `enterprise-agentic-development.md` - Team collaboration patterns - `faq.md` - Comprehensive Q&A covering all topics - `glossary.md` - Complete terminology reference - `troubleshooting.md` - Common issues and solutions **Documentation Improvements:** - Removed all version/date footers (git handles versioning) - Agent customization docs now include full rebuild process - Cross-referenced links between all guides - Reading time estimates for all major docs - Consistent professional formatting and structure **Consolidated & Streamlined:** - Module README (`src/modules/bmm/README.md`) streamlined to lean signpost - Root README polished with better hierarchy and clear CTAs - Moved docs from root `docs/` to module-specific locations - Better separation of user docs vs. developer reference ## 🤖 New Agent: Paige (Documentation Guide) **Role:** Technical documentation specialist and information architect **Expertise:** - Professional technical writing standards - Documentation structure and organization - Information architecture and navigation - User-focused content design - Style guide enforcement **Status:** Work in progress - Paige will evolve as documentation needs grow **Integration:** - Listed in agents-guide.md, glossary.md, FAQ - Available for all phases (documentation is continuous) - Can be customized like all BMM agents ## 🔧 Additional Changes - Updated agent manifest with Paige - Updated workflow manifest with new documentation workflows - Fixed workflow-to-agent mappings across all guides - Improved root README with clearer Quick Start section - Better module structure explanations - Enhanced community links with Discord channel names **Total Impact:** - 18 new/restructured documentation files - 7000+ lines of professional technical documentation - Complete navigation system with cross-references - Clear learning paths for all user types - Foundation for knowledge base (coming in beta) Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-02 21:18:33 -06:00
# Market Research Workflow - Claude Code Integration Configuration
# This file configures how subagents are installed and integrated
subagents:
# List of subagent files to be installed
files:
- bmm-market-researcher.md
- bmm-trend-spotter.md
- bmm-data-analyst.md
- bmm-competitor-analyzer.md
- bmm-user-researcher.md
# Installation configuration
installation:
prompt: "The Market Research workflow includes specialized AI subagents for enhanced research capabilities. Would you like to install them?"
location_options:
- project # Install to .claude/agents/ in project
- user # Install to ~/.claude/agents/ for all projects
default_location: project
# Content injections for the workflow
injections:
- injection_point: "market-research-subagents"
description: "Injects subagent activation instructions into the workflow"
content: |
<critical>
Claude Code Enhanced Mode: The following specialized subagents are available to enhance your market research:
- **bmm-market-researcher**: Comprehensive market intelligence gathering and analysis
- **bmm-trend-spotter**: Identifies emerging trends and weak signals
- **bmm-data-analyst**: Quantitative analysis and market sizing calculations
- **bmm-competitor-analyzer**: Deep competitive intelligence and positioning
- **bmm-user-researcher**: User research, personas, and journey mapping
These subagents will be automatically invoked when their expertise is relevant to the current research task.
Use them PROACTIVELY throughout the workflow for enhanced insights.
</critical>
- injection_point: "market-tam-calculations"
description: "Enhanced TAM calculation with data analyst"
content: |
<invoke-subagent name="bmm-data-analyst">
Calculate TAM using multiple methodologies and provide confidence intervals.
Use all available market data from previous research steps.
Show detailed calculations and assumptions.
</invoke-subagent>
- injection_point: "market-trends-analysis"
description: "Enhanced trend analysis with trend spotter"
content: |
<invoke-subagent name="bmm-trend-spotter">
Identify emerging trends, weak signals, and future disruptions.
Look for cross-industry patterns and second-order effects.
Provide timeline estimates for mainstream adoption.
</invoke-subagent>
- injection_point: "market-customer-segments"
description: "Enhanced customer research"
content: |
<invoke-subagent name="bmm-user-researcher">
Develop detailed user personas with jobs-to-be-done analysis.
Map the complete customer journey with pain points and opportunities.
Provide behavioral and psychographic insights.
</invoke-subagent>
- injection_point: "market-executive-summary"
description: "Enhanced executive summary synthesis"
content: |
<invoke-subagent name="bmm-market-researcher">
Synthesize all research findings into a compelling executive summary.
Highlight the most critical insights and strategic implications.
Ensure all key metrics and recommendations are captured.
</invoke-subagent>
# Configuration for subagent behavior
configuration:
auto_invoke: true # Automatically invoke subagents when relevant
parallel_execution: true # Allow parallel subagent execution
cache_results: true # Cache subagent outputs for reuse
# Subagent-specific configurations
subagent_config:
bmm-market-researcher:
priority: high
max_execution_time: 300 # seconds
retry_on_failure: true
bmm-trend-spotter:
priority: medium
max_execution_time: 180
retry_on_failure: false
bmm-data-analyst:
priority: high
max_execution_time: 240
retry_on_failure: true
bmm-competitor-analyzer:
priority: high
max_execution_time: 300
retry_on_failure: true
bmm-user-researcher:
priority: medium
max_execution_time: 240
retry_on_failure: false
# Metadata
metadata:
compatible_with: "claude-code-1.0+"
workflow: "market-research"
module: "bmm"
author: "BMad Builder"
description: "Claude Code enhancements for comprehensive market research"