bmad-enhanced 1.0.0-alpha

package/_bmad-output/README.md

@@ -0,0 +1,228 @@
+# BMAD-Enhanced Planning & Brainstorming Outputs
+
+**Last Updated:** 2026-02-14
+
+---
+
+## Overview
+
+This directory contains all planning artifacts, analysis documents, and brainstorming outputs for the BMAD-Enhanced project.
+
+**Project Goal:** Enhance BMAD Method with domain-specialized agents covering design, quality, and standards domains.
+
+**Architectural Decision:** BMAD-First Architecture with Agent Enhancement (v1.4.0)
+
+---
+
+## 🚨 Major Update (2026-02-14): Domain-Specialized Agents
+
+**Current Approach:** Enhancing BMAD with domain-specialized agents using standard BMAD agent architecture.
+
+**Implementation:**
+- Week 1: Design agents (empathy-mapper, wireframe-designer)
+- Week 2: Quality & standards agents (quality-gatekeeper, standards-auditor)
+- Week 3: Integration testing & decision gate
+
+**Architecture:** All agents built using BMAD Agent Architecture Framework (v1.1.0) - standardized interface supporting any domain expertise.
+
+**See:**
+- [Project README](../README.md) for user-facing documentation
+- [GENERIC-AGENT-INTEGRATION-FRAMEWORK.md](GENERIC-AGENT-INTEGRATION-FRAMEWORK.md) for architecture details
+
+---
+
+## Document Index
+
+### 📋 Planning Artifacts
+
+**Core Decision Documents:**
+- [architectural-decision-record.md](./planning-artifacts/architectural-decision-record.md) ⭐ **START HERE** - BMAD-First Architecture decision (v1.4.0 - Agent Enhancement)
+- [phase-0-implementation-guide.md](./planning-artifacts/phase-0-implementation-guide.md) ⭐ **IMPLEMENTATION READY** - Detailed guide for 4 new agents
+- [ORIGINAL-VISION-README.md](./planning-artifacts/ORIGINAL-VISION-README.md) - Earlier multi-framework vision (archived)
+- [integration-roadmap.md](./planning-artifacts/integration-roadmap.md) - 27-week implementation plan (Phases 0-5) - **SUPERSEDED**
+- [baseartifact-contract-spec.md](./planning-artifacts/baseartifact-contract-spec.md) - Technical foundation v2.0.0 - **DEFERRED**
+
+**Analysis Documents:**
+- [framework-deep-dive-analysis.md](./planning-artifacts/framework-deep-dive-analysis.md) ⭐ **NEW (2026-02-07)** - How BMAD/DesignOS/AgentOS actually work
+- [phase-0-alternative-agent-integration.md](./planning-artifacts/phase-0-alternative-agent-integration.md) - Alternative approach analysis
+- [phase-0-workflow-map.md](./planning-artifacts/phase-0-workflow-map.md) - Original orchestration plan (superseded)
+- [technical-deep-dive-analysis.md](./planning-artifacts/technical-deep-dive-analysis.md) - 50K+ word analysis of all 4 frameworks
+- [architectural-comparison-quint-vs-bmad-first.md](./planning-artifacts/architectural-comparison-quint-vs-bmad-first.md) - Options 1 & 2 comparison
+- [greenfield-architecture-analysis.md](./planning-artifacts/greenfield-architecture-analysis.md) - Option 3 evaluation
+
+**Supporting Documents:**
+- [product-brief-BMAD-Enhanced-2026-02-01.md](./planning-artifacts/product-brief-BMAD-Enhanced-2026-02-01.md) - Product vision and strategy
+- [4-framework-comparison-matrix.md](./planning-artifacts/4-framework-comparison-matrix.md) - Framework capabilities matrix
+- [executive-summary-presentation.md](./planning-artifacts/executive-summary-presentation.md) - Stakeholder presentation
+- [align-command-prototype.md](./planning-artifacts/align-command-prototype.md) - `/align` command specification
+
+---
+
+### 🧠 Brainstorming Outputs (2026-02-05)
+
+**Session Topic:** Phase 0 POC Implementation - Orchestration Capabilities Across All 4 Frameworks
+
+**Core Documents:**
+- [brainstorming-session-2026-02-05.md](./brainstorming/brainstorming-session-2026-02-05.md) ⭐ **Phase 0 Focus** - Complete brainstorming session results
+- [alignment-summary.md](./brainstorming/alignment-summary.md) ⭐ **Critical** - How brainstorming refines ADR decisions
+
+**Reference Materials:**
+- [orchestration-patterns-catalog.md](./brainstorming/orchestration-patterns-catalog.md) - Complete 100-pattern catalog across 15 families
+- [architectural-decision-framework.md](./brainstorming/architectural-decision-framework.md) - 7 foundational dimensions for decisions
+- [llm-agnostic-architecture.md](./brainstorming/llm-agnostic-architecture.md) ⭐ **Critical** - LLM-agnostic design (capabilities vs skills)
+
+---
+
+## Key Decisions Summary
+
+### Architectural Approach: BMAD-First (v1.3.0)
+
+**Foundation:** BMAD Method's proven markdown-based workflow engine
+
+**LLM-Agnostic Design:** Core architecture uses "capabilities" (portable to any LLM). Claude integration exposes as "skills" (slash commands).
+
+**Phase 0 Scope Refinement (2026-02-06):** Defer Quint SQLite integration to Phase 2, focus Phase 0 on pure markdown orchestration.
+
+**Agent Architecture:**
+1. **Standard Interface:** All agents use BMAD Agent Architecture Framework
+   - XML-based agent structure inside markdown code blocks
+   - Standard menu structure (MH, CH, custom workflows, PM, DA)
+   - Fuzzy command matching support
+   - Slash command invocation: `/bmad-agent-{module}-{agent-name}`
+
+2. **Workflow Patterns:** Three architectural patterns available
+   - Pattern 1: Step-file architecture (sequential workflows)
+   - Pattern 2: YAML + instructions (configuration-driven workflows)
+   - Pattern 3: Hybrid (combined approach)
+
+3. **State Management:** BMAD Markdown artifacts
+   - Markdown files are source of truth (Git version control)
+   - Config-driven variables (user_name, communication_language, output_folder)
+   - Output artifacts in `_bmad-output/` directories
+
+4. **Implementation Size (Phased - REVISED 2026-02-07):**
+   - **Phase 0 (Weeks 1-3):** 500 LOC - Agent Enhancement
+     - Emma (empathy-mapper): 235 LOC
+     - Wade (wireframe-designer): 280 LOC
+     - Quinn (quality-gatekeeper): 295 LOC
+     - Stan (standards-auditor): 380 LOC
+     - Cross-agent orchestration: 50 LOC
+     - Total: ~1,240 LOC actual (500 LOC estimate for agents only)
+   - **Phase 2 (Weeks 8-9):** +500 LOC - Quint sync adapter (UNCHANGED)
+     - MD→SQLite Writer (200) + SQLite→MD Reader (150) + Conflict Resolution (50) + Retry Logic (100)
+   - **Total:** 1,000 LOC (vs original 2,300 LOC estimate) - **57% reduction**
+
+---
+
+## Timeline
+
+### Phase 0: POC - Domain-Specialized Agents (Weeks 1-3) ← **CURRENT FOCUS**
+**Goal:** Enhance BMAD with 4 domain-specialized agents for design and quality workflows
+
+**Scope:** Design agents + Quality/standards agents using BMAD agent architecture
+
+**Deliverables:**
+- **Week 1:** Design agents
+  - Emma (empathy-mapper) - User empathy mapping workflows
+  - Wade (wireframe-designer) - Rapid wireframe generation
+- **Week 2:** Quality & standards agents
+  - Quinn (quality-gatekeeper) - Quality gate decision workflows
+  - Stan (standards-auditor) - Code standards compliance checking
+- **Week 3:** Integration & Testing
+  - Cross-agent workflow orchestration
+  - Party mode integration
+  - Documentation & decision gate
+
+**LOC:** ~500 LOC per agent (~1,240 LOC total for 4 agents)
+
+**Decision Gate (Week 3):** Evaluate agent approach success, proceed to Phase 1 or iterate on agent design
+
+---
+
+### Phase 1: Contract Foundation (Weeks 4-7)
+**Goal:** Establish BaseArtifact v2.0.0 foundation
+
+---
+
+### Phase 1: Contract Foundation (Weeks 4-7)
+**Goal:** Establish BaseArtifact foundation and expand agent capabilities
+
+---
+
+### Future Phases: TBD
+**Scope:** Based on Phase 0 decision gate results and user feedback
+
+---
+
+## Pattern Analysis Insights
+
+From [brainstorming-session-2026-02-05.md](./brainstorming/brainstorming-session-2026-02-05.md):
+
+**100 Patterns Explored Across 15 Families:**
+- Integration Interface (Skills, Tools, Steps, Hybrid)
+- State Management (Centralized, Distributed, Event-Sourced, Ephemeral)
+- Reliability (Resilience, Performance, Security, Testing, Debugging)
+- Evolution (Versioning, Experimental Rollout, Living Docs)
+- Multi-Tenancy (Isolation, Collaboration)
+- Intelligence (AI-Augmented Routing, Detection, Healing)
+- Experimental (Edge Computing, Advanced Patterns)
+
+**7 Foundational Dimensions Identified:**
+1. Interface Model (How frameworks expose capabilities)
+2. Control Flow (How execution flows across frameworks)
+3. State Management (Where state lives and how it syncs)
+4. Reliability Strategy (How system handles failures)
+5. Evolution Model (How system changes over time)
+6. Multi-Tenancy Approach (How users/projects coexist)
+7. Intelligence Level (How much AI augmentation)
+
+**Key Insight:** Brainstorming VALIDATED BMAD-First decision and provided implementation clarity (HOW to build orchestration + Quint adapter). Phase 0 scope refinement reduces risk by validating orchestration before database sync complexity.
+
+---
+
+## Quick Navigation
+
+**Starting Phase 0 POC Implementation? (UPDATED 2026-02-14)**
+1. Read: [GENERIC-AGENT-INTEGRATION-FRAMEWORK.md](GENERIC-AGENT-INTEGRATION-FRAMEWORK.md) ⭐ (BMAD Agent Architecture Framework v1.1.0)
+2. Reference: [EMMA-REFERENCE-IMPLEMENTATION-COMPLETE.md](EMMA-REFERENCE-IMPLEMENTATION-COMPLETE.md) ⭐ (Emma reference implementation)
+3. Follow: [phase-0-implementation-guide.md](./planning-artifacts/phase-0-implementation-guide.md) (Complete implementation guide for 4 agents)
+4. Test: [EMMA-TESTING-GUIDE.md](EMMA-TESTING-GUIDE.md) (Testing procedures for agents)
+
+**Need Architecture Details?**
+- Interface contracts: [baseartifact-contract-spec.md](./planning-artifacts/baseartifact-contract-spec.md)
+- Technical deep-dive: [technical-deep-dive-analysis.md](./planning-artifacts/technical-deep-dive-analysis.md)
+- Framework comparison: [4-framework-comparison-matrix.md](./planning-artifacts/4-framework-comparison-matrix.md)
+
+**Workflow Patterns Reference:**
+- Step-file architecture: [_bmad/bme/_designos/workflows/empathy-map/](../_bmad/bme/_designos/workflows/empathy-map/)
+- YAML + instructions: See framework documentation Part 2
+- Hybrid patterns: See framework documentation Part 2
+
+---
+
+## Status
+
+**Decision Status:** ✅ ACCEPTED (BMAD Agent Architecture - Domain Specialization)
+**Implementation Status:** 🚧 Phase 0 POC (Week 1) - Emma created, testing in progress
+**Latest Update:** BMAD Agent Architecture Framework v1.1.0 complete. Emma (empathy-mapper) reference implementation created. Documentation cleaned of external framework references.
+**Next Milestone:** Emma testing completion, then Wade creation (Week 1)
+
+---
+
+## Contributing
+
+All planning documents follow markdown standards with YAML frontmatter for metadata tracking.
+
+**Document Types:**
+- **ADRs** (Architecture Decision Records): Capture key architectural decisions with rationale
+- **Analysis**: Deep-dive technical analysis and comparisons
+- **Planning**: Roadmaps, specifications, timelines
+- **Brainstorming**: Pattern exploration and creative ideation
+
+---
+
+## Contact
+
+**BMAD-Enhanced Core Team**
+**Project Start:** 2026-02-01
+**Latest Update:** 2026-02-14 (Documentation cleanup: removed external framework references, clarified domain-specialized agent approach)

package/index.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+
+/**
+ * BMAD-Enhanced
+ * Domain-Specialized Agents for BMAD Method
+ *
+ * This package provides expert agents for design, quality, and standards workflows:
+ * - Emma (empathy-mapper) - Empathy Mapping Specialist
+ * - Wade (wireframe-designer) - Wireframe Design Expert
+ *
+ * Installation:
+ *   npm install bmad-enhanced
+ *   npm run install:agents
+ *
+ * Documentation:
+ *   - Installation Guide: INSTALLATION.md
+ *   - Emma User Guide: _bmad-output/design-artifacts/EMMA-USER-GUIDE.md
+ *   - Wade User Guide: _bmad-output/design-artifacts/WADE-USER-GUIDE.md
+ *
+ * @version 1.0.0-alpha
+ * @license MIT
+ */
+
+const fs = require('fs');
+const path = require('path');
+
+const BOLD = '\x1b[1m';
+const RESET = '\x1b[0m';
+const CYAN = '\x1b[36m';
+const GREEN = '\x1b[32m';
+
+function main() {
+  console.log('');
+  console.log(`${BOLD}BMAD-Enhanced${RESET} - Domain-Specialized Agents`);
+  console.log('');
+  console.log('Available agents:');
+  console.log(`  ${GREEN}✓${RESET} Emma (empathy-mapper) - Empathy Mapping Specialist`);
+  console.log(`  ${GREEN}✓${RESET} Wade (wireframe-designer) - Wireframe Design Expert`);
+  console.log('');
+  console.log('To install agents:');
+  console.log(`  ${CYAN}npm run install:agents${RESET} - Install all agents`);
+  console.log(`  ${CYAN}npm run install:emma${RESET}   - Install Emma only`);
+  console.log(`  ${CYAN}npm run install:wade${RESET}   - Install Wade only`);
+  console.log('');
+  console.log('Documentation:');
+  console.log(`  ${CYAN}INSTALLATION.md${RESET} - Complete installation guide`);
+  console.log(`  ${CYAN}README.md${RESET}       - Project overview`);
+  console.log('');
+}
+
+// Export installation functions for programmatic use
+module.exports = {
+  version: '1.0.0-alpha',
+  agents: {
+    emma: {
+      id: 'empathy-mapper',
+      name: 'Emma',
+      title: 'Empathy Mapping Specialist',
+      icon: '🎨',
+      path: '_bmad/bme/_designos/agents/empathy-mapper.md'
+    },
+    wade: {
+      id: 'wireframe-designer',
+      name: 'Wade',
+      title: 'Wireframe Design Specialist',
+      icon: '🎨',
+      path: '_bmad/bme/_designos/agents/wireframe-designer.md'
+    }
+  }
+};
+
+// Run CLI if called directly
+if (require.main === module) {
+  main();
+}

package/package.json

@@ -0,0 +1,34 @@
+{
+  "name": "bmad-enhanced",
+  "version": "1.0.0-alpha",
+  "description": "Domain-Specialized Agents for BMAD Method - Expert agents for design, quality, and standards workflows",
+  "main": "index.js",
+  "scripts": {
+    "install:emma": "node scripts/install-emma.js",
+    "install:wade": "node scripts/install-wade.js",
+    "install:agents": "node scripts/install-all-agents.js",
+    "postinstall": "node scripts/postinstall.js"
+  },
+  "keywords": [
+    "bmad",
+    "agents",
+    "empathy-mapping",
+    "wireframing",
+    "design",
+    "ux",
+    "ai-agents"
+  ],
+  "author": "BMAD-Enhanced Community",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/amalik/BMAD-Enhanced.git"
+  },
+  "engines": {
+    "node": ">=14.0.0"
+  },
+  "dependencies": {
+    "chalk": "^4.1.2",
+    "fs-extra": "^11.3.3"
+  }
+}

package/scripts/README.md

@@ -0,0 +1,194 @@
+# BMAD-Enhanced Installation Scripts
+
+This directory contains npm-based installation scripts for BMAD-Enhanced agents.
+
+## Available Scripts
+
+### `install-emma.js`
+Installs Emma (empathy-mapper) agent into your project.
+
+**What it does:**
+- Creates `_bmad/bme/_designos/` directory structure
+- Copies Emma agent file (`empathy-mapper.md`)
+- Copies empathy-map workflow files (6 steps + template)
+- Creates/updates `config.yaml`
+- Updates `agent-manifest.csv`
+- Creates output directory
+
+**Usage:**
+```bash
+npm run install:emma
+```
+
+---
+
+### `install-wade.js`
+Installs Wade (wireframe-designer) agent into your project.
+
+**What it does:**
+- Creates `_bmad/bme/_designos/` directory structure
+- Copies Wade agent file (`wireframe-designer.md`)
+- Copies wireframe workflow files (6 steps + template)
+- Creates/updates `config.yaml`
+- Updates `agent-manifest.csv`
+- Creates output directory
+
+**Usage:**
+```bash
+npm run install:wade
+```
+
+---
+
+### `install-all-agents.js`
+Installs both Emma and Wade agents at once.
+
+**What it does:**
+- All actions from `install-emma.js`
+- All actions from `install-wade.js`
+- Creates unified `config.yaml` with both agents
+- Copies user guides for both agents
+
+**Usage:**
+```bash
+npm run install:agents
+```
+
+---
+
+### `postinstall.js`
+Runs automatically after `npm install` to display installation instructions.
+
+---
+
+## Installation Flow
+
+```
+npm install bmad-enhanced
+       ↓
+postinstall.js runs
+       ↓
+Displays available commands
+       ↓
+User runs: npm run install:agents (or individual agent)
+       ↓
+install-all-agents.js (or individual installer)
+       ↓
+Checks prerequisites
+       ↓
+Copies agent files to _bmad/bme/_designos/
+       ↓
+Creates/updates config.yaml
+       ↓
+Updates agent-manifest.csv
+       ↓
+Creates output directory
+       ↓
+Copies user guides
+       ↓
+Success! Agents ready to use
+```
+
+---
+
+## File Structure Created
+
+```
+your-project/
+├── _bmad/
+│   ├── bme/
+│   │   └── _designos/
+│   │       ├── agents/
+│   │       │   ├── empathy-mapper.md
+│   │       │   └── wireframe-designer.md
+│   │       ├── workflows/
+│   │       │   ├── empathy-map/
+│   │       │   │   ├── workflow.md
+│   │       │   │   ├── empathy-map.template.md
+│   │       │   │   └── steps/
+│   │       │   │       └── step-01 through step-06.md
+│   │       │   └── wireframe/
+│   │       │       ├── workflow.md
+│   │       │       ├── wireframe.template.md
+│   │       │       └── steps/
+│   │       │           └── step-01 through step-06.md
+│   │       └── config.yaml
+│   └── _config/
+│       └── agent-manifest.csv
+└── _bmad-output/
+    └── design-artifacts/
+        ├── EMMA-USER-GUIDE.md
+        └── WADE-USER-GUIDE.md
+```
+
+---
+
+## Configuration
+
+### config.yaml
+```yaml
+user_name: "User"
+communication_language: "English"
+output_folder: "_bmad-output/design-artifacts"
+
+agents:
+  - empathy-mapper     # Emma
+  - wireframe-designer # Wade
+
+workflows:
+  - empathy-map        # Create empathy maps
+  - wireframe          # Create wireframes
+```
+
+You can customize these values after installation.
+
+---
+
+## Troubleshooting
+
+### "Cannot find module 'fs-extra'"
+```bash
+npm install fs-extra chalk
+```
+
+### "Permission denied"
+```bash
+chmod +x scripts/*.js
+```
+
+### "Config already exists"
+The installers will update existing config files rather than overwriting them.
+
+---
+
+## Development
+
+### Testing Installers Locally
+
+```bash
+# Test Emma installer
+node scripts/install-emma.js
+
+# Test Wade installer
+node scripts/install-wade.js
+
+# Test all-agents installer
+node scripts/install-all-agents.js
+```
+
+### Adding New Agents
+
+To add a new agent installer:
+
+1. Copy `install-emma.js` as template
+2. Update agent name, files, and workflows
+3. Add to `package.json` scripts:
+   ```json
+   "install:new-agent": "node scripts/install-new-agent.js"
+   ```
+4. Update `install-all-agents.js` to include new agent
+
+---
+
+**Version:** 1.0.0-alpha
+**Last Updated:** 2026-02-15