diff --git a/.bmad-core/agents/po.md b/.bmad-core/agents/po.md index ca02da79..91b24eb1 100644 --- a/.bmad-core/agents/po.md +++ b/.bmad-core/agents/po.md @@ -4,25 +4,22 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll ```yml activation-instructions: - - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - - Only read the files/tasks listed here when user selects them for execution to minimize context usage - - The customization field ALWAYS takes precedence over any conflicting instructions - - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - + - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! + - Only read the files/tasks listed here when user selects them for execution to minimize context usage + - The customization field ALWAYS takes precedence over any conflicting instructions + - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute agent: name: Sarah id: po title: Product Owner icon: šŸ“ - whenToUse: "Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions" - customization: - + whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions + customization: null persona: role: Technical Product Owner & Process Steward style: Meticulous, analytical, detail-oriented, systematic, collaborative identity: Product Owner who validates artifacts cohesion and coaches significant changes focus: Plan integrity, documentation quality, actionable development tasks, process adherence - core_principles: - Guardian of Quality & Completeness - Ensure all artifacts are comprehensive and consistent - Clarity & Actionability for Development - Make requirements unambiguous and testable @@ -34,21 +31,18 @@ persona: - User Collaboration for Validation - Seek input at critical checkpoints - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Documentation Ecosystem Integrity - Maintain consistency across all documents - startup: - Greet the user with your name and role, and inform of the *help command. - commands: - - "*help" - Show: numbered list of the following commands to allow selection - - "*chat-mode" - (Default) Product Owner consultation with advanced-elicitation - - "*create-doc {template}" - Create doc (no template = show available templates) - - "*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist) - - "*shard-doc {document}" - Break down document into actionable parts - - "*correct-course" - Analyze and suggest project course corrections - - "*create-epic" - Create epic for brownfield projects (task brownfield-create-epic) - - "*create-story" - Create user story from requirements (task brownfield-create-story) - - "*exit" - Say Goodbye, You are no longer this Agent - + - '*help" - Show: numbered list of the following commands to allow selection' + - '*chat-mode" - (Default) Product Owner consultation with advanced-elicitation' + - '*create-doc {template}" - Create doc (no template = show available templates)' + - '*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist)' + - '*shard-doc {document}" - Break down document into actionable parts' + - '*correct-course" - Analyze and suggest project course corrections' + - '*create-epic" - Create epic for brownfield projects (task brownfield-create-epic)' + - '*create-story" - Create user story from requirements (task brownfield-create-story)' + - '*exit" - Say Goodbye, You are no longer this Agent' dependencies: tasks: - execute-checklist diff --git a/.bmad-core/checklists/architect-checklist.md b/.bmad-core/checklists/architect-checklist.md index 40786945..8062c688 100644 --- a/.bmad-core/checklists/architect-checklist.md +++ b/.bmad-core/checklists/architect-checklist.md @@ -403,28 +403,33 @@ Ask the user if they want to work through the checklist: Now that you've completed the checklist, generate a comprehensive validation report that includes: 1. Executive Summary + - Overall architecture readiness (High/Medium/Low) - Critical risks identified - Key strengths of the architecture - Project type (Full-stack/Frontend/Backend) and sections evaluated 2. Section Analysis + - Pass rate for each major section (percentage of items passed) - Most concerning failures or gaps - Sections requiring immediate attention - Note any sections skipped due to project type 3. Risk Assessment + - Top 5 risks by severity - Mitigation recommendations for each - Timeline impact of addressing issues 4. Recommendations + - Must-fix items before development - Should-fix items for better quality - Nice-to-have improvements 5. AI Implementation Readiness + - Specific concerns for AI agent implementation - Areas needing additional clarification - Complexity hotspots to address diff --git a/.bmad-core/tasks/brainstorming-techniques.md b/.bmad-core/tasks/brainstorming-techniques.md index d5c388bc..631a16c6 100644 --- a/.bmad-core/tasks/brainstorming-techniques.md +++ b/.bmad-core/tasks/brainstorming-techniques.md @@ -9,6 +9,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Begin by understanding the brainstorming context and goals. Ask clarifying questions if needed to determine the best approach.]] 1. **Establish Context** + - Understand the problem space or opportunity area - Identify any constraints or parameters - Determine session goals (divergent exploration vs. focused ideation) @@ -25,6 +26,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"What If" Scenarios** [[LLM: Generate provocative what-if questions that challenge assumptions and expand thinking beyond current limitations.]] + - What if we had unlimited resources? - What if this problem didn't exist? - What if we approached this from a child's perspective? @@ -32,6 +34,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Analogical Thinking** [[LLM: Help user draw parallels between their challenge and other domains, industries, or natural systems.]] + - "How might this work like [X] but for [Y]?" - Nature-inspired solutions (biomimicry) - Cross-industry pattern matching @@ -39,6 +42,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 3. **Reversal/Inversion** [[LLM: Flip the problem or approach it from the opposite angle to reveal new insights.]] + - What if we did the exact opposite? - How could we make this problem worse? (then reverse) - Start from the end goal and work backward @@ -55,6 +59,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **SCAMPER Method** [[LLM: Guide through each SCAMPER prompt systematically.]] + - **S** = Substitute: What can be substituted? - **C** = Combine: What can be combined or integrated? - **A** = Adapt: What can be adapted from elsewhere? @@ -65,6 +70,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Six Thinking Hats** [[LLM: Cycle through different thinking modes, spending focused time in each.]] + - White Hat: Facts and information - Red Hat: Emotions and intuition - Black Hat: Caution and critical thinking @@ -91,6 +97,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"Yes, And..." Building** [[LLM: Accept every idea and build upon it without judgment. Encourage wild ideas and defer criticism.]] + - Accept the premise of each idea - Add to it with "Yes, and..." - Build chains of connected ideas @@ -98,40 +105,43 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Brainwriting/Round Robin** [[LLM: Simulate multiple perspectives by generating ideas from different viewpoints.]] + - Generate ideas from stakeholder perspectives - Build on previous ideas in rounds - Combine unrelated ideas - Cross-pollinate concepts 3. **Random Stimulation** - [[LLM: Use random words, images, or concepts as creative triggers.]] - - Random word association - - Picture/metaphor inspiration - - Forced connections between unrelated items - - Constraint-based creativity + [[LLM: Use random words, images, or concepts as creative triggers.]] + - Random word association + - Picture/metaphor inspiration + - Forced connections between unrelated items + - Constraint-based creativity #### Deep Exploration Techniques 1. **Five Whys** - [[LLM: Dig deeper into root causes and underlying motivations.]] - - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) - - Uncover hidden assumptions - - Find root causes, not symptoms - - Identify intervention points + [[LLM: Dig deeper into root causes and underlying motivations.]] + + - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) + - Uncover hidden assumptions + - Find root causes, not symptoms + - Identify intervention points 2. **Morphological Analysis** - [[LLM: Break down into parameters and systematically explore combinations.]] - - List key parameters/dimensions - - Identify possible values for each - - Create combination matrix - - Explore unusual combinations + [[LLM: Break down into parameters and systematically explore combinations.]] + + - List key parameters/dimensions + - Identify possible values for each + - Create combination matrix + - Explore unusual combinations 3. **Provocation Technique (PO)** - [[LLM: Make deliberately provocative statements to jar thinking.]] - - PO: Cars have square wheels - - PO: Customers pay us to take products - - PO: The problem solves itself - - Extract useful ideas from provocations + [[LLM: Make deliberately provocative statements to jar thinking.]] + - PO: Cars have square wheels + - PO: Customers pay us to take products + - PO: The problem solves itself + - Extract useful ideas from provocations ### 3. Technique Selection Guide @@ -172,16 +182,19 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Guide the brainstorming session with appropriate pacing and technique transitions.]] 1. **Warm-up Phase** (5-10 min) + - Start with accessible techniques - Build creative confidence - Establish "no judgment" atmosphere 2. **Divergent Phase** (20-30 min) + - Use expansion techniques - Generate quantity over quality - Encourage wild ideas 3. **Convergent Phase** (15-20 min) + - Group and categorize ideas - Identify patterns and themes - Select promising directions diff --git a/.bmad-core/tasks/create-deep-research-prompt.md b/.bmad-core/tasks/create-deep-research-prompt.md index 3b796548..c77163e9 100644 --- a/.bmad-core/tasks/create-deep-research-prompt.md +++ b/.bmad-core/tasks/create-deep-research-prompt.md @@ -189,53 +189,65 @@ Present these numbered options to the user: ```markdown ## Research Objective + [Clear statement of what this research aims to achieve] ## Background Context + [Relevant information from project brief, brainstorming, or other inputs] ## Research Questions ### Primary Questions (Must Answer) + 1. [Specific, actionable question] 2. [Specific, actionable question] -... + ... ### Secondary Questions (Nice to Have) + 1. [Supporting question] 2. [Supporting question] -... + ... ## Research Methodology ### Information Sources + - [Specific source types and priorities] ### Analysis Frameworks + - [Specific frameworks to apply] ### Data Requirements + - [Quality, recency, credibility needs] ## Expected Deliverables ### Executive Summary + - Key findings and insights - Critical implications - Recommended actions ### Detailed Analysis + [Specific sections needed based on research type] ### Supporting Materials + - Data tables - Comparison matrices - Source documentation ## Success Criteria + [How to evaluate if research achieved its objectives] ## Timeline and Priority + [If applicable, any time constraints or phasing] ``` diff --git a/.bmad-core/tasks/doc-migration-task.md b/.bmad-core/tasks/doc-migration-task.md index 2ad3124b..a0116ada 100644 --- a/.bmad-core/tasks/doc-migration-task.md +++ b/.bmad-core/tasks/doc-migration-task.md @@ -39,19 +39,23 @@ Migrate BMAD-METHOD documents to match V4 template structure exactly, preserving ### Content Migration Process 1. **Read Template Structure** + - Extract all Level 2 headings from the V4 template - These are the ONLY Level 2 headings allowed in the final document 2. **Analyze Original Document** + - Identify all content blocks - Note original section organization - Flag any custom sections 3. **Create Backup First** + - Rename original file: `mv filename.md filename.md.bak` - This preserves the original completely 4. **Create New File** + - Create new `filename.md` from scratch - Start with template structure (all Level 2 headings) - For each content block from original: @@ -72,23 +76,37 @@ Migrate BMAD-METHOD documents to match V4 template structure exactly, preserving ```markdown Original (prd.md): + ## Executive Summary + [content...] -## Custom Feature Section + +## Custom Feature Section + [content...] + ## Table of Contents + [toc...] Template (prd-tmpl.md): + ## Goals and Background Context + ## Functional Requirements + ## Success Metrics and KPIs Result (prd.md): + ## Goals and Background Context + [executive summary content moved here] + ### Custom Feature Section + [content preserved but demoted to Level 3] + ## Functional Requirements ## Success Metrics and KPIs diff --git a/.bmad-core/tasks/generate-ai-frontend-prompt.md b/.bmad-core/tasks/generate-ai-frontend-prompt.md index c62b4151..0aecb920 100644 --- a/.bmad-core/tasks/generate-ai-frontend-prompt.md +++ b/.bmad-core/tasks/generate-ai-frontend-prompt.md @@ -15,44 +15,44 @@ To generate a masterful, comprehensive, and optimized prompt that can be used wi 1. **Confirm Target AI Generation Platform:** - - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). - - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. + - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). + - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. 2. **Synthesize Inputs into a Structured Prompt:** - - **Overall Project Context:** - - Briefly state the project's purpose (from brief/PRD). - - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). - - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). - - **Design System & Visuals:** - - Reference the primary design files (e.g., Figma link). - - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). - - List any global UI components or design tokens that should be defined or adhered to. - - **Application Structure & Routing:** - - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). - - Outline the navigation structure (from `front-end-spec-tmpl`). - - **Key User Flows & Page-Level Interactions:** - - For a few critical user flows (from `front-end-spec-tmpl`): - - Describe the sequence of user actions and expected UI changes on each relevant page. - - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. - - **Component Generation Instructions (Iterative or Key Components):** - - Based on the chosen AI tool's capabilities, decide on a strategy: - - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. - - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). - - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. - - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. - - **State Management (High-Level Pointers):** - - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). - - For key pieces of data, indicate if they should be managed in global state. - - **API Integration Points:** - - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). - - **Critical "Don'ts" or Constraints:** - - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." - - **Platform-Specific Optimizations:** - - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). + - **Overall Project Context:** + - Briefly state the project's purpose (from brief/PRD). + - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). + - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). + - **Design System & Visuals:** + - Reference the primary design files (e.g., Figma link). + - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). + - List any global UI components or design tokens that should be defined or adhered to. + - **Application Structure & Routing:** + - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). + - Outline the navigation structure (from `front-end-spec-tmpl`). + - **Key User Flows & Page-Level Interactions:** + - For a few critical user flows (from `front-end-spec-tmpl`): + - Describe the sequence of user actions and expected UI changes on each relevant page. + - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. + - **Component Generation Instructions (Iterative or Key Components):** + - Based on the chosen AI tool's capabilities, decide on a strategy: + - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. + - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). + - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. + - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. + - **State Management (High-Level Pointers):** + - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). + - For key pieces of data, indicate if they should be managed in global state. + - **API Integration Points:** + - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). + - **Critical "Don'ts" or Constraints:** + - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." + - **Platform-Specific Optimizations:** + - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). 3. **Present and Refine the Master Prompt:** - - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). - - Explain the structure of the prompt and why certain information was included. - - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. - - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. + - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). + - Explain the structure of the prompt and why certain information was included. + - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. + - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. diff --git a/.bmad-core/tasks/index-docs.md b/.bmad-core/tasks/index-docs.md index a55ebfd9..1e58e79f 100644 --- a/.bmad-core/tasks/index-docs.md +++ b/.bmad-core/tasks/index-docs.md @@ -88,7 +88,7 @@ Documents within the `another-folder/` directory: ### [Nested Document](./another-folder/document.md) Description of nested document. -``` +```text ### Index Entry Format @@ -156,6 +156,7 @@ For each file referenced in the index but not found in the filesystem: ### Special Cases 1. **Sharded Documents**: If a folder contains an `index.md` file, treat it as a sharded document: + - Use the folder's `index.md` title as the section title - List the folder's documents as subsections - Note in the description that this is a multi-part document diff --git a/.bmad-core/web-bundles/agents/analyst.txt b/.bmad-core/web-bundles/agents/analyst.txt index d300ae2c..492120cf 100644 --- a/.bmad-core/web-bundles/agents/analyst.txt +++ b/.bmad-core/web-bundles/agents/analyst.txt @@ -118,6 +118,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Begin by understanding the brainstorming context and goals. Ask clarifying questions if needed to determine the best approach.]] 1. **Establish Context** + - Understand the problem space or opportunity area - Identify any constraints or parameters - Determine session goals (divergent exploration vs. focused ideation) @@ -134,6 +135,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"What If" Scenarios** [[LLM: Generate provocative what-if questions that challenge assumptions and expand thinking beyond current limitations.]] + - What if we had unlimited resources? - What if this problem didn't exist? - What if we approached this from a child's perspective? @@ -141,6 +143,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Analogical Thinking** [[LLM: Help user draw parallels between their challenge and other domains, industries, or natural systems.]] + - "How might this work like [X] but for [Y]?" - Nature-inspired solutions (biomimicry) - Cross-industry pattern matching @@ -148,6 +151,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 3. **Reversal/Inversion** [[LLM: Flip the problem or approach it from the opposite angle to reveal new insights.]] + - What if we did the exact opposite? - How could we make this problem worse? (then reverse) - Start from the end goal and work backward @@ -164,6 +168,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **SCAMPER Method** [[LLM: Guide through each SCAMPER prompt systematically.]] + - **S** = Substitute: What can be substituted? - **C** = Combine: What can be combined or integrated? - **A** = Adapt: What can be adapted from elsewhere? @@ -174,6 +179,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Six Thinking Hats** [[LLM: Cycle through different thinking modes, spending focused time in each.]] + - White Hat: Facts and information - Red Hat: Emotions and intuition - Black Hat: Caution and critical thinking @@ -200,6 +206,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"Yes, And..." Building** [[LLM: Accept every idea and build upon it without judgment. Encourage wild ideas and defer criticism.]] + - Accept the premise of each idea - Add to it with "Yes, and..." - Build chains of connected ideas @@ -207,40 +214,43 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Brainwriting/Round Robin** [[LLM: Simulate multiple perspectives by generating ideas from different viewpoints.]] + - Generate ideas from stakeholder perspectives - Build on previous ideas in rounds - Combine unrelated ideas - Cross-pollinate concepts 3. **Random Stimulation** - [[LLM: Use random words, images, or concepts as creative triggers.]] - - Random word association - - Picture/metaphor inspiration - - Forced connections between unrelated items - - Constraint-based creativity + [[LLM: Use random words, images, or concepts as creative triggers.]] + - Random word association + - Picture/metaphor inspiration + - Forced connections between unrelated items + - Constraint-based creativity #### Deep Exploration Techniques 1. **Five Whys** - [[LLM: Dig deeper into root causes and underlying motivations.]] - - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) - - Uncover hidden assumptions - - Find root causes, not symptoms - - Identify intervention points + [[LLM: Dig deeper into root causes and underlying motivations.]] + + - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) + - Uncover hidden assumptions + - Find root causes, not symptoms + - Identify intervention points 2. **Morphological Analysis** - [[LLM: Break down into parameters and systematically explore combinations.]] - - List key parameters/dimensions - - Identify possible values for each - - Create combination matrix - - Explore unusual combinations + [[LLM: Break down into parameters and systematically explore combinations.]] + + - List key parameters/dimensions + - Identify possible values for each + - Create combination matrix + - Explore unusual combinations 3. **Provocation Technique (PO)** - [[LLM: Make deliberately provocative statements to jar thinking.]] - - PO: Cars have square wheels - - PO: Customers pay us to take products - - PO: The problem solves itself - - Extract useful ideas from provocations + [[LLM: Make deliberately provocative statements to jar thinking.]] + - PO: Cars have square wheels + - PO: Customers pay us to take products + - PO: The problem solves itself + - Extract useful ideas from provocations ### 3. Technique Selection Guide @@ -281,16 +291,19 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Guide the brainstorming session with appropriate pacing and technique transitions.]] 1. **Warm-up Phase** (5-10 min) + - Start with accessible techniques - Build creative confidence - Establish "no judgment" atmosphere 2. **Divergent Phase** (20-30 min) + - Use expansion techniques - Generate quantity over quality - Encourage wild ideas 3. **Convergent Phase** (15-20 min) + - Group and categorize ideas - Identify patterns and themes - Select promising directions @@ -526,53 +539,65 @@ Present these numbered options to the user: ```markdown ## Research Objective + [Clear statement of what this research aims to achieve] ## Background Context + [Relevant information from project brief, brainstorming, or other inputs] ## Research Questions ### Primary Questions (Must Answer) + 1. [Specific, actionable question] 2. [Specific, actionable question] -... + ... ### Secondary Questions (Nice to Have) + 1. [Supporting question] 2. [Supporting question] -... + ... ## Research Methodology ### Information Sources + - [Specific source types and priorities] ### Analysis Frameworks + - [Specific frameworks to apply] ### Data Requirements + - [Quality, recency, credibility needs] ## Expected Deliverables ### Executive Summary + - Key findings and insights - Critical implications - Recommended actions ### Detailed Analysis + [Specific sections needed based on research type] ### Supporting Materials + - Data tables - Comparison matrices - Source documentation ## Success Criteria + [How to evaluate if research achieved its objectives] ## Timeline and Priority + [If applicable, any time constraints or phasing] ``` diff --git a/.bmad-core/web-bundles/agents/architect.txt b/.bmad-core/web-bundles/agents/architect.txt index 25fd5d12..ba640784 100644 --- a/.bmad-core/web-bundles/agents/architect.txt +++ b/.bmad-core/web-bundles/agents/architect.txt @@ -476,53 +476,65 @@ Present these numbered options to the user: ```markdown ## Research Objective + [Clear statement of what this research aims to achieve] ## Background Context + [Relevant information from project brief, brainstorming, or other inputs] ## Research Questions ### Primary Questions (Must Answer) + 1. [Specific, actionable question] 2. [Specific, actionable question] -... + ... ### Secondary Questions (Nice to Have) + 1. [Supporting question] 2. [Supporting question] -... + ... ## Research Methodology ### Information Sources + - [Specific source types and priorities] ### Analysis Frameworks + - [Specific frameworks to apply] ### Data Requirements + - [Quality, recency, credibility needs] ## Expected Deliverables ### Executive Summary + - Key findings and insights - Critical implications - Recommended actions ### Detailed Analysis + [Specific sections needed based on research type] ### Supporting Materials + - Data tables - Comparison matrices - Source documentation ## Success Criteria + [How to evaluate if research achieved its objectives] ## Timeline and Priority + [If applicable, any time constraints or phasing] ``` @@ -3514,28 +3526,33 @@ Ask the user if they want to work through the checklist: Now that you've completed the checklist, generate a comprehensive validation report that includes: 1. Executive Summary + - Overall architecture readiness (High/Medium/Low) - Critical risks identified - Key strengths of the architecture - Project type (Full-stack/Frontend/Backend) and sections evaluated 2. Section Analysis + - Pass rate for each major section (percentage of items passed) - Most concerning failures or gaps - Sections requiring immediate attention - Note any sections skipped due to project type 3. Risk Assessment + - Top 5 risks by severity - Mitigation recommendations for each - Timeline impact of addressing issues 4. Recommendations + - Must-fix items before development - Should-fix items for better quality - Nice-to-have improvements 5. AI Implementation Readiness + - Specific concerns for AI agent implementation - Areas needing additional clarification - Complexity hotspots to address diff --git a/.bmad-core/web-bundles/agents/bmad-master.txt b/.bmad-core/web-bundles/agents/bmad-master.txt index 37a8b9f8..3fc3cd3e 100644 --- a/.bmad-core/web-bundles/agents/bmad-master.txt +++ b/.bmad-core/web-bundles/agents/bmad-master.txt @@ -255,6 +255,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Begin by understanding the brainstorming context and goals. Ask clarifying questions if needed to determine the best approach.]] 1. **Establish Context** + - Understand the problem space or opportunity area - Identify any constraints or parameters - Determine session goals (divergent exploration vs. focused ideation) @@ -271,6 +272,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"What If" Scenarios** [[LLM: Generate provocative what-if questions that challenge assumptions and expand thinking beyond current limitations.]] + - What if we had unlimited resources? - What if this problem didn't exist? - What if we approached this from a child's perspective? @@ -278,6 +280,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Analogical Thinking** [[LLM: Help user draw parallels between their challenge and other domains, industries, or natural systems.]] + - "How might this work like [X] but for [Y]?" - Nature-inspired solutions (biomimicry) - Cross-industry pattern matching @@ -285,6 +288,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 3. **Reversal/Inversion** [[LLM: Flip the problem or approach it from the opposite angle to reveal new insights.]] + - What if we did the exact opposite? - How could we make this problem worse? (then reverse) - Start from the end goal and work backward @@ -301,6 +305,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **SCAMPER Method** [[LLM: Guide through each SCAMPER prompt systematically.]] + - **S** = Substitute: What can be substituted? - **C** = Combine: What can be combined or integrated? - **A** = Adapt: What can be adapted from elsewhere? @@ -311,6 +316,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Six Thinking Hats** [[LLM: Cycle through different thinking modes, spending focused time in each.]] + - White Hat: Facts and information - Red Hat: Emotions and intuition - Black Hat: Caution and critical thinking @@ -337,6 +343,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"Yes, And..." Building** [[LLM: Accept every idea and build upon it without judgment. Encourage wild ideas and defer criticism.]] + - Accept the premise of each idea - Add to it with "Yes, and..." - Build chains of connected ideas @@ -344,40 +351,43 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Brainwriting/Round Robin** [[LLM: Simulate multiple perspectives by generating ideas from different viewpoints.]] + - Generate ideas from stakeholder perspectives - Build on previous ideas in rounds - Combine unrelated ideas - Cross-pollinate concepts 3. **Random Stimulation** - [[LLM: Use random words, images, or concepts as creative triggers.]] - - Random word association - - Picture/metaphor inspiration - - Forced connections between unrelated items - - Constraint-based creativity + [[LLM: Use random words, images, or concepts as creative triggers.]] + - Random word association + - Picture/metaphor inspiration + - Forced connections between unrelated items + - Constraint-based creativity #### Deep Exploration Techniques 1. **Five Whys** - [[LLM: Dig deeper into root causes and underlying motivations.]] - - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) - - Uncover hidden assumptions - - Find root causes, not symptoms - - Identify intervention points + [[LLM: Dig deeper into root causes and underlying motivations.]] + + - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) + - Uncover hidden assumptions + - Find root causes, not symptoms + - Identify intervention points 2. **Morphological Analysis** - [[LLM: Break down into parameters and systematically explore combinations.]] - - List key parameters/dimensions - - Identify possible values for each - - Create combination matrix - - Explore unusual combinations + [[LLM: Break down into parameters and systematically explore combinations.]] + + - List key parameters/dimensions + - Identify possible values for each + - Create combination matrix + - Explore unusual combinations 3. **Provocation Technique (PO)** - [[LLM: Make deliberately provocative statements to jar thinking.]] - - PO: Cars have square wheels - - PO: Customers pay us to take products - - PO: The problem solves itself - - Extract useful ideas from provocations + [[LLM: Make deliberately provocative statements to jar thinking.]] + - PO: Cars have square wheels + - PO: Customers pay us to take products + - PO: The problem solves itself + - Extract useful ideas from provocations ### 3. Technique Selection Guide @@ -418,16 +428,19 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Guide the brainstorming session with appropriate pacing and technique transitions.]] 1. **Warm-up Phase** (5-10 min) + - Start with accessible techniques - Build creative confidence - Establish "no judgment" atmosphere 2. **Divergent Phase** (20-30 min) + - Use expansion techniques - Generate quantity over quality - Encourage wild ideas 3. **Convergent Phase** (15-20 min) + - Group and categorize ideas - Identify patterns and themes - Select promising directions @@ -1129,53 +1142,65 @@ Present these numbered options to the user: ```markdown ## Research Objective + [Clear statement of what this research aims to achieve] ## Background Context + [Relevant information from project brief, brainstorming, or other inputs] ## Research Questions ### Primary Questions (Must Answer) + 1. [Specific, actionable question] 2. [Specific, actionable question] -... + ... ### Secondary Questions (Nice to Have) + 1. [Supporting question] 2. [Supporting question] -... + ... ## Research Methodology ### Information Sources + - [Specific source types and priorities] ### Analysis Frameworks + - [Specific frameworks to apply] ### Data Requirements + - [Quality, recency, credibility needs] ## Expected Deliverables ### Executive Summary + - Key findings and insights - Critical implications - Recommended actions ### Detailed Analysis + [Specific sections needed based on research type] ### Supporting Materials + - Data tables - Comparison matrices - Source documentation ## Success Criteria + [How to evaluate if research achieved its objectives] ## Timeline and Priority + [If applicable, any time constraints or phasing] ``` @@ -2498,47 +2523,47 @@ To generate a masterful, comprehensive, and optimized prompt that can be used wi 1. **Confirm Target AI Generation Platform:** - - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). - - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. + - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). + - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. 2. **Synthesize Inputs into a Structured Prompt:** - - **Overall Project Context:** - - Briefly state the project's purpose (from brief/PRD). - - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). - - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). - - **Design System & Visuals:** - - Reference the primary design files (e.g., Figma link). - - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). - - List any global UI components or design tokens that should be defined or adhered to. - - **Application Structure & Routing:** - - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). - - Outline the navigation structure (from `front-end-spec-tmpl`). - - **Key User Flows & Page-Level Interactions:** - - For a few critical user flows (from `front-end-spec-tmpl`): - - Describe the sequence of user actions and expected UI changes on each relevant page. - - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. - - **Component Generation Instructions (Iterative or Key Components):** - - Based on the chosen AI tool's capabilities, decide on a strategy: - - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. - - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). - - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. - - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. - - **State Management (High-Level Pointers):** - - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). - - For key pieces of data, indicate if they should be managed in global state. - - **API Integration Points:** - - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). - - **Critical "Don'ts" or Constraints:** - - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." - - **Platform-Specific Optimizations:** - - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). + - **Overall Project Context:** + - Briefly state the project's purpose (from brief/PRD). + - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). + - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). + - **Design System & Visuals:** + - Reference the primary design files (e.g., Figma link). + - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). + - List any global UI components or design tokens that should be defined or adhered to. + - **Application Structure & Routing:** + - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). + - Outline the navigation structure (from `front-end-spec-tmpl`). + - **Key User Flows & Page-Level Interactions:** + - For a few critical user flows (from `front-end-spec-tmpl`): + - Describe the sequence of user actions and expected UI changes on each relevant page. + - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. + - **Component Generation Instructions (Iterative or Key Components):** + - Based on the chosen AI tool's capabilities, decide on a strategy: + - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. + - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). + - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. + - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. + - **State Management (High-Level Pointers):** + - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). + - For key pieces of data, indicate if they should be managed in global state. + - **API Integration Points:** + - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). + - **Critical "Don'ts" or Constraints:** + - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." + - **Platform-Specific Optimizations:** + - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). 3. **Present and Refine the Master Prompt:** - - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). - - Explain the structure of the prompt and why certain information was included. - - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. - - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. + - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). + - Explain the structure of the prompt and why certain information was included. + - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. + - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. ==================== END: tasks#generate-ai-frontend-prompt ==================== ==================== START: tasks#index-docs ==================== @@ -2700,6 +2725,7 @@ For each file referenced in the index but not found in the filesystem: ### Special Cases 1. **Sharded Documents**: If a folder contains an `index.md` file, treat it as a sharded document: + - Use the folder's `index.md` title as the section title - List the folder's documents as subsections - Note in the description that this is a multi-part document @@ -7743,28 +7769,33 @@ Ask the user if they want to work through the checklist: Now that you've completed the checklist, generate a comprehensive validation report that includes: 1. Executive Summary + - Overall architecture readiness (High/Medium/Low) - Critical risks identified - Key strengths of the architecture - Project type (Full-stack/Frontend/Backend) and sections evaluated 2. Section Analysis + - Pass rate for each major section (percentage of items passed) - Most concerning failures or gaps - Sections requiring immediate attention - Note any sections skipped due to project type 3. Risk Assessment + - Top 5 risks by severity - Mitigation recommendations for each - Timeline impact of addressing issues 4. Recommendations + - Must-fix items before development - Should-fix items for better quality - Nice-to-have improvements 5. AI Implementation Readiness + - Specific concerns for AI agent implementation - Areas needing additional clarification - Complexity hotspots to address diff --git a/.bmad-core/web-bundles/agents/pm.txt b/.bmad-core/web-bundles/agents/pm.txt index 4027c360..582cf1d6 100644 --- a/.bmad-core/web-bundles/agents/pm.txt +++ b/.bmad-core/web-bundles/agents/pm.txt @@ -450,53 +450,65 @@ Present these numbered options to the user: ```markdown ## Research Objective + [Clear statement of what this research aims to achieve] ## Background Context + [Relevant information from project brief, brainstorming, or other inputs] ## Research Questions ### Primary Questions (Must Answer) + 1. [Specific, actionable question] 2. [Specific, actionable question] -... + ... ### Secondary Questions (Nice to Have) + 1. [Supporting question] 2. [Supporting question] -... + ... ## Research Methodology ### Information Sources + - [Specific source types and priorities] ### Analysis Frameworks + - [Specific frameworks to apply] ### Data Requirements + - [Quality, recency, credibility needs] ## Expected Deliverables ### Executive Summary + - Key findings and insights - Critical implications - Recommended actions ### Detailed Analysis + [Specific sections needed based on research type] ### Supporting Materials + - Data tables - Comparison matrices - Source documentation ## Success Criteria + [How to evaluate if research achieved its objectives] ## Timeline and Priority + [If applicable, any time constraints or phasing] ``` diff --git a/.bmad-core/web-bundles/agents/po.txt b/.bmad-core/web-bundles/agents/po.txt index f0a8a70f..7ec88d8b 100644 --- a/.bmad-core/web-bundles/agents/po.txt +++ b/.bmad-core/web-bundles/agents/po.txt @@ -45,25 +45,22 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll ```yml activation-instructions: - - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - - Only read the files/tasks listed here when user selects them for execution to minimize context usage - - The customization field ALWAYS takes precedence over any conflicting instructions - - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - + - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! + - Only read the files/tasks listed here when user selects them for execution to minimize context usage + - The customization field ALWAYS takes precedence over any conflicting instructions + - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute agent: name: Sarah id: po title: Product Owner icon: šŸ“ - whenToUse: "Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions" - customization: - + whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions + customization: null persona: role: Technical Product Owner & Process Steward style: Meticulous, analytical, detail-oriented, systematic, collaborative identity: Product Owner who validates artifacts cohesion and coaches significant changes focus: Plan integrity, documentation quality, actionable development tasks, process adherence - core_principles: - Guardian of Quality & Completeness - Ensure all artifacts are comprehensive and consistent - Clarity & Actionability for Development - Make requirements unambiguous and testable @@ -75,21 +72,18 @@ persona: - User Collaboration for Validation - Seek input at critical checkpoints - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Documentation Ecosystem Integrity - Maintain consistency across all documents - startup: - Greet the user with your name and role, and inform of the *help command. - commands: - - "*help" - Show: numbered list of the following commands to allow selection - - "*chat-mode" - (Default) Product Owner consultation with advanced-elicitation - - "*create-doc {template}" - Create doc (no template = show available templates) - - "*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist) - - "*shard-doc {document}" - Break down document into actionable parts - - "*correct-course" - Analyze and suggest project course corrections - - "*create-epic" - Create epic for brownfield projects (task brownfield-create-epic) - - "*create-story" - Create user story from requirements (task brownfield-create-story) - - "*exit" - Say Goodbye, You are no longer this Agent - + - '*help" - Show: numbered list of the following commands to allow selection' + - '*chat-mode" - (Default) Product Owner consultation with advanced-elicitation' + - '*create-doc {template}" - Create doc (no template = show available templates)' + - '*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist)' + - '*shard-doc {document}" - Break down document into actionable parts' + - '*correct-course" - Analyze and suggest project course corrections' + - '*create-epic" - Create epic for brownfield projects (task brownfield-create-epic)' + - '*create-story" - Create user story from requirements (task brownfield-create-story)' + - '*exit" - Say Goodbye, You are no longer this Agent' dependencies: tasks: - execute-checklist diff --git a/.bmad-core/web-bundles/agents/ux-expert.txt b/.bmad-core/web-bundles/agents/ux-expert.txt index b4c237de..dcfdf579 100644 --- a/.bmad-core/web-bundles/agents/ux-expert.txt +++ b/.bmad-core/web-bundles/agents/ux-expert.txt @@ -125,47 +125,47 @@ To generate a masterful, comprehensive, and optimized prompt that can be used wi 1. **Confirm Target AI Generation Platform:** - - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). - - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. + - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). + - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. 2. **Synthesize Inputs into a Structured Prompt:** - - **Overall Project Context:** - - Briefly state the project's purpose (from brief/PRD). - - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). - - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). - - **Design System & Visuals:** - - Reference the primary design files (e.g., Figma link). - - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). - - List any global UI components or design tokens that should be defined or adhered to. - - **Application Structure & Routing:** - - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). - - Outline the navigation structure (from `front-end-spec-tmpl`). - - **Key User Flows & Page-Level Interactions:** - - For a few critical user flows (from `front-end-spec-tmpl`): - - Describe the sequence of user actions and expected UI changes on each relevant page. - - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. - - **Component Generation Instructions (Iterative or Key Components):** - - Based on the chosen AI tool's capabilities, decide on a strategy: - - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. - - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). - - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. - - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. - - **State Management (High-Level Pointers):** - - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). - - For key pieces of data, indicate if they should be managed in global state. - - **API Integration Points:** - - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). - - **Critical "Don'ts" or Constraints:** - - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." - - **Platform-Specific Optimizations:** - - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). + - **Overall Project Context:** + - Briefly state the project's purpose (from brief/PRD). + - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). + - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). + - **Design System & Visuals:** + - Reference the primary design files (e.g., Figma link). + - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). + - List any global UI components or design tokens that should be defined or adhered to. + - **Application Structure & Routing:** + - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). + - Outline the navigation structure (from `front-end-spec-tmpl`). + - **Key User Flows & Page-Level Interactions:** + - For a few critical user flows (from `front-end-spec-tmpl`): + - Describe the sequence of user actions and expected UI changes on each relevant page. + - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. + - **Component Generation Instructions (Iterative or Key Components):** + - Based on the chosen AI tool's capabilities, decide on a strategy: + - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. + - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). + - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. + - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. + - **State Management (High-Level Pointers):** + - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). + - For key pieces of data, indicate if they should be managed in global state. + - **API Integration Points:** + - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). + - **Critical "Don'ts" or Constraints:** + - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." + - **Platform-Specific Optimizations:** + - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). 3. **Present and Refine the Master Prompt:** - - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). - - Explain the structure of the prompt and why certain information was included. - - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. - - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. + - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). + - Explain the structure of the prompt and why certain information was included. + - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. + - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. ==================== END: tasks#generate-ai-frontend-prompt ==================== ==================== START: tasks#create-deep-research-prompt ==================== @@ -360,53 +360,65 @@ Present these numbered options to the user: ```markdown ## Research Objective + [Clear statement of what this research aims to achieve] ## Background Context + [Relevant information from project brief, brainstorming, or other inputs] ## Research Questions ### Primary Questions (Must Answer) + 1. [Specific, actionable question] 2. [Specific, actionable question] -... + ... ### Secondary Questions (Nice to Have) + 1. [Supporting question] 2. [Supporting question] -... + ... ## Research Methodology ### Information Sources + - [Specific source types and priorities] ### Analysis Frameworks + - [Specific frameworks to apply] ### Data Requirements + - [Quality, recency, credibility needs] ## Expected Deliverables ### Executive Summary + - Key findings and insights - Critical implications - Recommended actions ### Detailed Analysis + [Specific sections needed based on research type] ### Supporting Materials + - Data tables - Comparison matrices - Source documentation ## Success Criteria + [How to evaluate if research achieved its objectives] ## Timeline and Priority + [If applicable, any time constraints or phasing] ``` diff --git a/.bmad-core/web-bundles/teams/team-all.txt b/.bmad-core/web-bundles/teams/team-all.txt index 60d7eec4..5dffb82f 100644 --- a/.bmad-core/web-bundles/teams/team-all.txt +++ b/.bmad-core/web-bundles/teams/team-all.txt @@ -424,25 +424,22 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll ```yml activation-instructions: - - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - - Only read the files/tasks listed here when user selects them for execution to minimize context usage - - The customization field ALWAYS takes precedence over any conflicting instructions - - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - + - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! + - Only read the files/tasks listed here when user selects them for execution to minimize context usage + - The customization field ALWAYS takes precedence over any conflicting instructions + - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute agent: name: Sarah id: po title: Product Owner icon: šŸ“ - whenToUse: "Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions" - customization: - + whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions + customization: null persona: role: Technical Product Owner & Process Steward style: Meticulous, analytical, detail-oriented, systematic, collaborative identity: Product Owner who validates artifacts cohesion and coaches significant changes focus: Plan integrity, documentation quality, actionable development tasks, process adherence - core_principles: - Guardian of Quality & Completeness - Ensure all artifacts are comprehensive and consistent - Clarity & Actionability for Development - Make requirements unambiguous and testable @@ -454,21 +451,18 @@ persona: - User Collaboration for Validation - Seek input at critical checkpoints - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Documentation Ecosystem Integrity - Maintain consistency across all documents - startup: - Greet the user with your name and role, and inform of the *help command. - commands: - - "*help" - Show: numbered list of the following commands to allow selection - - "*chat-mode" - (Default) Product Owner consultation with advanced-elicitation - - "*create-doc {template}" - Create doc (no template = show available templates) - - "*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist) - - "*shard-doc {document}" - Break down document into actionable parts - - "*correct-course" - Analyze and suggest project course corrections - - "*create-epic" - Create epic for brownfield projects (task brownfield-create-epic) - - "*create-story" - Create user story from requirements (task brownfield-create-story) - - "*exit" - Say Goodbye, You are no longer this Agent - + - '*help" - Show: numbered list of the following commands to allow selection' + - '*chat-mode" - (Default) Product Owner consultation with advanced-elicitation' + - '*create-doc {template}" - Create doc (no template = show available templates)' + - '*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist)' + - '*shard-doc {document}" - Break down document into actionable parts' + - '*correct-course" - Analyze and suggest project course corrections' + - '*create-epic" - Create epic for brownfield projects (task brownfield-create-epic)' + - '*create-story" - Create user story from requirements (task brownfield-create-story)' + - '*exit" - Say Goodbye, You are no longer this Agent' dependencies: tasks: - execute-checklist @@ -2017,6 +2011,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Begin by understanding the brainstorming context and goals. Ask clarifying questions if needed to determine the best approach.]] 1. **Establish Context** + - Understand the problem space or opportunity area - Identify any constraints or parameters - Determine session goals (divergent exploration vs. focused ideation) @@ -2033,6 +2028,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"What If" Scenarios** [[LLM: Generate provocative what-if questions that challenge assumptions and expand thinking beyond current limitations.]] + - What if we had unlimited resources? - What if this problem didn't exist? - What if we approached this from a child's perspective? @@ -2040,6 +2036,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Analogical Thinking** [[LLM: Help user draw parallels between their challenge and other domains, industries, or natural systems.]] + - "How might this work like [X] but for [Y]?" - Nature-inspired solutions (biomimicry) - Cross-industry pattern matching @@ -2047,6 +2044,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 3. **Reversal/Inversion** [[LLM: Flip the problem or approach it from the opposite angle to reveal new insights.]] + - What if we did the exact opposite? - How could we make this problem worse? (then reverse) - Start from the end goal and work backward @@ -2063,6 +2061,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **SCAMPER Method** [[LLM: Guide through each SCAMPER prompt systematically.]] + - **S** = Substitute: What can be substituted? - **C** = Combine: What can be combined or integrated? - **A** = Adapt: What can be adapted from elsewhere? @@ -2073,6 +2072,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Six Thinking Hats** [[LLM: Cycle through different thinking modes, spending focused time in each.]] + - White Hat: Facts and information - Red Hat: Emotions and intuition - Black Hat: Caution and critical thinking @@ -2099,6 +2099,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"Yes, And..." Building** [[LLM: Accept every idea and build upon it without judgment. Encourage wild ideas and defer criticism.]] + - Accept the premise of each idea - Add to it with "Yes, and..." - Build chains of connected ideas @@ -2106,40 +2107,43 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Brainwriting/Round Robin** [[LLM: Simulate multiple perspectives by generating ideas from different viewpoints.]] + - Generate ideas from stakeholder perspectives - Build on previous ideas in rounds - Combine unrelated ideas - Cross-pollinate concepts 3. **Random Stimulation** - [[LLM: Use random words, images, or concepts as creative triggers.]] - - Random word association - - Picture/metaphor inspiration - - Forced connections between unrelated items - - Constraint-based creativity + [[LLM: Use random words, images, or concepts as creative triggers.]] + - Random word association + - Picture/metaphor inspiration + - Forced connections between unrelated items + - Constraint-based creativity #### Deep Exploration Techniques 1. **Five Whys** - [[LLM: Dig deeper into root causes and underlying motivations.]] - - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) - - Uncover hidden assumptions - - Find root causes, not symptoms - - Identify intervention points + [[LLM: Dig deeper into root causes and underlying motivations.]] + + - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) + - Uncover hidden assumptions + - Find root causes, not symptoms + - Identify intervention points 2. **Morphological Analysis** - [[LLM: Break down into parameters and systematically explore combinations.]] - - List key parameters/dimensions - - Identify possible values for each - - Create combination matrix - - Explore unusual combinations + [[LLM: Break down into parameters and systematically explore combinations.]] + + - List key parameters/dimensions + - Identify possible values for each + - Create combination matrix + - Explore unusual combinations 3. **Provocation Technique (PO)** - [[LLM: Make deliberately provocative statements to jar thinking.]] - - PO: Cars have square wheels - - PO: Customers pay us to take products - - PO: The problem solves itself - - Extract useful ideas from provocations + [[LLM: Make deliberately provocative statements to jar thinking.]] + - PO: Cars have square wheels + - PO: Customers pay us to take products + - PO: The problem solves itself + - Extract useful ideas from provocations ### 3. Technique Selection Guide @@ -2180,16 +2184,19 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Guide the brainstorming session with appropriate pacing and technique transitions.]] 1. **Warm-up Phase** (5-10 min) + - Start with accessible techniques - Build creative confidence - Establish "no judgment" atmosphere 2. **Divergent Phase** (20-30 min) + - Use expansion techniques - Generate quantity over quality - Encourage wild ideas 3. **Convergent Phase** (15-20 min) + - Group and categorize ideas - Identify patterns and themes - Select promising directions @@ -2425,53 +2432,65 @@ Present these numbered options to the user: ```markdown ## Research Objective + [Clear statement of what this research aims to achieve] ## Background Context + [Relevant information from project brief, brainstorming, or other inputs] ## Research Questions ### Primary Questions (Must Answer) + 1. [Specific, actionable question] 2. [Specific, actionable question] -... + ... ### Secondary Questions (Nice to Have) + 1. [Supporting question] 2. [Supporting question] -... + ... ## Research Methodology ### Information Sources + - [Specific source types and priorities] ### Analysis Frameworks + - [Specific frameworks to apply] ### Data Requirements + - [Quality, recency, credibility needs] ## Expected Deliverables ### Executive Summary + - Key findings and insights - Critical implications - Recommended actions ### Detailed Analysis + [Specific sections needed based on research type] ### Supporting Materials + - Data tables - Comparison matrices - Source documentation ## Success Criteria + [How to evaluate if research achieved its objectives] ## Timeline and Priority + [If applicable, any time constraints or phasing] ``` @@ -6350,28 +6369,33 @@ Ask the user if they want to work through the checklist: Now that you've completed the checklist, generate a comprehensive validation report that includes: 1. Executive Summary + - Overall architecture readiness (High/Medium/Low) - Critical risks identified - Key strengths of the architecture - Project type (Full-stack/Frontend/Backend) and sections evaluated 2. Section Analysis + - Pass rate for each major section (percentage of items passed) - Most concerning failures or gaps - Sections requiring immediate attention - Note any sections skipped due to project type 3. Risk Assessment + - Top 5 risks by severity - Mitigation recommendations for each - Timeline impact of addressing issues 4. Recommendations + - Must-fix items before development - Should-fix items for better quality - Nice-to-have improvements 5. AI Implementation Readiness + - Specific concerns for AI agent implementation - Areas needing additional clarification - Complexity hotspots to address @@ -8963,47 +8987,47 @@ To generate a masterful, comprehensive, and optimized prompt that can be used wi 1. **Confirm Target AI Generation Platform:** - - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). - - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. + - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). + - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. 2. **Synthesize Inputs into a Structured Prompt:** - - **Overall Project Context:** - - Briefly state the project's purpose (from brief/PRD). - - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). - - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). - - **Design System & Visuals:** - - Reference the primary design files (e.g., Figma link). - - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). - - List any global UI components or design tokens that should be defined or adhered to. - - **Application Structure & Routing:** - - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). - - Outline the navigation structure (from `front-end-spec-tmpl`). - - **Key User Flows & Page-Level Interactions:** - - For a few critical user flows (from `front-end-spec-tmpl`): - - Describe the sequence of user actions and expected UI changes on each relevant page. - - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. - - **Component Generation Instructions (Iterative or Key Components):** - - Based on the chosen AI tool's capabilities, decide on a strategy: - - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. - - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). - - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. - - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. - - **State Management (High-Level Pointers):** - - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). - - For key pieces of data, indicate if they should be managed in global state. - - **API Integration Points:** - - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). - - **Critical "Don'ts" or Constraints:** - - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." - - **Platform-Specific Optimizations:** - - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). + - **Overall Project Context:** + - Briefly state the project's purpose (from brief/PRD). + - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). + - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). + - **Design System & Visuals:** + - Reference the primary design files (e.g., Figma link). + - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). + - List any global UI components or design tokens that should be defined or adhered to. + - **Application Structure & Routing:** + - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). + - Outline the navigation structure (from `front-end-spec-tmpl`). + - **Key User Flows & Page-Level Interactions:** + - For a few critical user flows (from `front-end-spec-tmpl`): + - Describe the sequence of user actions and expected UI changes on each relevant page. + - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. + - **Component Generation Instructions (Iterative or Key Components):** + - Based on the chosen AI tool's capabilities, decide on a strategy: + - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. + - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). + - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. + - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. + - **State Management (High-Level Pointers):** + - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). + - For key pieces of data, indicate if they should be managed in global state. + - **API Integration Points:** + - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). + - **Critical "Don'ts" or Constraints:** + - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." + - **Platform-Specific Optimizations:** + - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). 3. **Present and Refine the Master Prompt:** - - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). - - Explain the structure of the prompt and why certain information was included. - - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. - - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. + - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). + - Explain the structure of the prompt and why certain information was included. + - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. + - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. ==================== END: tasks#generate-ai-frontend-prompt ==================== ==================== START: templates#front-end-spec-tmpl ==================== diff --git a/.bmad-core/web-bundles/teams/team-fullstack.txt b/.bmad-core/web-bundles/teams/team-fullstack.txt index 61ad465b..e11e5549 100644 --- a/.bmad-core/web-bundles/teams/team-fullstack.txt +++ b/.bmad-core/web-bundles/teams/team-fullstack.txt @@ -431,25 +431,22 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll ```yml activation-instructions: - - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - - Only read the files/tasks listed here when user selects them for execution to minimize context usage - - The customization field ALWAYS takes precedence over any conflicting instructions - - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - + - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! + - Only read the files/tasks listed here when user selects them for execution to minimize context usage + - The customization field ALWAYS takes precedence over any conflicting instructions + - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute agent: name: Sarah id: po title: Product Owner icon: šŸ“ - whenToUse: "Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions" - customization: - + whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions + customization: null persona: role: Technical Product Owner & Process Steward style: Meticulous, analytical, detail-oriented, systematic, collaborative identity: Product Owner who validates artifacts cohesion and coaches significant changes focus: Plan integrity, documentation quality, actionable development tasks, process adherence - core_principles: - Guardian of Quality & Completeness - Ensure all artifacts are comprehensive and consistent - Clarity & Actionability for Development - Make requirements unambiguous and testable @@ -461,21 +458,18 @@ persona: - User Collaboration for Validation - Seek input at critical checkpoints - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Documentation Ecosystem Integrity - Maintain consistency across all documents - startup: - Greet the user with your name and role, and inform of the *help command. - commands: - - "*help" - Show: numbered list of the following commands to allow selection - - "*chat-mode" - (Default) Product Owner consultation with advanced-elicitation - - "*create-doc {template}" - Create doc (no template = show available templates) - - "*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist) - - "*shard-doc {document}" - Break down document into actionable parts - - "*correct-course" - Analyze and suggest project course corrections - - "*create-epic" - Create epic for brownfield projects (task brownfield-create-epic) - - "*create-story" - Create user story from requirements (task brownfield-create-story) - - "*exit" - Say Goodbye, You are no longer this Agent - + - '*help" - Show: numbered list of the following commands to allow selection' + - '*chat-mode" - (Default) Product Owner consultation with advanced-elicitation' + - '*create-doc {template}" - Create doc (no template = show available templates)' + - '*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist)' + - '*shard-doc {document}" - Break down document into actionable parts' + - '*correct-course" - Analyze and suggest project course corrections' + - '*create-epic" - Create epic for brownfield projects (task brownfield-create-epic)' + - '*create-story" - Create user story from requirements (task brownfield-create-story)' + - '*exit" - Say Goodbye, You are no longer this Agent' dependencies: tasks: - execute-checklist @@ -1837,6 +1831,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Begin by understanding the brainstorming context and goals. Ask clarifying questions if needed to determine the best approach.]] 1. **Establish Context** + - Understand the problem space or opportunity area - Identify any constraints or parameters - Determine session goals (divergent exploration vs. focused ideation) @@ -1853,6 +1848,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"What If" Scenarios** [[LLM: Generate provocative what-if questions that challenge assumptions and expand thinking beyond current limitations.]] + - What if we had unlimited resources? - What if this problem didn't exist? - What if we approached this from a child's perspective? @@ -1860,6 +1856,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Analogical Thinking** [[LLM: Help user draw parallels between their challenge and other domains, industries, or natural systems.]] + - "How might this work like [X] but for [Y]?" - Nature-inspired solutions (biomimicry) - Cross-industry pattern matching @@ -1867,6 +1864,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 3. **Reversal/Inversion** [[LLM: Flip the problem or approach it from the opposite angle to reveal new insights.]] + - What if we did the exact opposite? - How could we make this problem worse? (then reverse) - Start from the end goal and work backward @@ -1883,6 +1881,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **SCAMPER Method** [[LLM: Guide through each SCAMPER prompt systematically.]] + - **S** = Substitute: What can be substituted? - **C** = Combine: What can be combined or integrated? - **A** = Adapt: What can be adapted from elsewhere? @@ -1893,6 +1892,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Six Thinking Hats** [[LLM: Cycle through different thinking modes, spending focused time in each.]] + - White Hat: Facts and information - Red Hat: Emotions and intuition - Black Hat: Caution and critical thinking @@ -1919,6 +1919,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"Yes, And..." Building** [[LLM: Accept every idea and build upon it without judgment. Encourage wild ideas and defer criticism.]] + - Accept the premise of each idea - Add to it with "Yes, and..." - Build chains of connected ideas @@ -1926,40 +1927,43 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Brainwriting/Round Robin** [[LLM: Simulate multiple perspectives by generating ideas from different viewpoints.]] + - Generate ideas from stakeholder perspectives - Build on previous ideas in rounds - Combine unrelated ideas - Cross-pollinate concepts 3. **Random Stimulation** - [[LLM: Use random words, images, or concepts as creative triggers.]] - - Random word association - - Picture/metaphor inspiration - - Forced connections between unrelated items - - Constraint-based creativity + [[LLM: Use random words, images, or concepts as creative triggers.]] + - Random word association + - Picture/metaphor inspiration + - Forced connections between unrelated items + - Constraint-based creativity #### Deep Exploration Techniques 1. **Five Whys** - [[LLM: Dig deeper into root causes and underlying motivations.]] - - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) - - Uncover hidden assumptions - - Find root causes, not symptoms - - Identify intervention points + [[LLM: Dig deeper into root causes and underlying motivations.]] + + - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) + - Uncover hidden assumptions + - Find root causes, not symptoms + - Identify intervention points 2. **Morphological Analysis** - [[LLM: Break down into parameters and systematically explore combinations.]] - - List key parameters/dimensions - - Identify possible values for each - - Create combination matrix - - Explore unusual combinations + [[LLM: Break down into parameters and systematically explore combinations.]] + + - List key parameters/dimensions + - Identify possible values for each + - Create combination matrix + - Explore unusual combinations 3. **Provocation Technique (PO)** - [[LLM: Make deliberately provocative statements to jar thinking.]] - - PO: Cars have square wheels - - PO: Customers pay us to take products - - PO: The problem solves itself - - Extract useful ideas from provocations + [[LLM: Make deliberately provocative statements to jar thinking.]] + - PO: Cars have square wheels + - PO: Customers pay us to take products + - PO: The problem solves itself + - Extract useful ideas from provocations ### 3. Technique Selection Guide @@ -2000,16 +2004,19 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Guide the brainstorming session with appropriate pacing and technique transitions.]] 1. **Warm-up Phase** (5-10 min) + - Start with accessible techniques - Build creative confidence - Establish "no judgment" atmosphere 2. **Divergent Phase** (20-30 min) + - Use expansion techniques - Generate quantity over quality - Encourage wild ideas 3. **Convergent Phase** (15-20 min) + - Group and categorize ideas - Identify patterns and themes - Select promising directions @@ -2245,53 +2252,65 @@ Present these numbered options to the user: ```markdown ## Research Objective + [Clear statement of what this research aims to achieve] ## Background Context + [Relevant information from project brief, brainstorming, or other inputs] ## Research Questions ### Primary Questions (Must Answer) + 1. [Specific, actionable question] 2. [Specific, actionable question] -... + ... ### Secondary Questions (Nice to Have) + 1. [Supporting question] 2. [Supporting question] -... + ... ## Research Methodology ### Information Sources + - [Specific source types and priorities] ### Analysis Frameworks + - [Specific frameworks to apply] ### Data Requirements + - [Quality, recency, credibility needs] ## Expected Deliverables ### Executive Summary + - Key findings and insights - Critical implications - Recommended actions ### Detailed Analysis + [Specific sections needed based on research type] ### Supporting Materials + - Data tables - Comparison matrices - Source documentation ## Success Criteria + [How to evaluate if research achieved its objectives] ## Timeline and Priority + [If applicable, any time constraints or phasing] ``` @@ -4830,47 +4849,47 @@ To generate a masterful, comprehensive, and optimized prompt that can be used wi 1. **Confirm Target AI Generation Platform:** - - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). - - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. + - Ask the user to specify which AI frontend generation tool/platform they intend to use (e.g., "Lovable.ai", "Vercel v0", "GPT-4 with direct code generation instructions", etc.). + - Explain that prompt optimization might differ slightly based on the platform's capabilities and preferred input format. 2. **Synthesize Inputs into a Structured Prompt:** - - **Overall Project Context:** - - Briefly state the project's purpose (from brief/PRD). - - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). - - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). - - **Design System & Visuals:** - - Reference the primary design files (e.g., Figma link). - - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). - - List any global UI components or design tokens that should be defined or adhered to. - - **Application Structure & Routing:** - - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). - - Outline the navigation structure (from `front-end-spec-tmpl`). - - **Key User Flows & Page-Level Interactions:** - - For a few critical user flows (from `front-end-spec-tmpl`): - - Describe the sequence of user actions and expected UI changes on each relevant page. - - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. - - **Component Generation Instructions (Iterative or Key Components):** - - Based on the chosen AI tool's capabilities, decide on a strategy: - - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. - - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). - - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. - - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. - - **State Management (High-Level Pointers):** - - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). - - For key pieces of data, indicate if they should be managed in global state. - - **API Integration Points:** - - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). - - **Critical "Don'ts" or Constraints:** - - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." - - **Platform-Specific Optimizations:** - - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). + - **Overall Project Context:** + - Briefly state the project's purpose (from brief/PRD). + - Specify the chosen frontend framework, core libraries, and UI component library (from `front-end-architecture` and main `architecture`). + - Mention the styling approach (e.g., Tailwind CSS, CSS Modules). + - **Design System & Visuals:** + - Reference the primary design files (e.g., Figma link). + - If the tool doesn't directly ingest design files, describe the overall visual style, color palette, typography, and key branding elements (from `front-end-spec-tmpl`). + - List any global UI components or design tokens that should be defined or adhered to. + - **Application Structure & Routing:** + - Describe the main pages/views and their routes (from `front-end-architecture` - Routing Strategy). + - Outline the navigation structure (from `front-end-spec-tmpl`). + - **Key User Flows & Page-Level Interactions:** + - For a few critical user flows (from `front-end-spec-tmpl`): + - Describe the sequence of user actions and expected UI changes on each relevant page. + - Specify API calls to be made (referencing API endpoints from the main `architecture`) and how data should be displayed or used. + - **Component Generation Instructions (Iterative or Key Components):** + - Based on the chosen AI tool's capabilities, decide on a strategy: + - **Option 1 (Scaffolding):** Prompt for the generation of main page structures, layouts, and placeholders for components. + - **Option 2 (Key Component Generation):** Select a few critical or complex components from the `front-end-architecture` (Component Breakdown) and provide detailed specifications for them (props, state, basic behavior, key UI elements). + - **Option 3 (Holistic, if tool supports):** Attempt to describe the entire application structure and key components more broadly. + - Advise the user that generating an entire complex application perfectly in one go is rare. Iterative prompting or focusing on sections/key components is often more effective. + - **State Management (High-Level Pointers):** + - Mention the chosen state management solution (e.g., "Use Redux Toolkit"). + - For key pieces of data, indicate if they should be managed in global state. + - **API Integration Points:** + - For pages/components that fetch or submit data, clearly state the relevant API endpoints (from `architecture`) and the expected data shapes (can reference schemas in `data-models` or `api-reference` sections of the architecture doc). + - **Critical "Don'ts" or Constraints:** + - e.g., "Do not use deprecated libraries." "Ensure all forms have basic client-side validation." + - **Platform-Specific Optimizations:** + - If the chosen AI tool has known best practices for prompting (e.g., specific keywords, structure, level of detail), incorporate them. (This might require the agent to have some general knowledge or to ask the user if they know any such specific prompt modifiers for their chosen tool). 3. **Present and Refine the Master Prompt:** - - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). - - Explain the structure of the prompt and why certain information was included. - - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. - - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. + - Output the generated prompt in a clear, copy-pasteable format (e.g., a large code block). + - Explain the structure of the prompt and why certain information was included. + - Work with the user to refine the prompt based on their knowledge of the target AI tool and any specific nuances they want to emphasize. + - Remind the user that the generated code from the AI tool will likely require review, testing, and further refinement by developers. ==================== END: tasks#generate-ai-frontend-prompt ==================== ==================== START: templates#front-end-spec-tmpl ==================== @@ -8225,28 +8244,33 @@ Ask the user if they want to work through the checklist: Now that you've completed the checklist, generate a comprehensive validation report that includes: 1. Executive Summary + - Overall architecture readiness (High/Medium/Low) - Critical risks identified - Key strengths of the architecture - Project type (Full-stack/Frontend/Backend) and sections evaluated 2. Section Analysis + - Pass rate for each major section (percentage of items passed) - Most concerning failures or gaps - Sections requiring immediate attention - Note any sections skipped due to project type 3. Risk Assessment + - Top 5 risks by severity - Mitigation recommendations for each - Timeline impact of addressing issues 4. Recommendations + - Must-fix items before development - Should-fix items for better quality - Nice-to-have improvements 5. AI Implementation Readiness + - Specific concerns for AI agent implementation - Areas needing additional clarification - Complexity hotspots to address diff --git a/.bmad-core/web-bundles/teams/team-no-ui.txt b/.bmad-core/web-bundles/teams/team-no-ui.txt index 625bef97..0a302df8 100644 --- a/.bmad-core/web-bundles/teams/team-no-ui.txt +++ b/.bmad-core/web-bundles/teams/team-no-ui.txt @@ -351,25 +351,22 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll ```yml activation-instructions: - - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - - Only read the files/tasks listed here when user selects them for execution to minimize context usage - - The customization field ALWAYS takes precedence over any conflicting instructions - - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - + - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! + - Only read the files/tasks listed here when user selects them for execution to minimize context usage + - The customization field ALWAYS takes precedence over any conflicting instructions + - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute agent: name: Sarah id: po title: Product Owner icon: šŸ“ - whenToUse: "Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions" - customization: - + whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions + customization: null persona: role: Technical Product Owner & Process Steward style: Meticulous, analytical, detail-oriented, systematic, collaborative identity: Product Owner who validates artifacts cohesion and coaches significant changes focus: Plan integrity, documentation quality, actionable development tasks, process adherence - core_principles: - Guardian of Quality & Completeness - Ensure all artifacts are comprehensive and consistent - Clarity & Actionability for Development - Make requirements unambiguous and testable @@ -381,21 +378,18 @@ persona: - User Collaboration for Validation - Seek input at critical checkpoints - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Documentation Ecosystem Integrity - Maintain consistency across all documents - startup: - Greet the user with your name and role, and inform of the *help command. - commands: - - "*help" - Show: numbered list of the following commands to allow selection - - "*chat-mode" - (Default) Product Owner consultation with advanced-elicitation - - "*create-doc {template}" - Create doc (no template = show available templates) - - "*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist) - - "*shard-doc {document}" - Break down document into actionable parts - - "*correct-course" - Analyze and suggest project course corrections - - "*create-epic" - Create epic for brownfield projects (task brownfield-create-epic) - - "*create-story" - Create user story from requirements (task brownfield-create-story) - - "*exit" - Say Goodbye, You are no longer this Agent - + - '*help" - Show: numbered list of the following commands to allow selection' + - '*chat-mode" - (Default) Product Owner consultation with advanced-elicitation' + - '*create-doc {template}" - Create doc (no template = show available templates)' + - '*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist)' + - '*shard-doc {document}" - Break down document into actionable parts' + - '*correct-course" - Analyze and suggest project course corrections' + - '*create-epic" - Create epic for brownfield projects (task brownfield-create-epic)' + - '*create-story" - Create user story from requirements (task brownfield-create-story)' + - '*exit" - Say Goodbye, You are no longer this Agent' dependencies: tasks: - execute-checklist @@ -1757,6 +1751,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Begin by understanding the brainstorming context and goals. Ask clarifying questions if needed to determine the best approach.]] 1. **Establish Context** + - Understand the problem space or opportunity area - Identify any constraints or parameters - Determine session goals (divergent exploration vs. focused ideation) @@ -1773,6 +1768,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"What If" Scenarios** [[LLM: Generate provocative what-if questions that challenge assumptions and expand thinking beyond current limitations.]] + - What if we had unlimited resources? - What if this problem didn't exist? - What if we approached this from a child's perspective? @@ -1780,6 +1776,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Analogical Thinking** [[LLM: Help user draw parallels between their challenge and other domains, industries, or natural systems.]] + - "How might this work like [X] but for [Y]?" - Nature-inspired solutions (biomimicry) - Cross-industry pattern matching @@ -1787,6 +1784,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 3. **Reversal/Inversion** [[LLM: Flip the problem or approach it from the opposite angle to reveal new insights.]] + - What if we did the exact opposite? - How could we make this problem worse? (then reverse) - Start from the end goal and work backward @@ -1803,6 +1801,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **SCAMPER Method** [[LLM: Guide through each SCAMPER prompt systematically.]] + - **S** = Substitute: What can be substituted? - **C** = Combine: What can be combined or integrated? - **A** = Adapt: What can be adapted from elsewhere? @@ -1813,6 +1812,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Six Thinking Hats** [[LLM: Cycle through different thinking modes, spending focused time in each.]] + - White Hat: Facts and information - Red Hat: Emotions and intuition - Black Hat: Caution and critical thinking @@ -1839,6 +1839,7 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 1. **"Yes, And..." Building** [[LLM: Accept every idea and build upon it without judgment. Encourage wild ideas and defer criticism.]] + - Accept the premise of each idea - Add to it with "Yes, and..." - Build chains of connected ideas @@ -1846,40 +1847,43 @@ This task provides a comprehensive toolkit of creative brainstorming techniques 2. **Brainwriting/Round Robin** [[LLM: Simulate multiple perspectives by generating ideas from different viewpoints.]] + - Generate ideas from stakeholder perspectives - Build on previous ideas in rounds - Combine unrelated ideas - Cross-pollinate concepts 3. **Random Stimulation** - [[LLM: Use random words, images, or concepts as creative triggers.]] - - Random word association - - Picture/metaphor inspiration - - Forced connections between unrelated items - - Constraint-based creativity + [[LLM: Use random words, images, or concepts as creative triggers.]] + - Random word association + - Picture/metaphor inspiration + - Forced connections between unrelated items + - Constraint-based creativity #### Deep Exploration Techniques 1. **Five Whys** - [[LLM: Dig deeper into root causes and underlying motivations.]] - - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) - - Uncover hidden assumptions - - Find root causes, not symptoms - - Identify intervention points + [[LLM: Dig deeper into root causes and underlying motivations.]] + + - Why does this problem exist? ā†’ Answer ā†’ Why? (repeat 5 times) + - Uncover hidden assumptions + - Find root causes, not symptoms + - Identify intervention points 2. **Morphological Analysis** - [[LLM: Break down into parameters and systematically explore combinations.]] - - List key parameters/dimensions - - Identify possible values for each - - Create combination matrix - - Explore unusual combinations + [[LLM: Break down into parameters and systematically explore combinations.]] + + - List key parameters/dimensions + - Identify possible values for each + - Create combination matrix + - Explore unusual combinations 3. **Provocation Technique (PO)** - [[LLM: Make deliberately provocative statements to jar thinking.]] - - PO: Cars have square wheels - - PO: Customers pay us to take products - - PO: The problem solves itself - - Extract useful ideas from provocations + [[LLM: Make deliberately provocative statements to jar thinking.]] + - PO: Cars have square wheels + - PO: Customers pay us to take products + - PO: The problem solves itself + - Extract useful ideas from provocations ### 3. Technique Selection Guide @@ -1920,16 +1924,19 @@ This task provides a comprehensive toolkit of creative brainstorming techniques [[LLM: Guide the brainstorming session with appropriate pacing and technique transitions.]] 1. **Warm-up Phase** (5-10 min) + - Start with accessible techniques - Build creative confidence - Establish "no judgment" atmosphere 2. **Divergent Phase** (20-30 min) + - Use expansion techniques - Generate quantity over quality - Encourage wild ideas 3. **Convergent Phase** (15-20 min) + - Group and categorize ideas - Identify patterns and themes - Select promising directions @@ -2165,53 +2172,65 @@ Present these numbered options to the user: ```markdown ## Research Objective + [Clear statement of what this research aims to achieve] ## Background Context + [Relevant information from project brief, brainstorming, or other inputs] ## Research Questions ### Primary Questions (Must Answer) + 1. [Specific, actionable question] 2. [Specific, actionable question] -... + ... ### Secondary Questions (Nice to Have) + 1. [Supporting question] 2. [Supporting question] -... + ... ## Research Methodology ### Information Sources + - [Specific source types and priorities] ### Analysis Frameworks + - [Specific frameworks to apply] ### Data Requirements + - [Quality, recency, credibility needs] ## Expected Deliverables ### Executive Summary + - Key findings and insights - Critical implications - Recommended actions ### Detailed Analysis + [Specific sections needed based on research type] ### Supporting Materials + - Data tables - Comparison matrices - Source documentation ## Success Criteria + [How to evaluate if research achieved its objectives] ## Timeline and Priority + [If applicable, any time constraints or phasing] ``` @@ -7670,28 +7689,33 @@ Ask the user if they want to work through the checklist: Now that you've completed the checklist, generate a comprehensive validation report that includes: 1. Executive Summary + - Overall architecture readiness (High/Medium/Low) - Critical risks identified - Key strengths of the architecture - Project type (Full-stack/Frontend/Backend) and sections evaluated 2. Section Analysis + - Pass rate for each major section (percentage of items passed) - Most concerning failures or gaps - Sections requiring immediate attention - Note any sections skipped due to project type 3. Risk Assessment + - Top 5 risks by severity - Mitigation recommendations for each - Timeline impact of addressing issues 4. Recommendations + - Must-fix items before development - Should-fix items for better quality - Nice-to-have improvements 5. AI Implementation Readiness + - Specific concerns for AI agent implementation - Areas needing additional clarification - Complexity hotspots to address diff --git a/.claude/commands/po.md b/.claude/commands/po.md index 07466ef7..194333cf 100644 --- a/.claude/commands/po.md +++ b/.claude/commands/po.md @@ -8,25 +8,22 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll ```yml activation-instructions: - - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - - Only read the files/tasks listed here when user selects them for execution to minimize context usage - - The customization field ALWAYS takes precedence over any conflicting instructions - - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - + - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! + - Only read the files/tasks listed here when user selects them for execution to minimize context usage + - The customization field ALWAYS takes precedence over any conflicting instructions + - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute agent: name: Sarah id: po title: Product Owner icon: šŸ“ - whenToUse: "Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions" - customization: - + whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions + customization: null persona: role: Technical Product Owner & Process Steward style: Meticulous, analytical, detail-oriented, systematic, collaborative identity: Product Owner who validates artifacts cohesion and coaches significant changes focus: Plan integrity, documentation quality, actionable development tasks, process adherence - core_principles: - Guardian of Quality & Completeness - Ensure all artifacts are comprehensive and consistent - Clarity & Actionability for Development - Make requirements unambiguous and testable @@ -38,21 +35,18 @@ persona: - User Collaboration for Validation - Seek input at critical checkpoints - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Documentation Ecosystem Integrity - Maintain consistency across all documents - startup: - Greet the user with your name and role, and inform of the *help command. - commands: - - "*help" - Show: numbered list of the following commands to allow selection - - "*chat-mode" - (Default) Product Owner consultation with advanced-elicitation - - "*create-doc {template}" - Create doc (no template = show available templates) - - "*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist) - - "*shard-doc {document}" - Break down document into actionable parts - - "*correct-course" - Analyze and suggest project course corrections - - "*create-epic" - Create epic for brownfield projects (task brownfield-create-epic) - - "*create-story" - Create user story from requirements (task brownfield-create-story) - - "*exit" - Say Goodbye, You are no longer this Agent - + - '*help" - Show: numbered list of the following commands to allow selection' + - '*chat-mode" - (Default) Product Owner consultation with advanced-elicitation' + - '*create-doc {template}" - Create doc (no template = show available templates)' + - '*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist)' + - '*shard-doc {document}" - Break down document into actionable parts' + - '*correct-course" - Analyze and suggest project course corrections' + - '*create-epic" - Create epic for brownfield projects (task brownfield-create-epic)' + - '*create-story" - Create user story from requirements (task brownfield-create-story)' + - '*exit" - Say Goodbye, You are no longer this Agent' dependencies: tasks: - execute-checklist diff --git a/.cursor/rules/po.mdc b/.cursor/rules/po.mdc index af6641f0..010469cd 100644 --- a/.cursor/rules/po.mdc +++ b/.cursor/rules/po.mdc @@ -14,25 +14,22 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll ```yml activation-instructions: - - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - - Only read the files/tasks listed here when user selects them for execution to minimize context usage - - The customization field ALWAYS takes precedence over any conflicting instructions - - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - + - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! + - Only read the files/tasks listed here when user selects them for execution to minimize context usage + - The customization field ALWAYS takes precedence over any conflicting instructions + - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute agent: name: Sarah id: po title: Product Owner icon: šŸ“ - whenToUse: "Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions" - customization: - + whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions + customization: null persona: role: Technical Product Owner & Process Steward style: Meticulous, analytical, detail-oriented, systematic, collaborative identity: Product Owner who validates artifacts cohesion and coaches significant changes focus: Plan integrity, documentation quality, actionable development tasks, process adherence - core_principles: - Guardian of Quality & Completeness - Ensure all artifacts are comprehensive and consistent - Clarity & Actionability for Development - Make requirements unambiguous and testable @@ -44,21 +41,18 @@ persona: - User Collaboration for Validation - Seek input at critical checkpoints - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Documentation Ecosystem Integrity - Maintain consistency across all documents - startup: - Greet the user with your name and role, and inform of the *help command. - commands: - - "*help" - Show: numbered list of the following commands to allow selection - - "*chat-mode" - (Default) Product Owner consultation with advanced-elicitation - - "*create-doc {template}" - Create doc (no template = show available templates) - - "*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist) - - "*shard-doc {document}" - Break down document into actionable parts - - "*correct-course" - Analyze and suggest project course corrections - - "*create-epic" - Create epic for brownfield projects (task brownfield-create-epic) - - "*create-story" - Create user story from requirements (task brownfield-create-story) - - "*exit" - Say Goodbye, You are no longer this Agent - + - '*help" - Show: numbered list of the following commands to allow selection' + - '*chat-mode" - (Default) Product Owner consultation with advanced-elicitation' + - '*create-doc {template}" - Create doc (no template = show available templates)' + - '*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist)' + - '*shard-doc {document}" - Break down document into actionable parts' + - '*correct-course" - Analyze and suggest project course corrections' + - '*create-epic" - Create epic for brownfield projects (task brownfield-create-epic)' + - '*create-story" - Create user story from requirements (task brownfield-create-story)' + - '*exit" - Say Goodbye, You are no longer this Agent' dependencies: tasks: - execute-checklist diff --git a/.husky/pre-commit b/.husky/pre-commit new file mode 100755 index 00000000..10adfe3f --- /dev/null +++ b/.husky/pre-commit @@ -0,0 +1,5 @@ +#!/usr/bin/env sh +. "$(dirname -- "$0")/_/husky.sh" + +# Run lint-staged to format and lint YAML files +npx lint-staged diff --git a/.roo/.roomodes b/.roo/.roomodes index 1f4e76ac..7bd594ae 100644 --- a/.roo/.roomodes +++ b/.roo/.roomodes @@ -1,95 +1,95 @@ customModes: - - slug: bmad-analyst - name: 'šŸ“Š Business Analyst' - roleDefinition: You are a Business Analyst specializing in business analyst tasks and responsibilities. - whenToUse: Use for market research, brainstorming, competitive analysis, creating project briefs, and initial project discovery - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/analyst.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - - edit - - fileRegex: \.(md|txt)$ - description: Documentation and text files - - slug: bmad-architect - name: 'šŸ—ļø Architect' - roleDefinition: You are a Architect specializing in architect tasks and responsibilities. - whenToUse: Use for system design, architecture documents, technology selection, API design, and infrastructure planning - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/architect.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - - edit - - fileRegex: \.(md|txt|yml|yaml|json)$ - description: Architecture docs and configs - - slug: bmad-bmad-master - name: 'šŸ§™ BMAD Master Task Executor' - roleDefinition: You are a BMAD Master Task Executor specializing in bmad master task executor tasks and responsibilities. - whenToUse: Use when you need comprehensive expertise across all domains or rapid context switching between multiple agent capabilities - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/bmad-master.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - edit - - slug: bmad-bmad-orchestrator - name: 'šŸŽ­ BMAD Master Orchestrator' - roleDefinition: You are a BMAD Master Orchestrator specializing in bmad master orchestrator tasks and responsibilities. - whenToUse: Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/bmad-orchestrator.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - edit - - slug: bmad-dev - name: 'šŸ’» Full Stack Developer' - roleDefinition: You are a Full Stack Developer specializing in full stack developer tasks and responsibilities. - whenToUse: Use for code implementation, debugging, refactoring, and development best practices - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/dev.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - edit - - slug: bmad-pm - name: 'šŸ“‹ Product Manager' - roleDefinition: You are a Product Manager specializing in product manager tasks and responsibilities. - whenToUse: Use for creating PRDs, product strategy, feature prioritization, roadmap planning, and stakeholder communication - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/pm.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - - edit - - fileRegex: \.(md|txt)$ - description: Product documentation - - slug: bmad-po - name: 'šŸ“ Product Owner' - roleDefinition: You are a Product Owner specializing in product owner tasks and responsibilities. - whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/po.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - - edit - - fileRegex: \.(md|txt)$ - description: Story and requirement docs - - slug: bmad-qa - name: 'šŸ§Ŗ Quality Assurance Test Architect' - roleDefinition: You are a Quality Assurance Test Architect specializing in quality assurance test architect tasks and responsibilities. - whenToUse: Use for test planning, test case creation, quality assurance, bug reporting, and testing strategy - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/qa.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - - edit - - fileRegex: \.(test|spec)\.(js|ts|jsx|tsx)$|\.md$ - description: Test files and documentation - - slug: bmad-sm - name: 'šŸƒ Scrum Master' - roleDefinition: You are a Scrum Master specializing in scrum master tasks and responsibilities. - whenToUse: Use for story creation, epic management, retrospectives in party-mode, and agile process guidance - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/sm.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - - edit - - fileRegex: \.(md|txt)$ - description: Process and planning docs - - slug: bmad-ux-expert - name: 'šŸŽØ UX Expert' - roleDefinition: You are a UX Expert specializing in ux expert tasks and responsibilities. - whenToUse: Use for UI/UX design, wireframes, prototypes, front-end specifications, and user experience optimization - customInstructions: CRITICAL Read the full YML from .bmad-core/agents/ux-expert.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode - groups: - - read - - - edit - - fileRegex: \.(md|css|scss|html|jsx|tsx)$ - description: Design-related files + - slug: bmad-analyst + name: šŸ“Š Business Analyst + roleDefinition: You are a Business Analyst specializing in business analyst tasks and responsibilities. + whenToUse: Use for market research, brainstorming, competitive analysis, creating project briefs, and initial project discovery + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/analyst.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - - edit + - fileRegex: \.(md|txt)$ + description: Documentation and text files + - slug: bmad-architect + name: šŸ—ļø Architect + roleDefinition: You are a Architect specializing in architect tasks and responsibilities. + whenToUse: Use for system design, architecture documents, technology selection, API design, and infrastructure planning + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/architect.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - - edit + - fileRegex: \.(md|txt|yml|yaml|json)$ + description: Architecture docs and configs + - slug: bmad-bmad-master + name: šŸ§™ BMAD Master Task Executor + roleDefinition: You are a BMAD Master Task Executor specializing in bmad master task executor tasks and responsibilities. + whenToUse: Use when you need comprehensive expertise across all domains or rapid context switching between multiple agent capabilities + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/bmad-master.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - edit + - slug: bmad-bmad-orchestrator + name: šŸŽ­ BMAD Master Orchestrator + roleDefinition: You are a BMAD Master Orchestrator specializing in bmad master orchestrator tasks and responsibilities. + whenToUse: Use for workflow coordination, multi-agent tasks, role switching guidance, and when unsure which specialist to consult + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/bmad-orchestrator.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - edit + - slug: bmad-dev + name: šŸ’» Full Stack Developer + roleDefinition: You are a Full Stack Developer specializing in full stack developer tasks and responsibilities. + whenToUse: Use for code implementation, debugging, refactoring, and development best practices + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/dev.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - edit + - slug: bmad-pm + name: šŸ“‹ Product Manager + roleDefinition: You are a Product Manager specializing in product manager tasks and responsibilities. + whenToUse: Use for creating PRDs, product strategy, feature prioritization, roadmap planning, and stakeholder communication + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/pm.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - - edit + - fileRegex: \.(md|txt)$ + description: Product documentation + - slug: bmad-po + name: šŸ“ Product Owner + roleDefinition: You are a Product Owner specializing in product owner tasks and responsibilities. + whenToUse: Use for Product Owner tasks + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/po.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - - edit + - fileRegex: \.(md|txt)$ + description: Story and requirement docs + - slug: bmad-qa + name: šŸ§Ŗ Quality Assurance Test Architect + roleDefinition: You are a Quality Assurance Test Architect specializing in quality assurance test architect tasks and responsibilities. + whenToUse: Use for test planning, test case creation, quality assurance, bug reporting, and testing strategy + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/qa.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - - edit + - fileRegex: \.(test|spec)\.(js|ts|jsx|tsx)$|\.md$ + description: Test files and documentation + - slug: bmad-sm + name: šŸƒ Scrum Master + roleDefinition: You are a Scrum Master specializing in scrum master tasks and responsibilities. + whenToUse: Use for story creation, epic management, retrospectives in party-mode, and agile process guidance + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/sm.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - - edit + - fileRegex: \.(md|txt)$ + description: Process and planning docs + - slug: bmad-ux-expert + name: šŸŽØ UX Expert + roleDefinition: You are a UX Expert specializing in ux expert tasks and responsibilities. + whenToUse: Use for UI/UX design, wireframes, prototypes, front-end specifications, and user experience optimization + customInstructions: CRITICAL Read the full YML from .bmad-core/agents/ux-expert.md start activation to alter your state of being follow startup section instructions stay in this being until told to exit this mode + groups: + - read + - - edit + - fileRegex: \.(md|css|scss|html|jsx|tsx)$ + description: Design-related files diff --git a/.roo/README.md b/.roo/README.md index bd2dea73..0c56684f 100644 --- a/.roo/README.md +++ b/.roo/README.md @@ -22,6 +22,7 @@ The `.roomodes` file defines all BMAD agents as custom modes using the proper `c ## Usage In Roo Code: + 1. Open the mode selector (usually in the status bar) 2. Select any BMAD agent mode 3. The AI will adopt that agent's personality and expertise @@ -29,6 +30,7 @@ In Roo Code: ## File Permissions Each agent has specific file access permissions: + - **Analysts, PM, PO, SM**: Limited to documentation files (.md, .txt) - **Architect**: Architecture docs and configs (.md, .txt, .yml, .yaml, .json) - **QA**: Test files and documentation diff --git a/.windsurf/rules/po.md b/.windsurf/rules/po.md index 77ff2ad1..ab6df9ae 100644 --- a/.windsurf/rules/po.md +++ b/.windsurf/rules/po.md @@ -8,25 +8,22 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll ```yml activation-instructions: - - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - - Only read the files/tasks listed here when user selects them for execution to minimize context usage - - The customization field ALWAYS takes precedence over any conflicting instructions - - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - + - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! + - Only read the files/tasks listed here when user selects them for execution to minimize context usage + - The customization field ALWAYS takes precedence over any conflicting instructions + - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute agent: name: Sarah id: po title: Product Owner icon: šŸ“ - whenToUse: "Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions" - customization: - + whenToUse: Use for backlog management, story refinement, acceptance criteria, sprint planning, and prioritization decisions + customization: null persona: role: Technical Product Owner & Process Steward style: Meticulous, analytical, detail-oriented, systematic, collaborative identity: Product Owner who validates artifacts cohesion and coaches significant changes focus: Plan integrity, documentation quality, actionable development tasks, process adherence - core_principles: - Guardian of Quality & Completeness - Ensure all artifacts are comprehensive and consistent - Clarity & Actionability for Development - Make requirements unambiguous and testable @@ -38,21 +35,18 @@ persona: - User Collaboration for Validation - Seek input at critical checkpoints - Focus on Executable & Value-Driven Increments - Ensure work aligns with MVP goals - Documentation Ecosystem Integrity - Maintain consistency across all documents - startup: - Greet the user with your name and role, and inform of the *help command. - commands: - - "*help" - Show: numbered list of the following commands to allow selection - - "*chat-mode" - (Default) Product Owner consultation with advanced-elicitation - - "*create-doc {template}" - Create doc (no template = show available templates) - - "*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist) - - "*shard-doc {document}" - Break down document into actionable parts - - "*correct-course" - Analyze and suggest project course corrections - - "*create-epic" - Create epic for brownfield projects (task brownfield-create-epic) - - "*create-story" - Create user story from requirements (task brownfield-create-story) - - "*exit" - Say Goodbye, You are no longer this Agent - + - '*help" - Show: numbered list of the following commands to allow selection' + - '*chat-mode" - (Default) Product Owner consultation with advanced-elicitation' + - '*create-doc {template}" - Create doc (no template = show available templates)' + - '*execute-checklist {checklist}" - Run validation checklist (default->po-master-checklist)' + - '*shard-doc {document}" - Break down document into actionable parts' + - '*correct-course" - Analyze and suggest project course corrections' + - '*create-epic" - Create epic for brownfield projects (task brownfield-create-epic)' + - '*create-story" - Create user story from requirements (task brownfield-create-story)' + - '*exit" - Say Goodbye, You are no longer this Agent' dependencies: tasks: - execute-checklist diff --git a/expansion-packs/README.md b/expansion-packs/README.md index 06e62497..11e8cc43 100644 --- a/expansion-packs/README.md +++ b/expansion-packs/README.md @@ -8,10 +8,10 @@ Expansion packs extend BMAD Method with specialized capabilities for specific us The original BMAD Method follows a simple, proven flow: -```text +````text Analyst ā†’ PM ā†’ Architect ā†’ SM ā†’ Dev (Brief) ā†’ (PRD) ā†’ (Architecture) ā†’ (Stories) ā†’ (Implementation) -``` +```text This core flow remains clean and focused on getting from business requirements to working software. @@ -62,21 +62,21 @@ expansion-pack-name/ ā”œā”€ā”€ templates/ # Document templates (.md) ā”œā”€ā”€ tasks/ # Specialized tasks (.md) ā””ā”€ā”€ checklists/ # Validation checklists (.md) -``` +```` ## Installing an Expansion Pack ### Method 1: NPM Script -```bash +````bash npm run install:expansion -``` +```text ### Method 2: Direct Script ```bash node tools/install-expansion-pack.js -``` +```` ### Method 3: Manual diff --git a/expansion-packs/infrastructure-devops/agents/infra-devops-platform.md b/expansion-packs/infrastructure-devops/agents/infra-devops-platform.md index 688720c0..e344b8ec 100644 --- a/expansion-packs/infrastructure-devops/agents/infra-devops-platform.md +++ b/expansion-packs/infrastructure-devops/agents/infra-devops-platform.md @@ -4,23 +4,20 @@ CRITICAL: Read the full YML, start activation to alter your state of being, foll ```yml activation-instructions: - - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! - - Only read the files/tasks listed here when user selects them for execution to minimize context usage - - The customization field ALWAYS takes precedence over any conflicting instructions - - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute - + - Follow all instructions in this file -> this defines you, your persona and more importantly what you can do. STAY IN CHARACTER! + - Only read the files/tasks listed here when user selects them for execution to minimize context usage + - The customization field ALWAYS takes precedence over any conflicting instructions + - When listing tasks/templates or presenting options during conversations, always show as numbered options list, allowing the user to type a number to select or execute agent: name: Alex id: infra-devops-platform title: DevOps Infrastructure Specialist Platform Engineer customization: Specialized in cloud-native system architectures and tools, like Kubernetes, Docker, GitHub Actions, CI/CD pipelines, and infrastructure-as-code practices (e.g., Terraform, CloudFormation, Bicep, etc.). - persona: role: DevOps Engineer & Platform Reliability Expert style: Systematic, automation-focused, reliability-driven, proactive. Focuses on building and maintaining robust infrastructure, CI/CD pipelines, and operational excellence. identity: Master Expert Senior Platform Engineer with 15+ years of experience in DevSecOps, Cloud Engineering, and Platform Engineering with deep SRE knowledge focus: Production environment resilience, reliability, security, and performance for optimal customer experience - core_principles: - Infrastructure as Code - Treat all infrastructure configuration as code. Use declarative approaches, version control everything, ensure reproducibility - Automation First - Automate repetitive tasks, deployments, and operational procedures. Build self-healing and self-scaling systems @@ -32,22 +29,19 @@ persona: - CI/CD Excellence - Build robust pipelines for fast, safe, reliable software delivery through automation and testing - Disaster Recovery - Plan for worst-case scenarios with backup strategies and regularly tested recovery procedures - Collaborative Operations - Work closely with development teams fostering shared responsibility for system reliability - startup: - - Announce: "Hey! I'm Alex, your DevOps Infrastructure Specialist. I love when things run secure, stable, reliable and performant. I can help with infrastructure architecture, platform engineering, CI/CD pipelines, and operational excellence. What infrastructure challenge can I help you with today?" - - List available tasks: review-infrastructure, validate-infrastructure, create infrastructure documentation - - List available templates: infrastructure-architecture, infrastructure-platform-from-arch + - Announce: Hey! I'm Alex, your DevOps Infrastructure Specialist. I love when things run secure, stable, reliable and performant. I can help with infrastructure architecture, platform engineering, CI/CD pipelines, and operational excellence. What infrastructure challenge can I help you with today? + - 'List available tasks: review-infrastructure, validate-infrastructure, create infrastructure documentation' + - 'List available templates: infrastructure-architecture, infrastructure-platform-from-arch' - Execute selected task or stay in persona to help guided by Core DevOps Principles - commands: - - "*help" - Show: numbered list of the following commands to allow selection - - "*chat-mode" - (Default) Conversational mode for infrastructure and DevOps guidance - - "*create-doc {template}" - Create doc (no template = show available templates) - - "*review-infrastructure" - Review existing infrastructure for best practices - - "*validate-infrastructure" - Validate infrastructure against security and reliability standards - - "*checklist" - Run infrastructure checklist for comprehensive review - - "*exit" - Say goodbye as Alex, the DevOps Infrastructure Specialist, and then abandon inhabiting this persona - + - '*help" - Show: numbered list of the following commands to allow selection' + - '*chat-mode" - (Default) Conversational mode for infrastructure and DevOps guidance' + - '*create-doc {template}" - Create doc (no template = show available templates)' + - '*review-infrastructure" - Review existing infrastructure for best practices' + - '*validate-infrastructure" - Validate infrastructure against security and reliability standards' + - '*checklist" - Run infrastructure checklist for comprehensive review' + - '*exit" - Say goodbye as Alex, the DevOps Infrastructure Specialist, and then abandon inhabiting this persona' dependencies: tasks: - create-doc @@ -62,4 +56,4 @@ dependencies: - technical-preferences utils: - template-format -``` \ No newline at end of file +``` diff --git a/expansion-packs/infrastructure-devops/manifest.yml b/expansion-packs/infrastructure-devops/manifest.yml index dd76a972..7be47ed6 100644 --- a/expansion-packs/infrastructure-devops/manifest.yml +++ b/expansion-packs/infrastructure-devops/manifest.yml @@ -2,59 +2,37 @@ name: infrastructure version: 1.0.0 description: Infrastructure & DevOps expansion pack for BMAD Method author: BMAD Team - -# Files to install and their destinations files: - # Agent configuration - source: agents/infra-devops-platform.yml destination: .bmad-core/agents/infra-devops-platform.yml - - # Persona definition - source: personas/infra-devops-platform.md destination: .bmad-core/personas/infra-devops-platform.md - - # IDE agent configuration - source: ide-agents/infra-devops-platform.ide.md destination: .bmad-core/ide-agents/infra-devops-platform.ide.md - - # Templates - source: templates/infrastructure-architecture-tmpl.md destination: .bmad-core/templates/infrastructure-architecture-tmpl.md - - source: templates/infrastructure-platform-from-arch-tmpl.md destination: .bmad-core/templates/infrastructure-platform-from-arch-tmpl.md - - # Tasks - source: tasks/validate-infrastructure.md destination: .bmad-core/tasks/validate-infrastructure.md - - source: tasks/review-infrastructure.md destination: .bmad-core/tasks/review-infrastructure.md - - # Checklists - source: checklists/infrastructure-checklist.md destination: .bmad-core/checklists/infrastructure-checklist.md - -# Team configurations to update (add devops agent) team_updates: - team: team-technical.yml add_agent: infra-devops-platform - - team: team-all.yml add_agent: infra-devops-platform - -# Dependencies on core BMAD components dependencies: - - architect # Infrastructure design depends on main architecture - - create-doc # Uses template system - -# Post-install instructions + - architect + - create-doc post_install_message: | Infrastructure expansion pack installed successfully! The DevOps agent is now available. To use: - - For infrastructure architecture: Use architect agent with '*create-infrastructure' - - For implementation: Use 'npm run agent devops' - - For validation: Use devops agent with '*validate-infra' + - "For infrastructure architecture: Use architect agent with '*create-infrastructure" + - "For implementation: Use 'npm run agent devops" + - "For validation: Use devops agent with '*validate-infra" Remember to configure your cloud credentials and technical preferences before use. diff --git a/expansion-packs/infrastructure-devops/tasks/review-infrastructure.md b/expansion-packs/infrastructure-devops/tasks/review-infrastructure.md index 92c343c8..46207cf2 100644 --- a/expansion-packs/infrastructure-devops/tasks/review-infrastructure.md +++ b/expansion-packs/infrastructure-devops/tasks/review-infrastructure.md @@ -32,6 +32,7 @@ To conduct a thorough review of existing infrastructure to identify improvement ### 3. Conduct Systematic Review - **If "Incremental Mode" was selected:** + - For each section of the infrastructure checklist: - **a. Present Section Focus:** Explain what aspects of infrastructure this section reviews - **b. Work Through Items:** Examine each checklist item against current infrastructure diff --git a/expansion-packs/infrastructure-devops/tasks/validate-infrastructure.md b/expansion-packs/infrastructure-devops/tasks/validate-infrastructure.md index 6f158b1b..36e7e804 100644 --- a/expansion-packs/infrastructure-devops/tasks/validate-infrastructure.md +++ b/expansion-packs/infrastructure-devops/tasks/validate-infrastructure.md @@ -55,6 +55,7 @@ To comprehensively validate platform infrastructure changes against security, re ### 4. Execute Comprehensive Platform Validation Process - **If "Incremental Mode" was selected:** + - For each section of the infrastructure checklist (Sections 1-16): - **a. Present Section Purpose:** Explain what this section validates and why it's important for platform operations - **b. Work Through Items:** Present each checklist item, guide the user through validation, and document compliance or gaps diff --git a/expansion-packs/infrastructure-devops/templates/infrastructure-architecture-tmpl.md b/expansion-packs/infrastructure-devops/templates/infrastructure-architecture-tmpl.md index 0ed886da..4d27ccd1 100644 --- a/expansion-packs/infrastructure-devops/templates/infrastructure-architecture-tmpl.md +++ b/expansion-packs/infrastructure-devops/templates/infrastructure-architecture-tmpl.md @@ -36,6 +36,7 @@ Output file location: `docs/infrastructure-architecture.md`]] [[LLM: Infrastructure Elicitation Options Present user with domain-specific elicitation options: "For the Infrastructure Overview section, I can explore: + 1. **Multi-Cloud Strategy Analysis** - Evaluate cloud provider options and vendor lock-in considerations 2. **Regional Distribution Planning** - Analyze latency requirements and data residency needs 3. **Environment Isolation Strategy** - Design security boundaries and resource segregation @@ -93,6 +94,7 @@ Select an option (1-7):"]] [[LLM: Design network topology considering security zones, traffic patterns, and compliance requirements. Reference main architecture for service communication patterns. Create Mermaid diagram showing: + - VPC/Network structure - Security zones and boundaries - Traffic flow patterns @@ -158,6 +160,7 @@ graph TB [[LLM: Design data infrastructure based on data architecture from main system design. Consider data volumes, access patterns, compliance, and recovery requirements. Create data flow diagram showing: + - Database topology - Replication patterns - Backup flows @@ -193,12 +196,12 @@ Create data flow diagram showing: @{example: responsibility_matrix} -| Component | Cloud Provider | Platform Team | Dev Team | Security Team | -|-----------|---------------|---------------|----------|---------------| -| Physical Security | āœ“ | - | - | Audit | -| Network Security | Partial | āœ“ | Config | Audit | -| Application Security | - | Tools | āœ“ | Review | -| Data Encryption | Engine | Config | Implementation | Standards | +| Component | Cloud Provider | Platform Team | Dev Team | Security Team | +| -------------------- | -------------- | ------------- | -------------- | ------------- | +| Physical Security | āœ“ | - | - | Audit | +| Network Security | Partial | āœ“ | Config | Audit | +| Application Security | - | Tools | āœ“ | Review | +| Data Encryption | Engine | Config | Implementation | Standards | @{/example} @@ -217,6 +220,7 @@ Create data flow diagram showing: [[LLM: Design deployment pipeline that balances speed with safety. Include progressive deployment strategies and automated quality gates. Create pipeline diagram showing: + - Build stages - Test gates - Deployment stages @@ -265,18 +269,21 @@ Create pipeline diagram showing: [[LLM: Design infrastructure to specifically support other BMAD agents and their workflows. This ensures the infrastructure enables the entire BMAD methodology.]] ### Development Agent Support + - Container platform for development environments - GitOps workflows for application deployment - Service mesh integration for development testing - Developer self-service platform capabilities ### Product & Architecture Alignment + - Infrastructure implementing PRD scalability requirements - Deployment automation supporting product iteration speed - Service reliability meeting product SLAs - Architecture patterns properly implemented in infrastructure ### Cross-Agent Integration Points + - CI/CD pipelines supporting Frontend, Backend, and Full Stack development workflows - Monitoring and observability data accessible to QA and DevOps agents - Infrastructure enabling Design Architect's UI/UX performance requirements @@ -333,6 +340,7 @@ The Platform Engineer should use the infrastructure checklist to systematically ### Architecture Decision Records (ADRs) Create ADRs for key infrastructure decisions: + - Cloud provider selection rationale - Container orchestration platform choice - Networking architecture decisions @@ -342,6 +350,7 @@ Create ADRs for key infrastructure decisions: ### Implementation Validation Criteria Define specific criteria for validating correct implementation: + - Infrastructure as Code quality gates - Security compliance checkpoints - Performance benchmarks @@ -401,6 +410,6 @@ Define specific criteria for validating correct implementation: --- -*Document Version: 1.0* -*Last Updated: {{current_date}}* -*Next Review: {{review_date}}* \ No newline at end of file +_Document Version: 1.0_ +_Last Updated: {{current_date}}_ +_Next Review: {{review_date}}_ diff --git a/package-lock.json b/package-lock.json index 8bad6377..adb66938 100644 --- a/package-lock.json +++ b/package-lock.json @@ -19,8 +19,14 @@ "ora": "^5.4.1" }, "bin": { - "bmad": "tools/installer/bin/bmad.js", - "bmad-method": "tools/installer/bin/bmad.js" + "bmad": "tools/bmad-npx-wrapper.js", + "bmad-method": "tools/bmad-npx-wrapper.js" + }, + "devDependencies": { + "husky": "^9.1.7", + "lint-staged": "^16.1.1", + "prettier": "^3.5.3", + "yaml-lint": "^1.7.0" }, "engines": { "node": ">=14.0.0" @@ -50,6 +56,44 @@ "url": "https://github.com/sponsors/ksylvan" } }, + "node_modules/@nodelib/fs.scandir": { + "version": "2.1.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.scandir/-/fs.scandir-2.1.5.tgz", + "integrity": "sha512-vq24Bq3ym5HEQm2NKCr3yXDwjc7vTsEThRDnkp2DK9p1uqLR+DHurm/NOTo0KG7HYHU7eppKZj3MyqYuMBf62g==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "2.0.5", + "run-parallel": "^1.1.9" + }, + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.stat": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/@nodelib/fs.stat/-/fs.stat-2.0.5.tgz", + "integrity": "sha512-RkhPPp2zrqDAQA/2jNhnztcPAlv64XdhIp7a7454A5ovI7Bukxgt7MX7udwAu3zg1DcpPU0rz3VV1SeaqvY4+A==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, + "node_modules/@nodelib/fs.walk": { + "version": "1.2.8", + "resolved": "https://registry.npmjs.org/@nodelib/fs.walk/-/fs.walk-1.2.8.tgz", + "integrity": "sha512-oGB+UxlgWcgQkgwo8GcEGwemoTFt3FIO9ababBmaGwXIoBKZ+GTy0pP185beGg7Llih/NSHSV2XAs1lnznocSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.scandir": "2.1.5", + "fastq": "^1.6.0" + }, + "engines": { + "node": ">= 8" + } + }, "node_modules/@types/debug": { "version": "4.1.12", "resolved": "https://registry.npmjs.org/@types/debug/-/debug-4.1.12.tgz", @@ -125,6 +169,23 @@ "integrity": "sha512-8+9WqebbFzpX9OR+Wa6O29asIogeRMzcGtAINdpMHHyAg10f05aSFVBbcEqGf/PXw1EjAZ+q2/bEBg3DvurK3Q==", "license": "Python-2.0" }, + "node_modules/array-union": { + "version": "2.1.0", + "resolved": "https://registry.npmjs.org/array-union/-/array-union-2.1.0.tgz", + "integrity": "sha512-HGyxoOTYUyCM6stUe6EJgnd4EoewAI7zMdfqO+kGjnlZmBDz/cR5pf8r/cR4Wq60sL/p0IkcjUEEPwS3GFrIyw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/async": { + "version": "3.2.6", + "resolved": "https://registry.npmjs.org/async/-/async-3.2.6.tgz", + "integrity": "sha512-htCUDlxyyCLMgaM3xXg0C0LW2xqfuQ6p05pCEIsXuyQ+a1koYKTuBMzRNwmybfLgvJDMd0r1LTn4+E0Ti6C2AA==", + "dev": true, + "license": "MIT" + }, "node_modules/bail": { "version": "2.0.2", "resolved": "https://registry.npmjs.org/bail/-/bail-2.0.2.tgz", @@ -187,6 +248,19 @@ "balanced-match": "^1.0.0" } }, + "node_modules/braces": { + "version": "3.0.3", + "resolved": "https://registry.npmjs.org/braces/-/braces-3.0.3.tgz", + "integrity": "sha512-yQbXgO/OSZVD2IsiLlro+7Hf6Q18EJrKSEsdoMzKePKXct3gvD8oLcOQdIzGupr5Fj+EDe8gO/lxc1BzfMpxvA==", + "dev": true, + "license": "MIT", + "dependencies": { + "fill-range": "^7.1.1" + }, + "engines": { + "node": ">=8" + } + }, "node_modules/buffer": { "version": "5.7.1", "resolved": "https://registry.npmjs.org/buffer/-/buffer-5.7.1.tgz", @@ -267,6 +341,77 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/cli-truncate": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/cli-truncate/-/cli-truncate-4.0.0.tgz", + "integrity": "sha512-nPdaFdQ0h/GEigbPClz11D0v/ZJEwxmeVZGeMo3Z5StPtUTkA9o1lD6QwoirYiSDzbcwn2XcjwmCp68W1IS4TA==", + "dev": true, + "license": "MIT", + "dependencies": { + "slice-ansi": "^5.0.0", + "string-width": "^7.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cli-truncate/node_modules/ansi-regex": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz", + "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/cli-truncate/node_modules/emoji-regex": { + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.4.0.tgz", + "integrity": "sha512-EC+0oUMY1Rqm4O6LLrgjtYDvcVYTy7chDnM4Q7030tP4Kwj3u/pR6gP9ygnp2CJMK5Gq+9Q2oqmrFJAz01DXjw==", + "dev": true, + "license": "MIT" + }, + "node_modules/cli-truncate/node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/cli-truncate/node_modules/strip-ansi": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz", + "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, "node_modules/cli-width": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/cli-width/-/cli-width-3.0.0.tgz", @@ -276,6 +421,36 @@ "node": ">= 10" } }, + "node_modules/cliui": { + "version": "7.0.4", + "resolved": "https://registry.npmjs.org/cliui/-/cliui-7.0.4.tgz", + "integrity": "sha512-OcRE68cOsVMXp1Yvonl/fzkQOyjLSu/8bhPDfQt0e0/Eb283TKP20Fs2MqoPsr9SwA595rRCA+QMzYc9nBP+JQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "string-width": "^4.2.0", + "strip-ansi": "^6.0.0", + "wrap-ansi": "^7.0.0" + } + }, + "node_modules/cliui/node_modules/wrap-ansi": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-7.0.0.tgz", + "integrity": "sha512-YVGIj2kamLSTxw6NsZjoBxfSwsn0ycdesmc4p+Q21c5zPuZ1pl+NfxVdxPtdHvmNVOQ6XSYG4AUtyt/Fi7D16Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^4.0.0", + "string-width": "^4.1.0", + "strip-ansi": "^6.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, "node_modules/clone": { "version": "1.0.4", "resolved": "https://registry.npmjs.org/clone/-/clone-1.0.4.tgz", @@ -303,6 +478,13 @@ "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==", "license": "MIT" }, + "node_modules/colorette": { + "version": "2.0.20", + "resolved": "https://registry.npmjs.org/colorette/-/colorette-2.0.20.tgz", + "integrity": "sha512-IfEDxwoWIjkeXL1eXcDiow4UbKjhLdq6/EuSVR9GMN7KVH3r9gQ83e73hsz1Nd1T3ijd5xv1wcWRYO+D6kCI2w==", + "dev": true, + "license": "MIT" + }, "node_modules/commander": { "version": "9.5.0", "resolved": "https://registry.npmjs.org/commander/-/commander-9.5.0.tgz", @@ -312,6 +494,13 @@ "node": "^12.20.0 || >=14" } }, + "node_modules/consola": { + "version": "2.15.3", + "resolved": "https://registry.npmjs.org/consola/-/consola-2.15.3.tgz", + "integrity": "sha512-9vAdYbHj6x2fLKC4+oPH0kFzY/orMZyG2Aj+kNylHxKGJ/Ed4dpNyAQYwJOdqO4zdM7XpVHmyejQDcQHrnuXbw==", + "dev": true, + "license": "MIT" + }, "node_modules/css-selector-parser": { "version": "3.1.2", "resolved": "https://registry.npmjs.org/css-selector-parser/-/css-selector-parser-3.1.2.tgz", @@ -392,12 +581,55 @@ "url": "https://github.com/sponsors/wooorm" } }, + "node_modules/dir-glob": { + "version": "3.0.1", + "resolved": "https://registry.npmjs.org/dir-glob/-/dir-glob-3.0.1.tgz", + "integrity": "sha512-WkrWp9GR4KXfKGYzOLmTuGVi1UWFfws377n9cc55/tb6DuqyF6pcQ5AbiHEshaDpY9v6oaSr2XCDidGmMwdzIA==", + "dev": true, + "license": "MIT", + "dependencies": { + "path-type": "^4.0.0" + }, + "engines": { + "node": ">=8" + } + }, "node_modules/emoji-regex": { "version": "8.0.0", "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-8.0.0.tgz", "integrity": "sha512-MSjYzcWNOA0ewAHpz0MxpYFvwg6yjy1NG3xteoqz644VCo/RPgnr1/GGt+ic3iJTzQ8Eu3TdM14SawnVUmGE6A==", "license": "MIT" }, + "node_modules/environment": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/environment/-/environment-1.1.0.tgz", + "integrity": "sha512-xUtoPkMggbz0MPyPiIWr1Kp4aeWJjDZ6SMvURhimjdZgsRuDplF5/s9hcgGhyXMhs+6vpnuoiZ2kFiu3FMnS8Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/escalade": { + "version": "3.2.0", + "resolved": "https://registry.npmjs.org/escalade/-/escalade-3.2.0.tgz", + "integrity": "sha512-WUj2qlxaQtO4g6Pq5c29GTcWGDyd8itL8zTlipgECz3JesAiiOKotd8JU6otB3PACgG6xkJUyVhboMS+bje/jA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=6" + } + }, + "node_modules/eventemitter3": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/eventemitter3/-/eventemitter3-5.0.1.tgz", + "integrity": "sha512-GWkBvjiSZK87ELrYOSESUYeVIc9mvLLf/nXalMOS5dYrgZq9o5OVkbZAVM06CVxYsCwH9BDZFPlQTlPA1j4ahA==", + "dev": true, + "license": "MIT" + }, "node_modules/extend": { "version": "3.0.2", "resolved": "https://registry.npmjs.org/extend/-/extend-3.0.2.tgz", @@ -418,6 +650,33 @@ "node": ">=4" } }, + "node_modules/fast-glob": { + "version": "3.3.3", + "resolved": "https://registry.npmjs.org/fast-glob/-/fast-glob-3.3.3.tgz", + "integrity": "sha512-7MptL8U0cqcFdzIzwOTHoilX9x5BrNqye7Z/LuC7kCMRio1EMSyqRK3BEAUD7sXRq4iT4AzTVuZdhgQ2TCvYLg==", + "dev": true, + "license": "MIT", + "dependencies": { + "@nodelib/fs.stat": "^2.0.2", + "@nodelib/fs.walk": "^1.2.3", + "glob-parent": "^5.1.2", + "merge2": "^1.3.0", + "micromatch": "^4.0.8" + }, + "engines": { + "node": ">=8.6.0" + } + }, + "node_modules/fastq": { + "version": "1.19.1", + "resolved": "https://registry.npmjs.org/fastq/-/fastq-1.19.1.tgz", + "integrity": "sha512-GwLTyxkCXjXbxqIhTsMI2Nui8huMPtnxg7krajPJAjnEG/iiOS7i+zCtWGZR9G0NBKbXKh6X9m9UIsYX/N6vvQ==", + "dev": true, + "license": "ISC", + "dependencies": { + "reusify": "^1.0.4" + } + }, "node_modules/figures": { "version": "3.2.0", "resolved": "https://registry.npmjs.org/figures/-/figures-3.2.0.tgz", @@ -442,6 +701,19 @@ "node": ">=0.8.0" } }, + "node_modules/fill-range": { + "version": "7.1.1", + "resolved": "https://registry.npmjs.org/fill-range/-/fill-range-7.1.1.tgz", + "integrity": "sha512-YsGpe3WHLK8ZYi4tWDg2Jy3ebRz2rXowDxnld4bkQB00cc/1Zw9AWnC0i9ztDJitivtQvaI9KaLyKrc+hBW0yg==", + "dev": true, + "license": "MIT", + "dependencies": { + "to-regex-range": "^5.0.1" + }, + "engines": { + "node": ">=8" + } + }, "node_modules/fs-extra": { "version": "11.3.0", "resolved": "https://registry.npmjs.org/fs-extra/-/fs-extra-11.3.0.tgz", @@ -462,6 +734,29 @@ "integrity": "sha512-OO0pH2lK6a0hZnAdau5ItzHPI6pUlvI7jMVnxUQRtw4owF2wk8lOSabtGDCTP4Ggrg2MbGnWO9X8K1t4+fGMDw==", "license": "ISC" }, + "node_modules/get-caller-file": { + "version": "2.0.5", + "resolved": "https://registry.npmjs.org/get-caller-file/-/get-caller-file-2.0.5.tgz", + "integrity": "sha512-DyFP3BM/3YHTQOCUL/w0OZHR0lpKeGrxotcHWcqNEdnltqFwXVfhEBQ94eIo34AfQpo0rGki4cyIiftY06h2Fg==", + "dev": true, + "license": "ISC", + "engines": { + "node": "6.* || 8.* || >= 10.*" + } + }, + "node_modules/get-east-asian-width": { + "version": "1.3.0", + "resolved": "https://registry.npmjs.org/get-east-asian-width/-/get-east-asian-width-1.3.0.tgz", + "integrity": "sha512-vpeMIQKxczTD/0s2CdEWHcb0eeJe6TFjxb+J5xgX7hScxqrGuyjmv4c1D4A/gelKfyox0gJJwIHF+fLjeaM8kQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/glob": { "version": "8.1.0", "resolved": "https://registry.npmjs.org/glob/-/glob-8.1.0.tgz", @@ -482,6 +777,40 @@ "url": "https://github.com/sponsors/isaacs" } }, + "node_modules/glob-parent": { + "version": "5.1.2", + "resolved": "https://registry.npmjs.org/glob-parent/-/glob-parent-5.1.2.tgz", + "integrity": "sha512-AOIgSQCepiJYwP3ARnGx+5VnTu2HBYdzbGP45eLw1vr3zB3vZLeyed1sC9hnbcOc9/SrMyM5RPQrkGz4aS9Zow==", + "dev": true, + "license": "ISC", + "dependencies": { + "is-glob": "^4.0.1" + }, + "engines": { + "node": ">= 6" + } + }, + "node_modules/globby": { + "version": "11.1.0", + "resolved": "https://registry.npmjs.org/globby/-/globby-11.1.0.tgz", + "integrity": "sha512-jhIXaOzy1sb8IyocaruWSn1TjmnBVs8Ayhcy83rmxNJ8q2uWKCAj3CnJY+KpGSXCueAPc0i05kVvVKtP1t9S3g==", + "dev": true, + "license": "MIT", + "dependencies": { + "array-union": "^2.1.0", + "dir-glob": "^3.0.1", + "fast-glob": "^3.2.9", + "ignore": "^5.2.0", + "merge2": "^1.4.1", + "slash": "^3.0.0" + }, + "engines": { + "node": ">=10" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/graceful-fs": { "version": "4.2.11", "resolved": "https://registry.npmjs.org/graceful-fs/-/graceful-fs-4.2.11.tgz", @@ -497,6 +826,22 @@ "node": ">=8" } }, + "node_modules/husky": { + "version": "9.1.7", + "resolved": "https://registry.npmjs.org/husky/-/husky-9.1.7.tgz", + "integrity": "sha512-5gs5ytaNjBrh5Ow3zrvdUUY+0VxIuWVL4i9irt6friV+BqdCfmV11CQTWMiBYWHbXhco+J1kHfTOUkePhCDvMA==", + "dev": true, + "license": "MIT", + "bin": { + "husky": "bin.js" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/typicode" + } + }, "node_modules/iconv-lite": { "version": "0.4.24", "resolved": "https://registry.npmjs.org/iconv-lite/-/iconv-lite-0.4.24.tgz", @@ -529,6 +874,16 @@ ], "license": "BSD-3-Clause" }, + "node_modules/ignore": { + "version": "5.3.2", + "resolved": "https://registry.npmjs.org/ignore/-/ignore-5.3.2.tgz", + "integrity": "sha512-hsBTNUqQTDwkWtcdYI2i06Y/nUBEsNEDJKjWdigLvegy8kDuJAS8uRlpkkcQpyEXL0Z/pjDy5HBmMjRCJ2gq+g==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 4" + } + }, "node_modules/inflight": { "version": "1.0.6", "resolved": "https://registry.npmjs.org/inflight/-/inflight-1.0.6.tgz", @@ -546,6 +901,16 @@ "integrity": "sha512-k/vGaX4/Yla3WzyMCvTQOXYeIHvqOKtnqBduzTHpzpQZzAskKMhZ2K+EnBiSM9zGSoIFeMpXKxa4dYeZIQqewQ==", "license": "ISC" }, + "node_modules/ini": { + "version": "2.0.0", + "resolved": "https://registry.npmjs.org/ini/-/ini-2.0.0.tgz", + "integrity": "sha512-7PnF4oN3CvZF23ADhA5wRaYEQpJ8qygSkbtTXWBeXWXmEVRXK+1ITciHWwHhsjv1TmW0MgacIv6hEi5pX5NQdA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, "node_modules/inquirer": { "version": "8.2.6", "resolved": "https://registry.npmjs.org/inquirer/-/inquirer-8.2.6.tgz", @@ -586,6 +951,16 @@ "node": ">=8" } }, + "node_modules/is-extglob": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/is-extglob/-/is-extglob-2.1.1.tgz", + "integrity": "sha512-SbKbANkN603Vi4jEZv49LeVJMn4yGwsbzZworEoyEiutsN3nJYdbO36zfhGJ6QEDpOZIFkDtnq5JRxmvl3jsoQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/is-fullwidth-code-point": { "version": "3.0.0", "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-3.0.0.tgz", @@ -595,6 +970,19 @@ "node": ">=8" } }, + "node_modules/is-glob": { + "version": "4.0.3", + "resolved": "https://registry.npmjs.org/is-glob/-/is-glob-4.0.3.tgz", + "integrity": "sha512-xelSayHH36ZgE7ZWhli7pW34hNbNl8Ojv5KVmkJD4hBdD3th8Tfk9vYasLM+mXWOZhFkgZfxhLSnrwRr4elSSg==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-extglob": "^2.1.1" + }, + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/is-interactive": { "version": "1.0.0", "resolved": "https://registry.npmjs.org/is-interactive/-/is-interactive-1.0.0.tgz", @@ -604,6 +992,16 @@ "node": ">=8" } }, + "node_modules/is-number": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/is-number/-/is-number-7.0.0.tgz", + "integrity": "sha512-41Cifkg6e8TylSpdtTpeLVMqvSBEVzTttHvERD741+pnZ8ANv0004MRL43QKPDlK9cGvNp6NZWZUBlbGXYxxng==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.12.0" + } + }, "node_modules/is-plain-obj": { "version": "4.1.0", "resolved": "https://registry.npmjs.org/is-plain-obj/-/is-plain-obj-4.1.0.tgz", @@ -652,6 +1050,88 @@ "graceful-fs": "^4.1.6" } }, + "node_modules/lilconfig": { + "version": "3.1.3", + "resolved": "https://registry.npmjs.org/lilconfig/-/lilconfig-3.1.3.tgz", + "integrity": "sha512-/vlFKAoH5Cgt3Ie+JLhRbwOsCQePABiU3tJ1egGvyQ+33R/vcwM2Zl2QR/LzjsBeItPt3oSVXapn+m4nQDvpzw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/antonk52" + } + }, + "node_modules/lint-staged": { + "version": "16.1.1", + "resolved": "https://registry.npmjs.org/lint-staged/-/lint-staged-16.1.1.tgz", + "integrity": "sha512-kVZvRAHw9WuufENnwuZLiB1X/8B8YpGszzjMET0bP+uJSjjB7KXeaX2ckYRtQyHfeQdCWMc6tRK34t4geHL9sg==", + "dev": true, + "license": "MIT", + "dependencies": { + "chalk": "^5.4.1", + "commander": "^14.0.0", + "debug": "^4.4.1", + "lilconfig": "^3.1.3", + "listr2": "^8.3.3", + "micromatch": "^4.0.8", + "nano-spawn": "^1.0.2", + "pidtree": "^0.6.0", + "string-argv": "^0.3.2", + "yaml": "^2.8.0" + }, + "bin": { + "lint-staged": "bin/lint-staged.js" + }, + "engines": { + "node": ">=20.17" + }, + "funding": { + "url": "https://opencollective.com/lint-staged" + } + }, + "node_modules/lint-staged/node_modules/chalk": { + "version": "5.4.1", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-5.4.1.tgz", + "integrity": "sha512-zgVZuo2WcZgfUEmsn6eO3kINexW8RAE4maiQ8QNs8CtpPCSyMiYsULR3HQYkm3w8FIA3SberyMJMSldGsW+U3w==", + "dev": true, + "license": "MIT", + "engines": { + "node": "^12.17.0 || ^14.13 || >=16.0.0" + }, + "funding": { + "url": "https://github.com/chalk/chalk?sponsor=1" + } + }, + "node_modules/lint-staged/node_modules/commander": { + "version": "14.0.0", + "resolved": "https://registry.npmjs.org/commander/-/commander-14.0.0.tgz", + "integrity": "sha512-2uM9rYjPvyq39NwLRqaiLtWHyDC1FvryJDa2ATTVims5YAS4PupsEQsDvP14FqhFr0P49CYDugi59xaxJlTXRA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20" + } + }, + "node_modules/listr2": { + "version": "8.3.3", + "resolved": "https://registry.npmjs.org/listr2/-/listr2-8.3.3.tgz", + "integrity": "sha512-LWzX2KsqcB1wqQ4AHgYb4RsDXauQiqhjLk+6hjbaeHG4zpjjVAB6wC/gz6X0l+Du1cN3pUB5ZlrvTbhGSNnUQQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "cli-truncate": "^4.0.0", + "colorette": "^2.0.20", + "eventemitter3": "^5.0.1", + "log-update": "^6.1.0", + "rfdc": "^1.4.1", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=18.0.0" + } + }, "node_modules/lodash": { "version": "4.17.21", "resolved": "https://registry.npmjs.org/lodash/-/lodash-4.17.21.tgz", @@ -680,6 +1160,179 @@ "url": "https://github.com/sponsors/sindresorhus" } }, + "node_modules/log-update": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/log-update/-/log-update-6.1.0.tgz", + "integrity": "sha512-9ie8ItPR6tjY5uYJh8K/Zrv/RMZ5VOlOWvtZdEHYSTFKZfIBPQa9tOAEeAWhd+AnIneLJ22w5fjOYtoutpWq5w==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-escapes": "^7.0.0", + "cli-cursor": "^5.0.0", + "slice-ansi": "^7.1.0", + "strip-ansi": "^7.1.0", + "wrap-ansi": "^9.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/ansi-escapes": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/ansi-escapes/-/ansi-escapes-7.0.0.tgz", + "integrity": "sha512-GdYO7a61mR0fOlAsvC9/rIHf7L96sBc6dEWzeOu+KAea5bZyQRPIpojrVoI4AXGJS/ycu/fBTdLrUkA4ODrvjw==", + "dev": true, + "license": "MIT", + "dependencies": { + "environment": "^1.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/ansi-regex": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz", + "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/log-update/node_modules/ansi-styles": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz", + "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/log-update/node_modules/cli-cursor": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/cli-cursor/-/cli-cursor-5.0.0.tgz", + "integrity": "sha512-aCj4O5wKyszjMmDT4tZj93kxyydN/K5zPWSCe6/0AV/AA1pqe5ZBIw0a2ZfPQV7lL5/yb5HsUreJ6UFAF1tEQw==", + "dev": true, + "license": "MIT", + "dependencies": { + "restore-cursor": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/is-fullwidth-code-point": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-5.0.0.tgz", + "integrity": "sha512-OVa3u9kkBbw7b8Xw5F9P+D/T9X+Z4+JruYVNapTjPYZYUznQ5YfWeFkOj606XYYW8yugTfC8Pj0hYqvi4ryAhA==", + "dev": true, + "license": "MIT", + "dependencies": { + "get-east-asian-width": "^1.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/onetime": { + "version": "7.0.0", + "resolved": "https://registry.npmjs.org/onetime/-/onetime-7.0.0.tgz", + "integrity": "sha512-VXJjc87FScF88uafS3JllDgvAm+c/Slfz06lorj2uAY34rlUu0Nt+v8wreiImcrgAjjIHp1rXpTDlLOGw29WwQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "mimic-function": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/restore-cursor": { + "version": "5.1.0", + "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-5.1.0.tgz", + "integrity": "sha512-oMA2dcrw6u0YfxJQXm342bFKX/E4sG9rbTzO9ptUcR/e8A33cHuvStiYOwH7fszkZlZ1z/ta9AAoPk2F4qIOHA==", + "dev": true, + "license": "MIT", + "dependencies": { + "onetime": "^7.0.0", + "signal-exit": "^4.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/log-update/node_modules/signal-exit": { + "version": "4.1.0", + "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-4.1.0.tgz", + "integrity": "sha512-bzyZ1e88w9O1iNJbKnOlvYTrWPDl46O1bG0D3XInv+9tkPrxrN8jUUTiFlDkkmKWgn1M6CfIA13SuGqOa9Korw==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/sponsors/isaacs" + } + }, + "node_modules/log-update/node_modules/slice-ansi": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-7.1.0.tgz", + "integrity": "sha512-bSiSngZ/jWeX93BqeIAbImyTbEihizcwNjFoRUIY/T1wWQsfsm2Vw1agPKylXvQTU7iASGdHhyqRlqQzfz+Htg==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "is-fullwidth-code-point": "^5.0.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/slice-ansi?sponsor=1" + } + }, + "node_modules/log-update/node_modules/strip-ansi": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz", + "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, "node_modules/longest-streak": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/longest-streak/-/longest-streak-3.1.0.tgz", @@ -762,6 +1415,16 @@ "url": "https://opencollective.com/unified" } }, + "node_modules/merge2": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/merge2/-/merge2-1.4.1.tgz", + "integrity": "sha512-8q7VEgMJW4J8tcfVPy8g09NcQwZdbwFEqhe/WZkoIzjn/3TGDwtOCYtXGxA3O8tPzpczCCDgv+P2P5y00ZJOOg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">= 8" + } + }, "node_modules/micromark": { "version": "4.0.2", "resolved": "https://registry.npmjs.org/micromark/-/micromark-4.0.2.tgz", @@ -1204,6 +1867,20 @@ ], "license": "MIT" }, + "node_modules/micromatch": { + "version": "4.0.8", + "resolved": "https://registry.npmjs.org/micromatch/-/micromatch-4.0.8.tgz", + "integrity": "sha512-PXwfBhYu0hBCPw8Dn0E+WDYb7af3dSLVWKi3HGv84IdF4TyFoC0ysxFd0Goxw7nSv4T/PzEJQxsYsEiFCKo2BA==", + "dev": true, + "license": "MIT", + "dependencies": { + "braces": "^3.0.3", + "picomatch": "^2.3.1" + }, + "engines": { + "node": ">=8.6" + } + }, "node_modules/mimic-fn": { "version": "2.1.0", "resolved": "https://registry.npmjs.org/mimic-fn/-/mimic-fn-2.1.0.tgz", @@ -1213,6 +1890,19 @@ "node": ">=6" } }, + "node_modules/mimic-function": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/mimic-function/-/mimic-function-5.0.1.tgz", + "integrity": "sha512-VP79XUPxV2CigYP3jWwAUFSku2aKqBH7uTAapFWCBqutsbmDo96KY5o8uh6U+/YSIn5OxJnXp73beVkpqMIGhA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/minimatch": { "version": "5.1.6", "resolved": "https://registry.npmjs.org/minimatch/-/minimatch-5.1.6.tgz", @@ -1237,6 +1927,35 @@ "integrity": "sha512-nnbWWOkoWyUsTjKrhgD0dcz22mdkSnpYqbEjIm2nhwhuxlSkpywJmBo8h0ZqJdkp73mb90SssHkN4rsRaBAfAA==", "license": "ISC" }, + "node_modules/nano-spawn": { + "version": "1.0.2", + "resolved": "https://registry.npmjs.org/nano-spawn/-/nano-spawn-1.0.2.tgz", + "integrity": "sha512-21t+ozMQDAL/UGgQVBbZ/xXvNO10++ZPuTmKRO8k9V3AClVRht49ahtDjfY8l1q6nSHOrE5ASfthzH3ol6R/hg==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=20.17" + }, + "funding": { + "url": "https://github.com/sindresorhus/nano-spawn?sponsor=1" + } + }, + "node_modules/nconf": { + "version": "0.12.1", + "resolved": "https://registry.npmjs.org/nconf/-/nconf-0.12.1.tgz", + "integrity": "sha512-p2cfF+B3XXacQdswUYWZ0w6Vld0832A/tuqjLBu3H1sfUcby4N2oVbGhyuCkZv+t3iY3aiFEj7gZGqax9Q2c1w==", + "dev": true, + "license": "MIT", + "dependencies": { + "async": "^3.0.0", + "ini": "^2.0.0", + "secure-keys": "^1.0.0", + "yargs": "^16.1.1" + }, + "engines": { + "node": ">= 0.4.0" + } + }, "node_modules/nth-check": { "version": "2.1.1", "resolved": "https://registry.npmjs.org/nth-check/-/nth-check-2.1.1.tgz", @@ -1305,6 +2024,79 @@ "node": ">=0.10.0" } }, + "node_modules/path-type": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/path-type/-/path-type-4.0.0.tgz", + "integrity": "sha512-gDKb8aZMDeD/tZWs9P6+q0J9Mwkdl6xMV8TjnGP3qJVJ06bdMgkbBlLU8IdfOsIsFz2BW1rNVT3XuNEl8zPAvw==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/picomatch": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/picomatch/-/picomatch-2.3.1.tgz", + "integrity": "sha512-JU3teHTNjmE2VCGFzuY8EXzCDVwEqB2a8fsIvwaStHhAWJEeVd1o1QD80CU6+ZdEXXSLbSsuLwJjkCBWqRQUVA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8.6" + }, + "funding": { + "url": "https://github.com/sponsors/jonschlinkert" + } + }, + "node_modules/pidtree": { + "version": "0.6.0", + "resolved": "https://registry.npmjs.org/pidtree/-/pidtree-0.6.0.tgz", + "integrity": "sha512-eG2dWTVw5bzqGRztnHExczNxt5VGsE6OwTeCG3fdUf9KBsZzO3R5OIIIzWR+iZA0NtZ+RDVdaoE2dK1cn6jH4g==", + "dev": true, + "license": "MIT", + "bin": { + "pidtree": "bin/pidtree.js" + }, + "engines": { + "node": ">=0.10" + } + }, + "node_modules/prettier": { + "version": "3.5.3", + "resolved": "https://registry.npmjs.org/prettier/-/prettier-3.5.3.tgz", + "integrity": "sha512-QQtaxnoDJeAkDvDKWCLiwIXkTgRhwYDEQCghU9Z6q03iyek/rxRh/2lC3HB7P8sWT2xC/y5JDctPLBIGzHKbhw==", + "dev": true, + "license": "MIT", + "bin": { + "prettier": "bin/prettier.cjs" + }, + "engines": { + "node": ">=14" + }, + "funding": { + "url": "https://github.com/prettier/prettier?sponsor=1" + } + }, + "node_modules/queue-microtask": { + "version": "1.2.3", + "resolved": "https://registry.npmjs.org/queue-microtask/-/queue-microtask-1.2.3.tgz", + "integrity": "sha512-NuaNSa6flKT5JaSYQzJok04JzTL1CA6aGhv5rfLW3PgqA+M2ChpZQnAC8h8i4ZFkBS8X5RqkDBHA7r4hej3K9A==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT" + }, "node_modules/readable-stream": { "version": "3.6.2", "resolved": "https://registry.npmjs.org/readable-stream/-/readable-stream-3.6.2.tgz", @@ -1350,6 +2142,16 @@ "url": "https://opencollective.com/unified" } }, + "node_modules/require-directory": { + "version": "2.1.1", + "resolved": "https://registry.npmjs.org/require-directory/-/require-directory-2.1.1.tgz", + "integrity": "sha512-fGxEI7+wsG9xrvdjsrlmL22OMTTiHRwAMroiEeMgq8gzoLC/PQr7RsRDSTLUg/bZAZtF+TVIkHc6/4RIKrui+Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.10.0" + } + }, "node_modules/restore-cursor": { "version": "3.1.0", "resolved": "https://registry.npmjs.org/restore-cursor/-/restore-cursor-3.1.0.tgz", @@ -1363,6 +2165,24 @@ "node": ">=8" } }, + "node_modules/reusify": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/reusify/-/reusify-1.1.0.tgz", + "integrity": "sha512-g6QUff04oZpHs0eG5p83rFLhHeV00ug/Yf9nZM6fLeUrPguBTkTQOdpAWWspMh55TZfVQDPaN3NQJfbVRAxdIw==", + "dev": true, + "license": "MIT", + "engines": { + "iojs": ">=1.0.0", + "node": ">=0.10.0" + } + }, + "node_modules/rfdc": { + "version": "1.4.1", + "resolved": "https://registry.npmjs.org/rfdc/-/rfdc-1.4.1.tgz", + "integrity": "sha512-q1b3N5QkRUWUl7iyylaaj3kOpIT0N2i9MqIEQXP73GVsN9cw3fdx8X63cEmWhJGi2PPCF23Ijp7ktmd39rawIA==", + "dev": true, + "license": "MIT" + }, "node_modules/run-async": { "version": "2.4.1", "resolved": "https://registry.npmjs.org/run-async/-/run-async-2.4.1.tgz", @@ -1372,6 +2192,30 @@ "node": ">=0.12.0" } }, + "node_modules/run-parallel": { + "version": "1.2.0", + "resolved": "https://registry.npmjs.org/run-parallel/-/run-parallel-1.2.0.tgz", + "integrity": "sha512-5l4VyZR86LZ/lDxZTR6jqL8AFE2S0IFLMP26AbjsLVADxHdhB/c0GUsH+y39UfCi3dzz8OlQuPmnaJOMoDHQBA==", + "dev": true, + "funding": [ + { + "type": "github", + "url": "https://github.com/sponsors/feross" + }, + { + "type": "patreon", + "url": "https://www.patreon.com/feross" + }, + { + "type": "consulting", + "url": "https://feross.org/support" + } + ], + "license": "MIT", + "dependencies": { + "queue-microtask": "^1.2.2" + } + }, "node_modules/rxjs": { "version": "7.8.2", "resolved": "https://registry.npmjs.org/rxjs/-/rxjs-7.8.2.tgz", @@ -1407,12 +2251,72 @@ "integrity": "sha512-YZo3K82SD7Riyi0E1EQPojLz7kpepnSQI9IyPbHHg1XXXevb5dJI7tpyN2ADxGcQbHG7vcyRHk0cbwqcQriUtg==", "license": "MIT" }, + "node_modules/secure-keys": { + "version": "1.0.0", + "resolved": "https://registry.npmjs.org/secure-keys/-/secure-keys-1.0.0.tgz", + "integrity": "sha512-nZi59hW3Sl5P3+wOO89eHBAAGwmCPd2aE1+dLZV5MO+ItQctIvAqihzaAXIQhvtH4KJPxM080HsnqltR2y8cWg==", + "dev": true, + "license": "MIT" + }, "node_modules/signal-exit": { "version": "3.0.7", "resolved": "https://registry.npmjs.org/signal-exit/-/signal-exit-3.0.7.tgz", "integrity": "sha512-wnD2ZE+l+SPC/uoS0vXeE9L1+0wuaMqKlfz9AMUo38JsyLSBWSFcHR1Rri62LZc12vLr1gb3jl7iwQhgwpAbGQ==", "license": "ISC" }, + "node_modules/slash": { + "version": "3.0.0", + "resolved": "https://registry.npmjs.org/slash/-/slash-3.0.0.tgz", + "integrity": "sha512-g9Q1haeby36OSStwb4ntCGGGaKsaVSjQ68fBxoQcutl5fS1vuY18H3wSt3jFyFtrkx+Kz0V1G85A4MyAdDMi2Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=8" + } + }, + "node_modules/slice-ansi": { + "version": "5.0.0", + "resolved": "https://registry.npmjs.org/slice-ansi/-/slice-ansi-5.0.0.tgz", + "integrity": "sha512-FC+lgizVPfie0kkhqUScwRu1O/lF6NOgJmlCgK+/LYxDCTk8sGelYaHDhFcDN+Sn3Cv+3VSa4Byeo+IMCzpMgQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.0.0", + "is-fullwidth-code-point": "^4.0.0" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/slice-ansi?sponsor=1" + } + }, + "node_modules/slice-ansi/node_modules/ansi-styles": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz", + "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/slice-ansi/node_modules/is-fullwidth-code-point": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/is-fullwidth-code-point/-/is-fullwidth-code-point-4.0.0.tgz", + "integrity": "sha512-O4L094N2/dZ7xqVdrXhh9r1KODPJpFms8B5sGdJLPy664AgvXsreZUyCQQNItZRDlYug4xStLjNp/sz3HvBowQ==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, "node_modules/string_decoder": { "version": "1.3.0", "resolved": "https://registry.npmjs.org/string_decoder/-/string_decoder-1.3.0.tgz", @@ -1422,6 +2326,16 @@ "safe-buffer": "~5.2.0" } }, + "node_modules/string-argv": { + "version": "0.3.2", + "resolved": "https://registry.npmjs.org/string-argv/-/string-argv-0.3.2.tgz", + "integrity": "sha512-aqD2Q0144Z+/RqG52NeHEkZauTAUWJO8c6yTftGJKO3Tja5tUgIfmIl6kExvhtxSDP7fXB6DvzkfMpCd/F3G+Q==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=0.6.19" + } + }, "node_modules/string-width": { "version": "4.2.3", "resolved": "https://registry.npmjs.org/string-width/-/string-width-4.2.3.tgz", @@ -1478,6 +2392,19 @@ "node": ">=0.6.0" } }, + "node_modules/to-regex-range": { + "version": "5.0.1", + "resolved": "https://registry.npmjs.org/to-regex-range/-/to-regex-range-5.0.1.tgz", + "integrity": "sha512-65P7iz6X5yEr1cwcgvQxbbIw7Uk3gOy5dIdtZ4rDveLqhrdJP+Li/Hx6tyK0NEb+2GCyneCMJiGqrADCSNk8sQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "is-number": "^7.0.0" + }, + "engines": { + "node": ">=8.0" + } + }, "node_modules/trough": { "version": "2.2.0", "resolved": "https://registry.npmjs.org/trough/-/trough-2.2.0.tgz", @@ -1664,12 +2591,165 @@ "defaults": "^1.0.3" } }, + "node_modules/wrap-ansi": { + "version": "9.0.0", + "resolved": "https://registry.npmjs.org/wrap-ansi/-/wrap-ansi-9.0.0.tgz", + "integrity": "sha512-G8ura3S+3Z2G+mkgNRq8dqaFZAuxfsxpBB8OCTGRTCtp+l/v9nbFNmCUP1BZMts3G1142MsZfn6eeUKrr4PD1Q==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-styles": "^6.2.1", + "string-width": "^7.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/chalk/wrap-ansi?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/ansi-regex": { + "version": "6.1.0", + "resolved": "https://registry.npmjs.org/ansi-regex/-/ansi-regex-6.1.0.tgz", + "integrity": "sha512-7HSX4QQb4CspciLpVFwyRe79O3xsIZDDLER21kERQ71oaPodF8jL725AgJMFAYbooIqolJoRLuM81SpeUkpkvA==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-regex?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/ansi-styles": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-6.2.1.tgz", + "integrity": "sha512-bN798gFfQX+viw3R7yrGWRqnrN2oRkEkUjjl4JNn4E8GxxbjtG3FbrEIIY3l8/hrwUwIeCZvi4QuOTP4MErVug==", + "dev": true, + "license": "MIT", + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/ansi-styles?sponsor=1" + } + }, + "node_modules/wrap-ansi/node_modules/emoji-regex": { + "version": "10.4.0", + "resolved": "https://registry.npmjs.org/emoji-regex/-/emoji-regex-10.4.0.tgz", + "integrity": "sha512-EC+0oUMY1Rqm4O6LLrgjtYDvcVYTy7chDnM4Q7030tP4Kwj3u/pR6gP9ygnp2CJMK5Gq+9Q2oqmrFJAz01DXjw==", + "dev": true, + "license": "MIT" + }, + "node_modules/wrap-ansi/node_modules/string-width": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/string-width/-/string-width-7.2.0.tgz", + "integrity": "sha512-tsaTIkKW9b4N+AEj+SVA+WhJzV7/zMhcSu78mLKWSk7cXMOSHsBKFWUs0fWwq8QyK3MgJBQRX6Gbi4kYbdvGkQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "emoji-regex": "^10.3.0", + "get-east-asian-width": "^1.0.0", + "strip-ansi": "^7.1.0" + }, + "engines": { + "node": ">=18" + }, + "funding": { + "url": "https://github.com/sponsors/sindresorhus" + } + }, + "node_modules/wrap-ansi/node_modules/strip-ansi": { + "version": "7.1.0", + "resolved": "https://registry.npmjs.org/strip-ansi/-/strip-ansi-7.1.0.tgz", + "integrity": "sha512-iq6eVVI64nQQTRYq2KtEg2d2uU7LElhTJwsH4YzIHZshxlgZms/wIc4VoDQTlG/IvVIrBKG06CrZnp0qv7hkcQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "ansi-regex": "^6.0.1" + }, + "engines": { + "node": ">=12" + }, + "funding": { + "url": "https://github.com/chalk/strip-ansi?sponsor=1" + } + }, "node_modules/wrappy": { "version": "1.0.2", "resolved": "https://registry.npmjs.org/wrappy/-/wrappy-1.0.2.tgz", "integrity": "sha512-l4Sp/DRseor9wL6EvV2+TuQn63dMkPjZ/sp9XkghTEbV9KlPS1xUsZ3u7/IQO4wxtcFB4bgpQPRcR3QCvezPcQ==", "license": "ISC" }, + "node_modules/y18n": { + "version": "5.0.8", + "resolved": "https://registry.npmjs.org/y18n/-/y18n-5.0.8.tgz", + "integrity": "sha512-0pfFzegeDWJHJIAmTLRP2DwHjdF5s7jo9tuztdQxAhINCdvS+3nGINqPd00AphqJR/0LhANUS6/+7SCb98YOfA==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, + "node_modules/yaml": { + "version": "2.8.0", + "resolved": "https://registry.npmjs.org/yaml/-/yaml-2.8.0.tgz", + "integrity": "sha512-4lLa/EcQCB0cJkyts+FpIRx5G/llPxfP6VQU5KByHEhLxY3IJCH0f0Hy1MHI8sClTvsIb8qwRJ6R/ZdlDJ/leQ==", + "dev": true, + "license": "ISC", + "bin": { + "yaml": "bin.mjs" + }, + "engines": { + "node": ">= 14.6" + } + }, + "node_modules/yaml-lint": { + "version": "1.7.0", + "resolved": "https://registry.npmjs.org/yaml-lint/-/yaml-lint-1.7.0.tgz", + "integrity": "sha512-zeBC/kskKQo4zuoGQ+IYjw6C9a/YILr2SXoEZA9jM0COrSwvwVbfTiFegT8qYBSBgOwLMWGL8sY137tOmFXGnQ==", + "dev": true, + "license": "MIT", + "dependencies": { + "consola": "^2.15.3", + "globby": "^11.1.0", + "js-yaml": "^4.1.0", + "nconf": "^0.12.0" + }, + "bin": { + "yamllint": "dist/cli.js" + } + }, + "node_modules/yargs": { + "version": "16.2.0", + "resolved": "https://registry.npmjs.org/yargs/-/yargs-16.2.0.tgz", + "integrity": "sha512-D1mvvtDG0L5ft/jGWkLpG1+m0eQxOfaBvTNELraWj22wSVUMWxZUvYgJYcKh6jGGIkJFhH4IZPQhR4TKpc8mBw==", + "dev": true, + "license": "MIT", + "dependencies": { + "cliui": "^7.0.2", + "escalade": "^3.1.1", + "get-caller-file": "^2.0.5", + "require-directory": "^2.1.1", + "string-width": "^4.2.0", + "y18n": "^5.0.5", + "yargs-parser": "^20.2.2" + }, + "engines": { + "node": ">=10" + } + }, + "node_modules/yargs-parser": { + "version": "20.2.9", + "resolved": "https://registry.npmjs.org/yargs-parser/-/yargs-parser-20.2.9.tgz", + "integrity": "sha512-y11nGElTIV+CT3Zv9t7VKl+Q3hTQoT9a1Qzezhhl6Rp21gJ/IVTW7Z3y9EWXhuUBC2Shnf+DX0antecpAwSP8w==", + "dev": true, + "license": "ISC", + "engines": { + "node": ">=10" + } + }, "node_modules/zwitch": { "version": "2.0.4", "resolved": "https://registry.npmjs.org/zwitch/-/zwitch-2.0.4.tgz", diff --git a/package.json b/package.json index f5d7d26c..a9866cb4 100644 --- a/package.json +++ b/package.json @@ -13,17 +13,19 @@ "build:teams": "node tools/cli.js build --teams-only", "list:agents": "node tools/cli.js list:agents", "validate": "node tools/cli.js validate", - "install:bmad": "node tools/installer/bin/bmad.js install" + "install:bmad": "node tools/installer/bin/bmad.js install", + "format": "prettier --write \"**/*.md\" && node tools/yaml-format.js **/*.md **/*.yml **/*.yaml .roo/.roomodes", + "prepare": "husky" }, "dependencies": { - "commander": "^9.4.1", - "js-yaml": "^4.1.0", "@kayvan/markdown-tree-parser": "^1.4.2", "chalk": "^4.1.2", + "commander": "^9.4.1", "fs-extra": "^11.1.0", + "glob": "^8.0.3", "inquirer": "^8.2.5", - "ora": "^5.4.1", - "glob": "^8.0.3" + "js-yaml": "^4.1.0", + "ora": "^5.4.1" }, "keywords": [ "agile", @@ -42,5 +44,22 @@ }, "engines": { "node": ">=14.0.0" + }, + "devDependencies": { + "husky": "^9.1.7", + "lint-staged": "^16.1.1", + "prettier": "^3.5.3", + "yaml-lint": "^1.7.0" + }, + "lint-staged": { + "*.{yml,yaml}": [ + "node tools/yaml-format.js" + ], + "*.md": [ + "node tools/yaml-format.js" + ], + ".roomodes": [ + "node tools/yaml-format.js" + ] } } diff --git a/tools/installer/README.md b/tools/installer/README.md index 6a2550a0..3206b493 100644 --- a/tools/installer/README.md +++ b/tools/installer/README.md @@ -4,7 +4,7 @@ This directory contains the BMAD Method installer implementation. ## Structure -``` +```text installer/ ā”œā”€ā”€ bin/ # CLI entry points ā”‚ ā””ā”€ā”€ bmad.js # Main CLI executable @@ -42,7 +42,7 @@ npx bmad-method install --profile=minimal # Update existing installation npx bmad-method update -``` +```text ## Development @@ -55,4 +55,4 @@ npm test # Lint code npm run lint -``` \ No newline at end of file +``` diff --git a/tools/installer/config/install.config.yml b/tools/installer/config/install.config.yml index 2a0c1771..5f4468e8 100644 --- a/tools/installer/config/install.config.yml +++ b/tools/installer/config/install.config.yml @@ -1,178 +1,139 @@ -# BMAD Method Installation Configuration -# Simplified installer with two options: full copy or single agent - installation-options: full: - name: "Complete BMAD Core" - description: "Copy the entire .bmad-core folder with all agents, templates, and tools" - action: "copy-folder" - source: ".bmad-core" - + name: Complete BMAD Core + description: Copy the entire .bmad-core folder with all agents, templates, and tools + action: copy-folder + source: .bmad-core single-agent: - name: "Single Agent" - description: "Select and install a single agent with its dependencies" - action: "copy-agent" - -# Agent dependency mappings -# These are the core files that should be included with any single agent installation + name: Single Agent + description: Select and install a single agent with its dependencies + action: copy-agent agent-dependencies: core-files: - # Only files that truly every agent needs should go here - # Most dependencies should be declared in the agent YAML itself - - ".bmad-core/utils/template-format.md" - - # Agent-specific dependencies (parsed from agent files or explicitly defined) + - .bmad-core/utils/template-format.md dev: - - ".bmad-core/templates/story-tmpl.md" - - ".bmad-core/checklists/story-dod-checklist.md" - + - .bmad-core/templates/story-tmpl.md + - .bmad-core/checklists/story-dod-checklist.md pm: - - ".bmad-core/templates/prd-tmpl.md" - - ".bmad-core/templates/brownfield-prd-tmpl.md" - - ".bmad-core/checklists/pm-checklist.md" - - ".bmad-core/checklists/change-checklist.md" - - ".bmad-core/tasks/advanced-elicitation.md" - - ".bmad-core/tasks/create-doc.md" - - ".bmad-core/tasks/correct-course.md" - - ".bmad-core/tasks/create-deep-research-prompt.md" - - ".bmad-core/tasks/brownfield-create-epic.md" - - ".bmad-core/tasks/brownfield-create-story.md" - - ".bmad-core/tasks/execute-checklist.md" - - ".bmad-core/tasks/shard-doc.md" - + - .bmad-core/templates/prd-tmpl.md + - .bmad-core/templates/brownfield-prd-tmpl.md + - .bmad-core/checklists/pm-checklist.md + - .bmad-core/checklists/change-checklist.md + - .bmad-core/tasks/advanced-elicitation.md + - .bmad-core/tasks/create-doc.md + - .bmad-core/tasks/correct-course.md + - .bmad-core/tasks/create-deep-research-prompt.md + - .bmad-core/tasks/brownfield-create-epic.md + - .bmad-core/tasks/brownfield-create-story.md + - .bmad-core/tasks/execute-checklist.md + - .bmad-core/tasks/shard-doc.md architect: - - ".bmad-core/templates/architecture-tmpl.md" - - ".bmad-core/checklists/architect-checklist.md" - + - .bmad-core/templates/architecture-tmpl.md + - .bmad-core/checklists/architect-checklist.md sm: - - ".bmad-core/templates/story-tmpl.md" - - ".bmad-core/checklists/story-draft-checklist.md" - - ".bmad-core/workflows/*.yml" - + - .bmad-core/templates/story-tmpl.md + - .bmad-core/checklists/story-draft-checklist.md + - .bmad-core/workflows/*.yml po: - - ".bmad-core/checklists/po-master-checklist.md" - - ".bmad-core/templates/acceptance-criteria-tmpl.md" - + - .bmad-core/checklists/po-master-checklist.md + - .bmad-core/templates/acceptance-criteria-tmpl.md analyst: - - ".bmad-core/templates/prd-tmpl.md" - - ".bmad-core/tasks/advanced-elicitation.md" - + - .bmad-core/templates/prd-tmpl.md + - .bmad-core/tasks/advanced-elicitation.md qa: - - ".bmad-core/checklists/story-dod-checklist.md" - - ".bmad-core/templates/test-plan-tmpl.md" - + - .bmad-core/checklists/story-dod-checklist.md + - .bmad-core/templates/test-plan-tmpl.md ux-expert: - - ".bmad-core/templates/ux-tmpl.md" - - # Meta agents typically need access to more resources + - .bmad-core/templates/ux-tmpl.md bmad-master: - - ".bmad-core/templates/*.md" - - ".bmad-core/tasks/*.md" - - ".bmad-core/schemas/*.yml" - + - .bmad-core/templates/*.md + - .bmad-core/tasks/*.md + - .bmad-core/schemas/*.yml bmad-orchestrator: - - ".bmad-core/agent-teams/*.yml" - - ".bmad-core/workflows/*.yml" - -# IDE-specific configuration for generating rules/commands + - .bmad-core/agent-teams/*.yml + - .bmad-core/workflows/*.yml ide-configurations: cursor: - name: "Cursor" - rule-dir: ".cursor/rules/" - format: "multi-file" - command-suffix: ".mdc" + name: Cursor + rule-dir: .cursor/rules/ + format: multi-file + command-suffix: .mdc instructions: | # To use BMAD agents in Cursor: # 1. Press Ctrl+L (Cmd+L on Mac) to open the chat # 2. Type @agent-name (e.g., "@dev", "@pm", "@architect") # 3. The agent will adopt that persona for the conversation - claude-code: - name: "Claude Code" - rule-dir: ".claude/commands/" - format: "multi-file" - command-suffix: ".md" + name: Claude Code + rule-dir: .claude/commands/ + format: multi-file + command-suffix: .md instructions: | # To use BMAD agents in Claude Code: # 1. Type /agent-name (e.g., "/dev", "/pm", "/architect") # 2. Claude will switch to that agent's persona - windsurf: - name: "Windsurf" - rule-dir: ".windsurf/rules/" - format: "multi-file" - command-suffix: ".md" + name: Windsurf + rule-dir: .windsurf/rules/ + format: multi-file + command-suffix: .md instructions: | # To use BMAD agents in Windsurf: # 1. Type @agent-name (e.g., "@dev", "@pm") # 2. Windsurf will adopt that agent's persona - roo: - name: "Roo Code" - format: "custom-modes" - file: ".roomodes" + name: Roo Code + format: custom-modes + file: .roomodes instructions: | # To use BMAD agents in Roo Code: # 1. Open the mode selector (usually in the status bar) # 2. Select any bmad-{agent} mode (e.g., "bmad-dev", "bmad-pm") # 3. The AI will adopt that agent's full personality and capabilities - cline: - name: "Cline" - # Configuration TBD - needs research - format: "unknown" + name: Cline + format: unknown instructions: | # Cline configuration coming soon # Manual setup: Copy IDE agent files to your Cline configuration - -# Available agents for single-agent installation available-agents: - - id: "analyst" - name: "Business Analyst" - file: ".bmad-core/agents/analyst.md" - description: "Requirements gathering and analysis" - - - id: "pm" - name: "Product Manager" - file: ".bmad-core/agents/pm.md" - description: "Product strategy and roadmap planning" - - - id: "architect" - name: "Solution Architect" - file: ".bmad-core/agents/architect.md" - description: "Technical design and architecture" - - - id: "po" - name: "Product Owner" - file: ".bmad-core/agents/po.md" - description: "Backlog management and prioritization" - - - id: "sm" - name: "Scrum Master" - file: ".bmad-core/agents/sm.md" - description: "Agile process and story creation" - - - id: "dev" - name: "Developer" - file: ".bmad-core/agents/dev.md" - description: "Code implementation and testing" - - - id: "qa" - name: "QA Engineer" - file: ".bmad-core/agents/qa.md" - description: "Quality assurance and testing" - - - id: "ux-expert" - name: "UX Expert" - file: ".bmad-core/agents/ux-expert.md" - description: "User experience design" - - - id: "bmad-master" - name: "BMAD Master" - file: ".bmad-core/agents/bmad-master.md" - description: "BMAD framework expert and guide" - - - id: "bmad-orchestrator" - name: "BMAD Orchestrator" - file: ".bmad-core/agents/bmad-orchestrator.md" - description: "Multi-agent workflow coordinator" + - id: analyst + name: Business Analyst + file: .bmad-core/agents/analyst.md + description: Requirements gathering and analysis + - id: pm + name: Product Manager + file: .bmad-core/agents/pm.md + description: Product strategy and roadmap planning + - id: architect + name: Solution Architect + file: .bmad-core/agents/architect.md + description: Technical design and architecture + - id: po + name: Product Owner + file: .bmad-core/agents/po.md + description: Backlog management and prioritization + - id: sm + name: Scrum Master + file: .bmad-core/agents/sm.md + description: Agile process and story creation + - id: dev + name: Developer + file: .bmad-core/agents/dev.md + description: Code implementation and testing + - id: qa + name: QA Engineer + file: .bmad-core/agents/qa.md + description: Quality assurance and testing + - id: ux-expert + name: UX Expert + file: .bmad-core/agents/ux-expert.md + description: User experience design + - id: bmad-master + name: BMAD Master + file: .bmad-core/agents/bmad-master.md + description: BMAD framework expert and guide + - id: bmad-orchestrator + name: BMAD Orchestrator + file: .bmad-core/agents/bmad-orchestrator.md + description: Multi-agent workflow coordinator diff --git a/tools/installer/lib/ide-setup.js b/tools/installer/lib/ide-setup.js index 2548b5e5..61f0bd21 100644 --- a/tools/installer/lib/ide-setup.js +++ b/tools/installer/lib/ide-setup.js @@ -331,7 +331,7 @@ class IdeSetup { ? roleDefinitionMatch[1].trim() : `You are a ${title} specializing in ${title.toLowerCase()} tasks and responsibilities.`; - // Build mode entry with proper formatting + // Build mode entry with proper formatting (matching exact indentation) newModesContent += ` - slug: bmad-${agentId}\n`; newModesContent += ` name: '${icon} ${title}'\n`; newModesContent += ` roleDefinition: ${roleDefinition}\n`; diff --git a/tools/installer/templates/claude-commands.md b/tools/installer/templates/claude-commands.md index c9a40e28..cef4b437 100644 --- a/tools/installer/templates/claude-commands.md +++ b/tools/installer/templates/claude-commands.md @@ -4,4 +4,4 @@ --- -This is a BMAD Method agent. For more information, visit: https://github.com/your-org/bmad-method \ No newline at end of file +This is a BMAD Method agent. For more information, visit: https://github.com/your-org/bmad-method diff --git a/tools/installer/templates/cursor-rules.md b/tools/installer/templates/cursor-rules.md index 687d2923..6ca03b17 100644 --- a/tools/installer/templates/cursor-rules.md +++ b/tools/installer/templates/cursor-rules.md @@ -15,7 +15,8 @@ This file contains all BMAD Method agent personas. To use an agent, type its nam # Agent Switching To switch between agents during a conversation: + 1. Simply type the new agent name (e.g., "architect" or "dev") 2. The AI will adopt that agent's persona -For more information about BMAD Method, visit: https://github.com/your-org/bmad-method \ No newline at end of file +For more information about BMAD Method, visit: https://github.com/your-org/bmad-method diff --git a/tools/installer/templates/windsurf-rules.md b/tools/installer/templates/windsurf-rules.md index e2aa0e2c..787e5441 100644 --- a/tools/installer/templates/windsurf-rules.md +++ b/tools/installer/templates/windsurf-rules.md @@ -19,4 +19,4 @@ This file contains all BMAD Method agent commands for Windsurf. Use /agent-name - Type `/architect` to switch to Architect persona - And so on for other agents... -For more information about BMAD Method, visit: https://github.com/your-org/bmad-method \ No newline at end of file +For more information about BMAD Method, visit: https://github.com/your-org/bmad-method diff --git a/tools/yaml-format.js b/tools/yaml-format.js new file mode 100755 index 00000000..11780005 --- /dev/null +++ b/tools/yaml-format.js @@ -0,0 +1,211 @@ +#!/usr/bin/env node + +const fs = require('fs'); +const path = require('path'); +const yaml = require('js-yaml'); +const { execSync } = require('child_process'); +const chalk = require('chalk'); + +/** + * YAML Formatter and Linter for BMAD-METHOD + * Formats and validates YAML files and YAML embedded in Markdown + */ + +function formatYamlContent(content, filename) { + try { + // First try to fix common YAML issues + let fixedContent = content + // Fix "commands :" -> "commands:" + .replace(/^(\s*)(\w+)\s+:/gm, '$1$2:') + // Fix inconsistent list indentation + .replace(/^(\s*)-\s{3,}/gm, '$1- '); + + // Skip auto-fixing for .roomodes files - they have special nested structure + if (!filename.includes('.roomodes')) { + fixedContent = fixedContent + // Fix unquoted list items that contain special characters or multiple parts + .replace(/^(\s*)-\s+(.*)$/gm, (match, indent, content) => { + // Skip if already quoted + if (content.startsWith('"') && content.endsWith('"')) { + return match; + } + // If the content contains special YAML characters or looks complex, quote it + // BUT skip if it looks like a proper YAML key-value pair (like "key: value") + if ((content.includes(':') || content.includes('-') || content.includes('{') || content.includes('}')) && + !content.match(/^\w+:\s/)) { + // Remove any existing quotes first, escape internal quotes, then add proper quotes + const cleanContent = content.replace(/^["']|["']$/g, '').replace(/"/g, '\\"'); + return `${indent}- "${cleanContent}"`; + } + return match; + }); + } + + // Debug: show what we're trying to parse + if (fixedContent !== content) { + console.log(chalk.blue(`šŸ”§ Applied YAML fixes to ${filename}`)); + } + + // Parse and re-dump YAML to format it + const parsed = yaml.load(fixedContent); + const formatted = yaml.dump(parsed, { + indent: 2, + lineWidth: -1, // Disable line wrapping + noRefs: true, + sortKeys: false // Preserve key order + }); + return formatted; + } catch (error) { + console.error(chalk.red(`āŒ YAML syntax error in ${filename}:`), error.message); + console.error(chalk.yellow(`šŸ’” Try manually fixing the YAML structure first`)); + return null; + } +} + +function processMarkdownFile(filePath) { + const content = fs.readFileSync(filePath, 'utf8'); + let modified = false; + let newContent = content; + + // Fix untyped code blocks by adding 'text' type + // Match ``` at start of line followed by newline, but only if it's an opening fence + newContent = newContent.replace(/^```\n([\s\S]*?)\n```$/gm, '```text\n$1\n```'); + if (newContent !== content) { + modified = true; + console.log(chalk.blue(`šŸ”§ Added 'text' type to untyped code blocks in ${filePath}`)); + } + + // Find YAML code blocks + const yamlBlockRegex = /```ya?ml\n([\s\S]*?)\n```/g; + + newContent = newContent.replace(yamlBlockRegex, (match, yamlContent) => { + const formatted = formatYamlContent(yamlContent, filePath); + if (formatted === null) { + return match; // Keep original if parsing failed + } + + // Remove trailing newline that js-yaml adds + const trimmedFormatted = formatted.replace(/\n$/, ''); + + if (trimmedFormatted !== yamlContent) { + modified = true; + } + + return `\`\`\`yml\n${trimmedFormatted}\n\`\`\``; + }); + + if (modified) { + fs.writeFileSync(filePath, newContent); + return true; + } + return false; +} + +function processYamlFile(filePath) { + const content = fs.readFileSync(filePath, 'utf8'); + const formatted = formatYamlContent(content, filePath); + + if (formatted === null) { + return false; // Syntax error + } + + if (formatted !== content) { + fs.writeFileSync(filePath, formatted); + return true; + } + return false; +} + +function lintYamlFile(filePath) { + try { + // Use yaml-lint for additional validation + execSync(`npx yaml-lint "${filePath}"`, { stdio: 'pipe' }); + return true; + } catch (error) { + console.error(chalk.red(`āŒ YAML lint error in ${filePath}:`)); + console.error(error.stdout?.toString() || error.message); + return false; + } +} + +function main() { + const args = process.argv.slice(2); + const glob = require('glob'); + + if (args.length === 0) { + console.error('Usage: node yaml-format.js [file2] ...'); + process.exit(1); + } + + let hasErrors = false; + let hasChanges = false; + let filesProcessed = []; + + // Expand glob patterns and collect all files + const allFiles = []; + for (const arg of args) { + if (arg.includes('*')) { + // It's a glob pattern + const matches = glob.sync(arg); + allFiles.push(...matches); + } else { + // It's a direct file path + allFiles.push(arg); + } + } + + for (const filePath of allFiles) { + if (!fs.existsSync(filePath)) { + // Skip silently for glob patterns that don't match anything + if (!args.some(arg => arg.includes('*') && filePath === arg)) { + console.error(chalk.red(`āŒ File not found: ${filePath}`)); + hasErrors = true; + } + continue; + } + + const ext = path.extname(filePath).toLowerCase(); + const basename = path.basename(filePath).toLowerCase(); + + try { + let changed = false; + if (ext === '.md') { + changed = processMarkdownFile(filePath); + } else if (ext === '.yml' || ext === '.yaml' || basename.includes('roomodes') || basename.includes('.yml') || basename.includes('.yaml')) { + // Handle YAML files and special cases like .roomodes + changed = processYamlFile(filePath); + + // Also run linting + const lintPassed = lintYamlFile(filePath); + if (!lintPassed) hasErrors = true; + } else { + // Skip silently for unsupported files + continue; + } + + if (changed) { + hasChanges = true; + filesProcessed.push(filePath); + } + } catch (error) { + console.error(chalk.red(`āŒ Error processing ${filePath}:`), error.message); + hasErrors = true; + } + } + + if (hasChanges) { + console.log(chalk.green(`\nāœØ YAML formatting completed! Modified ${filesProcessed.length} files:`)); + filesProcessed.forEach(file => console.log(chalk.blue(` šŸ“ ${file}`))); + } + + if (hasErrors) { + console.error(chalk.red('\nšŸ’„ Some files had errors. Please fix them before committing.')); + process.exit(1); + } +} + +if (require.main === module) { + main(); +} + +module.exports = { formatYamlContent, processMarkdownFile, processYamlFile }; \ No newline at end of file