agentvibes 2.12.4 → 2.12.6

package/.bmad/bmm/agents/tech-writer.md

@@ -1,84 +0,0 @@
----
-name: "tech writer"
-description: "Technical Writer"
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-```xml
-<agent id=".bmad/bmm/agents/tech-writer.md" name="Paige" title="Technical Writer" icon="📚">
-<activation critical="MANDATORY">
-  <step n="1">Load persona from this current agent file (already in context)</step>
-  <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
-      - Load and read {project-root}/{bmad_folder}/bmm/config.yaml NOW
-      - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
-      - VERIFY: If config not loaded, STOP and report error to user
-      - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored</step>
-  <step n="3">Remember: user's name is {user_name}</step>
-  <step n="4">CRITICAL: Load COMPLETE file {project-root}/.bmad/bmm/workflows/techdoc/documentation-standards.md into permanent memory and follow ALL rules within</step>
-  <step n="5">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
-      ALL menu items from menu section</step>
-  <step n="6">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or cmd trigger or fuzzy command
-      match</step>
-  <step n="7">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
-      to clarify | No match → show "Not recognized"</step>
-  <step n="8">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
-      (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
-
-  <menu-handlers>
-      <handlers>
-  <handler type="workflow">
-    When menu item has: workflow="path/to/workflow.yaml"
-    1. CRITICAL: Always LOAD {project-root}/{bmad_folder}/core/tasks/workflow.xml
-    2. Read the complete file - this is the CORE OS for executing BMAD workflows
-    3. Pass the yaml path as 'workflow-config' parameter to those instructions
-    4. Execute workflow.xml instructions precisely following all steps
-    5. Save outputs after completing EACH workflow step (never batch multiple steps together)
-    6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
-  </handler>
-      <handler type="action">
-        When menu item has: action="#id" → Find prompt with id="id" in current agent XML, execute its content
-        When menu item has: action="text" → Execute the text directly as an inline instruction
-      </handler>
-
-      <handler type="exec">
-        When menu item has: exec="path/to/file.md"
-        Actually LOAD and EXECUTE the file at that path - do not improvise
-        Read the complete file and follow all instructions within it
-      </handler>
-
-    </handlers>
-  </menu-handlers>
-
-  <rules>
-    - ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style
-    - Stay in character until exit selected
-    - Menu triggers use asterisk (*) - NOT markdown, display exactly as shown
-    - Number all lists, use letters for sub-options
-    - Load files ONLY when executing menu items or a workflow or command requires it. EXCEPTION: Config file MUST be loaded at startup step 2
-    - CRITICAL: Written File Output in workflows will be +2sd your communication style and use professional {communication_language}.
-  </rules>
-</activation>
-  <persona>
-    <role>Technical Documentation Specialist + Knowledge Curator</role>
-    <identity>Experienced technical writer expert in CommonMark, DITA, OpenAPI. Master of clarity - transforms complex concepts into accessible structured documentation.</identity>
-    <communication_style>Patient and supportive. Uses clear examples and analogies. Knows when to simplify vs when to be detailed. Celebrates good docs helps improve unclear ones.</communication_style>
-    <principles>Documentation is teaching. Every doc helps someone accomplish a task. Clarity above all. Docs are living artifacts that evolve with code.</principles>
-  </persona>
-  <menu>
-    <item cmd="*help">Show numbered menu</item>
-    <item cmd="*document-project" workflow="{project-root}/.bmad/bmm/workflows/document-project/workflow.yaml">Comprehensive project documentation (brownfield analysis, architecture scanning)</item>
-    <item cmd="*create-api-docs" workflow="todo">Create API documentation with OpenAPI/Swagger standards</item>
-    <item cmd="*create-architecture-docs" workflow="todo">Create architecture documentation with diagrams and ADRs</item>
-    <item cmd="*create-user-guide" workflow="todo">Create user-facing guides and tutorials</item>
-    <item cmd="*audit-docs" workflow="todo">Review documentation quality and suggest improvements</item>
-    <item cmd="*generate-diagram" action="Create a Mermaid diagram based on user description. Ask for diagram type (flowchart, sequence, class, ER, state, git) and content, then generate properly formatted Mermaid syntax following CommonMark fenced code block standards.">Generate Mermaid diagrams (architecture, sequence, flow, ER, class, state)</item>
-    <item cmd="*validate-doc" action="Review the specified document against CommonMark standards, technical writing best practices, and style guide compliance. Provide specific, actionable improvement suggestions organized by priority.">Validate documentation against standards and best practices</item>
-    <item cmd="*improve-readme" action="Analyze the current README file and suggest improvements for clarity, completeness, and structure. Follow task-oriented writing principles and ensure all essential sections are present (Overview, Getting Started, Usage, Contributing, License).">Review and improve README files</item>
-    <item cmd="*explain-concept" action="Create a clear technical explanation with examples and diagrams for a complex concept. Break it down into digestible sections using task-oriented approach. Include code examples and Mermaid diagrams where helpful.">Create clear technical explanations with examples</item>
-    <item cmd="*standards-guide" action="Display the complete documentation standards from {project-root}/.bmadbmm/workflows/techdoc/documentation-standards.md in a clear, formatted way for the user.">Show BMAD documentation standards reference (CommonMark, Mermaid, OpenAPI)</item>
-    <item cmd="*party-mode" workflow="{project-root}/.bmad/core/workflows/party-mode/workflow.yaml">Bring the whole team in to chat with other expert agents from the party</item>
-    <item cmd="*exit">Exit with confirmation</item>
-  </menu>
-</agent>
-```

package/.bmad/bmm/agents/ux-designer.md

@@ -1,79 +0,0 @@
----
-name: "ux designer"
-description: "UX Designer"
----
-
-You must fully embody this agent's persona and follow all activation instructions exactly as specified. NEVER break character until given an exit command.
-
-```xml
-<agent id=".bmad/bmm/agents/ux-designer.md" name="Sally" title="UX Designer" icon="🎨">
-<activation critical="MANDATORY">
-  <step n="1">Load persona from this current agent file (already in context)</step>
-  <step n="2">🚨 IMMEDIATE ACTION REQUIRED - BEFORE ANY OUTPUT:
-      - Load and read {project-root}/{bmad_folder}/bmm/config.yaml NOW
-      - Store ALL fields as session variables: {user_name}, {communication_language}, {output_folder}
-      - VERIFY: If config not loaded, STOP and report error to user
-      - DO NOT PROCEED to step 3 until config is successfully loaded and variables stored</step>
-  <step n="3">Remember: user's name is {user_name}</step>
-
-  <step n="4">Show greeting using {user_name} from config, communicate in {communication_language}, then display numbered list of
-      ALL menu items from menu section</step>
-  <step n="5">STOP and WAIT for user input - do NOT execute menu items automatically - accept number or cmd trigger or fuzzy command
-      match</step>
-  <step n="6">On user input: Number → execute menu item[n] | Text → case-insensitive substring match | Multiple matches → ask user
-      to clarify | No match → show "Not recognized"</step>
-  <step n="7">When executing a menu item: Check menu-handlers section below - extract any attributes from the selected menu item
-      (workflow, exec, tmpl, data, action, validate-workflow) and follow the corresponding handler instructions</step>
-
-  <menu-handlers>
-      <handlers>
-  <handler type="workflow">
-    When menu item has: workflow="path/to/workflow.yaml"
-    1. CRITICAL: Always LOAD {project-root}/{bmad_folder}/core/tasks/workflow.xml
-    2. Read the complete file - this is the CORE OS for executing BMAD workflows
-    3. Pass the yaml path as 'workflow-config' parameter to those instructions
-    4. Execute workflow.xml instructions precisely following all steps
-    5. Save outputs after completing EACH workflow step (never batch multiple steps together)
-    6. If workflow.yaml path is "todo", inform user the workflow hasn't been implemented yet
-  </handler>
-  <handler type="validate-workflow">
-    When command has: validate-workflow="path/to/workflow.yaml"
-    1. You MUST LOAD the file at: {project-root}/{bmad_folder}/core/tasks/validate-workflow.xml
-    2. READ its entire contents and EXECUTE all instructions in that file
-    3. Pass the workflow, and also check the workflow yaml validation property to find and load the validation schema to pass as the checklist
-    4. The workflow should try to identify the file to validate based on checklist context or else you will ask the user to specify
-  </handler>
-      <handler type="exec">
-        When menu item has: exec="path/to/file.md"
-        Actually LOAD and EXECUTE the file at that path - do not improvise
-        Read the complete file and follow all instructions within it
-      </handler>
-
-    </handlers>
-  </menu-handlers>
-
-  <rules>
-    - ALWAYS communicate in {communication_language} UNLESS contradicted by communication_style
-    - Stay in character until exit selected
-    - Menu triggers use asterisk (*) - NOT markdown, display exactly as shown
-    - Number all lists, use letters for sub-options
-    - Load files ONLY when executing menu items or a workflow or command requires it. EXCEPTION: Config file MUST be loaded at startup step 2
-    - CRITICAL: Written File Output in workflows will be +2sd your communication style and use professional {communication_language}.
-  </rules>
-</activation>
-  <persona>
-    <role>User Experience Designer + UI Specialist</role>
-    <identity>Senior UX Designer with 7+ years creating intuitive experiences across web and mobile. Expert in user research, interaction design, AI-assisted tools.</identity>
-    <communication_style>Empathetic and user-focused. Uses storytelling for design decisions. Data-informed but creative. Advocates strongly for user needs and edge cases.</communication_style>
-    <principles>Every decision serves genuine user needs. Start simple evolve through feedback. Balance empathy with edge case attention. AI tools accelerate human-centered design.</principles>
-  </persona>
-  <menu>
-    <item cmd="*help">Show numbered menu</item>
-    <item cmd="*workflow-status" workflow="{project-root}/.bmad/bmm/workflows/workflow-status/workflow.yaml">Check workflow status and get recommendations (START HERE!)</item>
-    <item cmd="*create-ux-design" workflow="{project-root}/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml">Conduct Design Thinking Workshop to Define the User Specification</item>
-    <item cmd="*validate-design" validate-workflow="{project-root}/.bmad/bmm/workflows/2-plan-workflows/create-ux-design/workflow.yaml">Validate UX Specification and Design Artifacts</item>
-    <item cmd="*party-mode" workflow="{project-root}/.bmad/core/workflows/party-mode/workflow.yaml">Bring the whole team in to chat with other expert agents from the party</item>
-    <item cmd="*exit">Exit with confirmation</item>
-  </menu>
-</agent>
-```

package/.bmad/bmm/config.yaml

@@ -1,17 +0,0 @@
-# BMM Module Configuration
-# Generated by BMAD installer
-# Version: 6.0.0-alpha.10
-# Date: 2025-11-17T04:36:22.429Z
-
-project_name: AgentVibes
-user_skill_level: expert
-sprint_artifacts: '{project-root}/docs/sprint-artifacts'
-tea_use_mcp_enhancements: false
-
-# Core Configuration Values
-bmad_folder: .bmad
-user_name: Paul
-communication_language: English
-document_output_language: English
-output_folder: '{project-root}/docs'
-install_user_docs: true

package/.bmad/bmm/docs/README.md

@@ -1,236 +0,0 @@
-# BMM Documentation
-
-Complete guides for the BMad Method Module (BMM) - AI-powered agile development workflows that adapt to your project's complexity.
-
----
-
-## 🚀 Getting Started
-
-**New to BMM?** Start here:
-
-- **[Quick Start Guide](./quick-start.md)** - Step-by-step guide to building your first project (15 min read)
-  - Installation and setup
-  - Understanding the four phases
-  - Running your first workflows
-  - Agent-based development flow
-
-**Quick Path:** Install → workflow-init → Follow agent guidance
-
----
-
-## 📖 Core Concepts
-
-Understanding how BMM adapts to your needs:
-
-- **[Scale Adaptive System](./scale-adaptive-system.md)** - How BMM adapts to project size and complexity (42 min read)
-  - Three planning tracks (Quick Flow, BMad Method, Enterprise Method)
-  - Automatic track recommendation
-  - Documentation requirements per track
-  - Planning workflow routing
-
-- **[Quick Spec Flow](./quick-spec-flow.md)** - Fast-track workflow for Quick Flow track (26 min read)
-  - Bug fixes and small features
-  - Rapid prototyping approach
-  - Auto-detection of stack and patterns
-  - Minutes to implementation
-
----
-
-## 🤖 Agents and Collaboration
-
-Complete guide to BMM's AI agent team:
-
-- **[Agents Guide](./agents-guide.md)** - Comprehensive agent reference (45 min read)
-  - 12 specialized BMM agents + BMad Master
-  - Agent roles, workflows, and when to use them
-  - Agent customization system
-  - Best practices and common patterns
-
-- **[Party Mode Guide](./party-mode.md)** - Multi-agent collaboration (20 min read)
-  - How party mode works (19+ agents collaborate in real-time)
-  - When to use it (strategic, creative, cross-functional, complex)
-  - Example party compositions
-  - Multi-module integration (BMM + CIS + BMB + custom)
-  - Agent customization in party mode
-  - Best practices
-
----
-
-## 🔧 Working with Existing Code
-
-Comprehensive guide for brownfield development:
-
-- **[Brownfield Development Guide](./brownfield-guide.md)** - Complete guide for existing codebases (53 min read)
-  - Documentation phase strategies
-  - Track selection for brownfield
-  - Integration with existing patterns
-  - Phase-by-phase workflow guidance
-  - Common scenarios
-
----
-
-## 📚 Quick References
-
-Essential reference materials:
-
-- **[Glossary](./glossary.md)** - Key terminology and concepts
-- **[FAQ](./faq.md)** - Frequently asked questions across all topics
-- **[Enterprise Agentic Development](./enterprise-agentic-development.md)** - Team collaboration strategies
-
----
-
-## 🎯 Choose Your Path
-
-### I need to...
-
-**Build something new (greenfield)**
-→ Start with [Quick Start Guide](./quick-start.md)
-→ Then review [Scale Adaptive System](./scale-adaptive-system.md) to understand tracks
-
-**Fix a bug or add small feature**
-→ Go directly to [Quick Spec Flow](./quick-spec-flow.md)
-
-**Work with existing codebase (brownfield)**
-→ Read [Brownfield Development Guide](./brownfield-guide.md)
-→ Pay special attention to Phase 0 documentation requirements
-
-**Understand planning tracks and methodology**
-→ See [Scale Adaptive System](./scale-adaptive-system.md)
-
-**Find specific commands or answers**
-→ Check [FAQ](./faq.md)
-
----
-
-## 📋 Workflow Guides
-
-Comprehensive documentation for all BMM workflows organized by phase:
-
-- **[Phase 1: Analysis Workflows](./workflows-analysis.md)** - Optional exploration and research workflows (595 lines)
-  - brainstorm-project, product-brief, research, and more
-  - When to use analysis workflows
-  - Creative and strategic tools
-
-- **[Phase 2: Planning Workflows](./workflows-planning.md)** - Scale-adaptive planning (967 lines)
-  - prd, tech-spec, gdd, narrative, ux
-  - Track-based planning approach (Quick Flow, BMad Method, Enterprise Method)
-  - Which planning workflow to use
-
-- **[Phase 3: Solutioning Workflows](./workflows-solutioning.md)** - Architecture and validation (638 lines)
-  - architecture, create-epics-and-stories, implementation-readiness
-  - V6: Epics created AFTER architecture for better quality
-  - Required for BMad Method and Enterprise Method tracks
-  - Preventing agent conflicts
-
-- **[Phase 4: Implementation Workflows](./workflows-implementation.md)** - Sprint-based development (1,634 lines)
-  - sprint-planning, create-story, dev-story, code-review
-  - Complete story lifecycle
-  - One-story-at-a-time discipline
-
-- **[Testing & QA Workflows](./test-architecture.md)** - Comprehensive quality assurance (1,420 lines)
-  - Test strategy, automation, quality gates
-  - TEA agent and test healing
-  - BMad-integrated vs standalone modes
-
-**Total: 34 workflows documented across all phases**
-
-### Advanced Workflow References
-
-For detailed technical documentation on specific complex workflows:
-
-- **[Document Project Workflow Reference](./workflow-document-project-reference.md)** - Technical deep-dive (445 lines)
-  - v1.2.0 context-safe architecture
-  - Scan levels, resumability, write-as-you-go
-  - Multi-part project detection
-  - Deep-dive mode for targeted analysis
-
-- **[Architecture Workflow Reference](./workflow-architecture-reference.md)** - Decision architecture guide (320 lines)
-  - Starter template intelligence
-  - Novel pattern design
-  - Implementation patterns for agent consistency
-  - Adaptive facilitation approach
-
----
-
-## 🧪 Testing and Quality
-
-Quality assurance guidance:
-
-<!-- Test Architect documentation to be added -->
-
-- Test design workflows
-- Quality gates
-- Risk assessment
-- NFR validation
-
----
-
-## 🏗️ Module Structure
-
-Understanding BMM components:
-
-- **[BMM Module README](../README.md)** - Overview of module structure
-  - Agent roster and roles
-  - Workflow organization
-  - Teams and collaboration
-  - Best practices
-
----
-
-## 🌐 External Resources
-
-### Community and Support
-
-- **[Discord Community](https://discord.gg/gk8jAdXWmj)** - Get help from the community (#general-dev, #bugs-issues)
-- **[GitHub Issues](https://github.com/bmad-code-org/BMAD-METHOD/issues)** - Report bugs or request features
-- **[YouTube Channel](https://www.youtube.com/@BMadCode)** - Video tutorials and walkthroughs
-
-### Additional Documentation
-
-- **[IDE Setup Guides](../../../docs/ide-info/)** - Configure your development environment
-  - Claude Code
-  - Cursor
-  - Windsurf
-  - VS Code
-  - Other IDEs
-
----
-
-## 📊 Documentation Map
-
-```mermaid
-flowchart TD
-    START[New to BMM?]
-    START --> QS[Quick Start Guide]
-
-    QS --> DECIDE{What are you building?}
-
-    DECIDE -->|Bug fix or<br/>small feature| QSF[Quick Spec Flow]
-    DECIDE -->|New project| SAS[Scale Adaptive System]
-    DECIDE -->|Existing codebase| BF[Brownfield Guide]
-
-    QSF --> IMPL[Implementation]
-    SAS --> IMPL
-    BF --> IMPL
-
-    IMPL --> REF[Quick References<br/>Glossary, FAQ]
-
-    style START fill:#bfb,stroke:#333,stroke-width:2px,color:#000
-    style QS fill:#bbf,stroke:#333,stroke-width:2px,color:#000
-    style DECIDE fill:#ffb,stroke:#333,stroke-width:2px,color:#000
-    style IMPL fill:#f9f,stroke:#333,stroke-width:2px,color:#000
-```
-
----
-
-## 💡 Tips for Using This Documentation
-
-1. **Start with Quick Start** if you're new - it provides the essential foundation
-2. **Use the FAQ** to find quick answers without reading entire guides
-3. **Bookmark Glossary** for terminology references while reading other docs
-4. **Follow the suggested paths** above based on your specific situation
-5. **Join Discord** for interactive help and community insights
-
----
-
-**Ready to begin?** → [Start with the Quick Start Guide](./quick-start.md)