@namch/agent-assistant 1.3.0 → 1.3.2

package/documents/business/business-prd.md

@@ -1,400 +0,0 @@
-# Agent Assistant — Product Requirements Document (PRD)
-
-> **Document Type**: Product Requirements Document  
-> **Version**: 1.0  
-> **Status**: Approved  
-> **Last Updated**: 2026-01-26
-
----
-
-## 1. Executive Summary
-
-### 1.1 Product Overview
-
-**Agent Assistant** is an open-source multi-agent orchestration framework that transforms a single AI coding assistant into a coordinated team of 21 specialist agents. It provides structured workflows, quality gates, and 1400+ domain skills for production-grade AI-assisted software development.
-
-### 1.2 Vision Statement
-
-> **"Transform AI-assisted development from ad-hoc prompting into structured, production-grade software engineering."**
-
-### 1.3 Mission Statement
-
-> **"To democratize software engineering excellence by orchestrating AI coding assistants into a cohesive team of 21 specialist agents, enabling developers to ship faster, safer, and more consistently through repeatable workflows and automated quality verification."**
-
-### 1.4 Key Metrics
-
-| Metric | Target | Rationale |
-|--------|--------|-----------|
-| Development Speed | 70% faster | Reduce time-to-production through streamlined workflows |
-| Bug Reduction | 70% fewer | Improve quality through automated verification |
-| Security Issues | 70% fewer | Catch vulnerabilities before production |
-| Token Efficiency | 85% savings | Reduce costs through targeted skill injection |
-
----
-
-## 2. Problem Statement
-
-### 2.1 Core Problem
-
-AI coding assistants are powerful but unstructured. Developers use AI tools in ad-hoc ways, leading to:
-
-- **Inconsistent Results**: Same prompt yields different code quality each time
-- **Missed Quality Checks**: No automated testing, security, or review
-- **Token Waste**: Overloading context with irrelevant information
-- **No Specialization**: Single AI lacks domain expertise
-- **No Traceability**: Outputs disconnected from requirements
-
-### 2.2 Pain Points by User Segment
-
-#### Individual Developers
-
-| Pain Point | Impact | Severity |
-|------------|--------|----------|
-| Inconsistent AI output | 30-50% rework rate | High |
-| No quality gates | Bugs escape to production | Critical |
-| Token waste | $100-500/month in API costs | Medium |
-| Context switching | Reduced velocity | High |
-| Generic solutions | Suboptimal implementations | High |
-
-#### Development Teams
-
-| Pain Point | Impact | Severity |
-|------------|--------|----------|
-| Inconsistent patterns | High maintenance costs | High |
-| No shared conventions | Technical debt accumulation | High |
-| Knowledge silos | Reduced team velocity | Medium |
-| Review burden | Senior developer bottleneck | High |
-| Compliance risk | Audit failures | Critical |
-
-#### Enterprises
-
-| Pain Point | Impact | Severity |
-|------------|--------|----------|
-| Governance gaps | Regulatory risk | Critical |
-| Tool fragmentation | Inconsistent quality | High |
-| Security vulnerabilities | Data breach risk | Critical |
-| Measurement difficulty | Difficult ROI justification | Medium |
-
----
-
-## 3. Target Users
-
-### 3.1 Primary Personas
-
-#### Persona 1: Solo Developer (Alex)
-
-| Attribute | Value |
-|-----------|-------|
-| **Role** | Freelance Full-Stack Developer |
-| **Experience** | 5 years |
-| **AI Usage** | 4-6 hours daily |
-| **Primary Tool** | Cursor |
-| **Key Goal** | Ship client projects faster without sacrificing quality |
-| **Key Pain** | AI generates code that fails in production |
-
-#### Persona 2: Team Lead (Jordan)
-
-| Attribute | Value |
-|-----------|-------|
-| **Role** | Senior Backend Engineer, Team Lead |
-| **Team Size** | 25 developers |
-| **Experience** | 8 years |
-| **AI Usage** | 3-4 hours daily |
-| **Primary Tool** | Claude Code + Cursor |
-| **Key Goal** | Maintain code quality standards across team |
-| **Key Pain** | No way to enforce team conventions via AI |
-
-#### Persona 3: VP Engineering (Priya)
-
-| Attribute | Value |
-|-----------|-------|
-| **Role** | VP of Engineering |
-| **Team Size** | 200 developers |
-| **Experience** | 15 years |
-| **AI Usage** | Indirect oversight |
-| **Primary Tool** | GitHub Copilot Enterprise |
-| **Key Goal** | Improve velocity while maintaining compliance |
-| **Key Pain** | No governance framework for AI development |
-
-### 3.2 User Segmentation
-
-| Segment | Size | Priority | Value Proposition |
-|---------|------|----------|-------------------|
-| Individual Developers | 10M+ | P1 | Productivity + Quality |
-| Small Teams (5-20) | 500K+ | P1 | Consistency + Standards |
-| Medium Teams (20-100) | 100K+ | P2 | Governance + Efficiency |
-| Enterprise (100+) | 10K+ | P2 | Compliance + Scale |
-
----
-
-## 4. Product Requirements
-
-### 4.1 Functional Requirements
-
-#### FR-001: Multi-Agent Orchestration
-
-| ID | Requirement | Priority | Status |
-|----|-------------|----------|--------|
-| FR-001.1 | System SHALL support 21 specialist agents | Must-Have | ✅ Complete |
-| FR-001.2 | System SHALL route tasks to appropriate agents | Must-Have | ✅ Complete |
-| FR-001.3 | System SHALL support tiered execution (sub-agent + embody) | Must-Have | ✅ Complete |
-| FR-001.4 | System SHALL enforce orchestration laws | Must-Have | ✅ Complete |
-| FR-001.5 | System SHALL support agent handoffs | Must-Have | ✅ Complete |
-
-#### FR-002: Command Workflows
-
-| ID | Requirement | Priority | Status |
-|----|-------------|----------|--------|
-| FR-002.1 | System SHALL support 50+ command workflows | Must-Have | ✅ Complete |
-| FR-002.2 | System SHALL support workflow variants (:fast, :hard) | Must-Have | ✅ Complete |
-| FR-002.3 | System SHALL execute phases sequentially | Must-Have | ✅ Complete |
-| FR-002.4 | System SHALL verify exit criteria before phase transition | Must-Have | ✅ Complete |
-| FR-002.5 | System SHALL generate deliverables per phase | Must-Have | ✅ Complete |
-
-#### FR-003: Quality Gates
-
-| ID | Requirement | Priority | Status |
-|----|-------------|----------|--------|
-| FR-003.1 | System SHALL enforce compile gate | Must-Have | ✅ Complete |
-| FR-003.2 | System SHALL enforce lint gate | Must-Have | ✅ Complete |
-| FR-003.3 | System SHALL enforce test gate | Must-Have | ✅ Complete |
-| FR-003.4 | System SHALL enforce security gate | Must-Have | ✅ Complete |
-| FR-003.5 | System SHALL enforce review gate | Must-Have | ✅ Complete |
-
-#### FR-004: Matrix Skill Discovery
-
-| ID | Requirement | Priority | Status |
-|----|-------------|----------|--------|
-| FR-004.1 | System SHALL support 1400+ domain skills | Must-Have | ✅ Complete |
-| FR-004.2 | System SHALL resolve skills based on agent profile | Must-Have | ✅ Complete |
-| FR-004.3 | System SHALL support 19 skill domains | Must-Have | ✅ Complete |
-| FR-004.4 | System SHALL support skill priority scoring | Must-Have | ✅ Complete |
-| FR-004.5 | System SHALL support custom skill additions | Should-Have | ✅ Complete |
-
-#### FR-005: Multi-Tool Support
-
-| ID | Requirement | Priority | Status |
-|----|-------------|----------|--------|
-| FR-005.1 | System SHALL support Claude Code | Must-Have | ✅ Complete |
-| FR-005.2 | System SHALL support Cursor | Must-Have | ✅ Complete |
-| FR-005.3 | System SHALL support GitHub Copilot | Must-Have | ✅ Complete |
-| FR-005.4 | System SHALL support Antigravity/Gemini | Must-Have | ✅ Complete |
-| FR-005.5 | System SHALL support OpenAI Codex | Must-Have | ✅ Complete |
-| FR-005.6 | System SHALL provide CLI installer for all tools | Must-Have | ✅ Complete |
-
-#### FR-006: Documentation Generation
-
-| ID | Requirement | Priority | Status |
-|----|-------------|----------|--------|
-| FR-006.1 | System SHALL generate core technical docs (/docs:core) | Must-Have | ✅ Complete |
-| FR-006.2 | System SHALL generate business docs (/docs:business) | Should-Have | ✅ Complete |
-| FR-006.3 | System SHALL generate audit docs (/docs:audit) | Should-Have | 🔄 Planned |
-| FR-006.4 | System SHALL write all docs in English | Must-Have | ✅ Complete |
-
-### 4.2 Non-Functional Requirements
-
-#### NFR-001: Performance
-
-| ID | Requirement | Target | Priority |
-|----|-------------|--------|----------|
-| NFR-001.1 | Token efficiency | 85% reduction vs ad-hoc | Must-Have |
-| NFR-001.2 | Workflow execution time | < 2x manual equivalent | Should-Have |
-| NFR-001.3 | CLI installation time | < 60 seconds | Should-Have |
-
-#### NFR-002: Reliability
-
-| ID | Requirement | Target | Priority |
-|----|-------------|--------|----------|
-| NFR-002.1 | Workflow completion rate | > 95% | Must-Have |
-| NFR-002.2 | Quality gate pass rate | > 90% first run | Should-Have |
-| NFR-002.3 | Error recovery | Graceful with guidance | Must-Have |
-
-#### NFR-003: Usability
-
-| ID | Requirement | Target | Priority |
-|----|-------------|--------|----------|
-| NFR-003.1 | Time to first workflow | < 5 minutes | Should-Have |
-| NFR-003.2 | Command discoverability | Help available inline | Should-Have |
-| NFR-003.3 | Learning curve | < 1 hour for basics | Should-Have |
-
-#### NFR-004: Maintainability
-
-| ID | Requirement | Target | Priority |
-|----|-------------|--------|----------|
-| NFR-004.1 | Add new skill | Single file change | Must-Have |
-| NFR-004.2 | Add new agent | Template-based | Must-Have |
-| NFR-004.3 | Add new command | Follow patterns | Must-Have |
-
-#### NFR-005: Security
-
-| ID | Requirement | Target | Priority |
-|----|-------------|--------|----------|
-| NFR-005.1 | No credential storage | Zero secrets in framework | Must-Have |
-| NFR-005.2 | No code execution from config | Safe file loading | Must-Have |
-| NFR-005.3 | Security agent enforcement | All :hard workflows | Must-Have |
-
----
-
-## 5. Success Metrics
-
-### 5.1 Key Performance Indicators (KPIs)
-
-| KPI | Metric | Target | Measurement |
-|-----|--------|--------|-------------|
-| Adoption | GitHub Stars | 5,000 | Monthly tracking |
-| Adoption | npm Downloads | 10,000/week | Weekly tracking |
-| Quality | Bug Reduction | 70% | User survey |
-| Efficiency | Token Savings | 85% | Benchmark tests |
-| Satisfaction | NPS Score | > 50 | Quarterly survey |
-
-### 5.2 OKRs
-
-#### Objective 1: Accelerate Developer Adoption
-
-| Key Result | Target | Timeframe |
-|------------|--------|-----------|
-| GitHub Stars | 5,000 | 6 months |
-| npm Weekly Downloads | 10,000 | 6 months |
-| Active Contributors | 50 | 12 months |
-| Documentation Coverage | 100% | 3 months |
-
-#### Objective 2: Prove Production-Ready Quality
-
-| Key Result | Target | Timeframe |
-|------------|--------|-----------|
-| Bug Reduction | 70% | Validated |
-| Quality Gate Pass Rate | 95% | Ongoing |
-| Token Efficiency | 85% | Validated |
-| User NPS | > 50 | Quarterly |
-
-#### Objective 3: Enable Enterprise Adoption
-
-| Key Result | Target | Timeframe |
-|------------|--------|-----------|
-| Enterprise Deployments | 10 teams | 12 months |
-| Audit Documentation | SOC2/GDPR ready | 6 months |
-| Community Skills | 100+ | 12 months |
-
----
-
-## 6. Feature Prioritization
-
-### 6.1 MoSCoW Matrix
-
-#### Must-Have (P0)
-
-| Feature | Description | Status |
-|---------|-------------|--------|
-| 21 Specialist Agents | Domain experts | ✅ Complete |
-| Core Command Workflows | /cook, /fix, /plan, /report, etc. | ✅ Complete |
-| Quality Gates | 5 automated gates | ✅ Complete |
-| Matrix Skill Discovery | 1400+ skills | ✅ Complete |
-| Multi-Tool Support | 4 AI tools | ✅ Complete |
-| CLI Installer | One-command setup | ✅ Complete |
-
-#### Should-Have (P1)
-
-| Feature | Description | Status |
-|---------|-------------|--------|
-| Business Documentation | /docs:business | ✅ Complete |
-| Audit Documentation | /docs:audit | 🔄 Planned |
-| Natural Language Detection | /auto | 🔄 Partial |
-| Workflow Variants | :fast, :hard | ✅ Complete |
-
-#### Could-Have (P2)
-
-| Feature | Description | Status |
-|---------|-------------|--------|
-| Analytics Dashboard | Usage tracking | ❌ Planned |
-| Skill Marketplace | Community discovery | ❌ Planned |
-| IDE Extensions | VS Code, JetBrains | ❌ Planned |
-
-#### Won't-Have (P3)
-
-| Feature | Reason |
-|---------|--------|
-| Hosted Cloud Service | Focus on open-source |
-| Proprietary AI Model | Use existing tools |
-| Mobile App | Desktop-focused |
-
----
-
-## 7. Roadmap
-
-### 7.1 Current Release (v1.0)
-
-| Feature | Status |
-|---------|--------|
-| 21 Specialist Agents | ✅ |
-| 50+ Command Workflows | ✅ |
-| 1400+ Domain Skills | ✅ |
-| Matrix Skill Discovery | ✅ |
-| Multi-Tool Support | ✅ |
-| CLI Installer | ✅ |
-| Core Documentation | ✅ |
-| Business Documentation | ✅ |
-
-### 7.2 Roadmap Themes
-
-| Theme | Focus | Timeframe |
-|-------|-------|-----------|
-| **Developer Experience** | Learning curve, tutorials, IDE extensions | Q1-Q2 |
-| **Enterprise Readiness** | Governance, compliance, audit docs | Q2-Q3 |
-| **Community Growth** | Skill marketplace, contributions | Q2-Q4 |
-| **Quality & Reliability** | Testing, benchmarks, monitoring | Ongoing |
-
----
-
-## 8. Risks and Mitigations
-
-| Risk | Probability | Impact | Mitigation |
-|------|-------------|--------|------------|
-| Learning curve too steep | High | High | Natural language detection, tutorials |
-| AI tool API changes | Medium | High | Abstraction layer, integration tests |
-| Native vendor competition | Medium | High | Cross-tool portability, community |
-| Skill maintenance burden | High | Medium | Community contributions |
-| Enterprise compliance concerns | Medium | High | Audit documentation |
-
----
-
-## 9. Dependencies
-
-### 9.1 External Dependencies
-
-| Dependency | Type | Risk |
-|------------|------|------|
-| Node.js 18+ | Runtime | Low |
-| AI Tool APIs | Integration | Medium |
-| npm Registry | Distribution | Low |
-| GitHub | Hosting | Low |
-
-### 9.2 Internal Dependencies
-
-| Dependency | Type | Owner |
-|------------|------|-------|
-| Agent Definitions | Content | Core Team |
-| Skill Definitions | Content | Community |
-| Rule Files | Configuration | Core Team |
-
----
-
-## 10. Appendix
-
-### 10.1 Glossary
-
-See `business-glossary.md` for complete term definitions.
-
-### 10.2 Related Documents
-
-| Document | Purpose |
-|----------|---------|
-| `business-features.md` | Detailed feature specifications |
-| `business-workflows.md` | User journey documentation |
-| `business-glossary.md` | Term definitions |
-| `knowledge-overview.md` | Technical overview |
-
----
-
-**Document Classification**: Product Requirements  
-**Approval Status**: Approved  
-**Review Cycle**: Quarterly