claude-autopm 1.27.0 → 1.28.0

package/autopm/.claude/scripts/pm/template-new.js

@@ -0,0 +1,344 @@
+#!/usr/bin/env node
+/**
+ * Template New - Create custom template
+ *
+ * Usage:
+ *   autopm template:new prd my-custom-template
+ *   autopm template:new epic my-sprint-template
+ *   autopm template:new task my-task-template
+ */
+
+const fs = require('fs');
+const path = require('path');
+const { execSync } = require('child_process');
+
+// Dynamically resolve template engine path
+let TemplateEngine;
+try {
+  TemplateEngine = require(path.join(__dirname, '..', '..', '..', '..', 'lib', 'template-engine'));
+} catch (err) {
+  try {
+    TemplateEngine = require(path.join(process.cwd(), 'lib', 'template-engine'));
+  } catch (err2) {
+    TemplateEngine = require('../../../lib/template-engine');
+  }
+}
+
+class TemplateCreator {
+  constructor() {
+    this.templateEngine = new TemplateEngine();
+  }
+
+  /**
+   * Get base template for type
+   */
+  getBaseTemplate(type) {
+    const templates = {
+      prd: `---
+id: {{id}}
+title: {{title}}
+type: prd
+status: draft
+priority: {{priority}}
+created: {{timestamp}}
+author: {{author}}
+timeline: {{timeline}}
+---
+
+# PRD: {{title}}
+
+## Executive Summary
+
+{{executive_summary}}
+
+## Problem Statement
+
+### Background
+{{problem_background}}
+
+### Current State
+{{current_state}}
+
+### Desired State
+{{desired_state}}
+
+## Target Users
+
+{{target_users}}
+
+## Key Features
+
+### Must Have (P0)
+{{#if must_have_features}}
+{{#each must_have_features}}
+- [ ] {{this}}
+{{/each}}
+{{/if}}
+
+### Should Have (P1)
+{{#if should_have_features}}
+{{#each should_have_features}}
+- [ ] {{this}}
+{{/each}}
+{{/if}}
+
+## Success Metrics
+
+{{success_metrics}}
+
+## Technical Requirements
+
+{{technical_requirements}}
+
+## Implementation Plan
+
+### Phase 1: Design (Week 1)
+- [ ] Requirements finalized
+- [ ] Technical design review
+- [ ] Development environment setup
+
+### Phase 2: Development (Week 2-3)
+- [ ] Implement core features
+- [ ] Write tests (TDD)
+- [ ] Code review
+
+### Phase 3: Testing (Week 4)
+- [ ] Integration testing
+- [ ] User acceptance testing
+- [ ] Performance testing
+
+### Phase 4: Release (Week 5)
+- [ ] Documentation
+- [ ] Deployment
+- [ ] Monitoring setup
+
+## Risks and Mitigation
+
+{{risks_and_mitigation}}
+
+## Open Questions
+
+- [ ] {{open_question_1}}
+- [ ] {{open_question_2}}
+
+## Appendix
+
+### Changelog
+- {{timestamp}}: Initial PRD created by {{author}}
+
+---
+
+*Custom PRD Template*
+`,
+      epic: `---
+id: {{id}}
+title: {{title}}
+type: epic
+status: planning
+priority: {{priority}}
+created: {{timestamp}}
+author: {{author}}
+start_date: {{start_date}}
+end_date: {{end_date}}
+---
+
+# Epic: {{title}}
+
+## Overview
+
+{{overview}}
+
+## Goals
+
+{{#each goals}}
+- {{this}}
+{{/each}}
+
+## User Stories
+
+{{#each user_stories}}
+- As a {{role}}, I want to {{action}}, so that {{benefit}}
+{{/each}}
+
+## Tasks
+
+{{#each tasks}}
+- [ ] {{this}}
+{{/each}}
+
+## Success Criteria
+
+{{success_criteria}}
+
+## Dependencies
+
+{{dependencies}}
+
+---
+
+*Custom Epic Template*
+`,
+      task: `---
+id: {{id}}
+title: {{title}}
+type: task
+status: todo
+priority: {{priority}}
+created: {{timestamp}}
+author: {{author}}
+assigned_to: {{assigned_to}}
+estimated_hours: {{estimated_hours}}
+---
+
+# Task: {{title}}
+
+## Description
+
+{{description}}
+
+## Acceptance Criteria
+
+{{#each acceptance_criteria}}
+- [ ] {{this}}
+{{/each}}
+
+## Technical Details
+
+{{technical_details}}
+
+## Testing
+
+{{testing_notes}}
+
+## Notes
+
+{{notes}}
+
+---
+
+*Custom Task Template*
+`
+    };
+
+    return templates[type] || templates.prd;
+  }
+
+  /**
+   * Create new template
+   */
+  create(type, name) {
+    console.log(`\n📝 Creating Custom Template`);
+    console.log(`${'═'.repeat(50)}\n`);
+
+    // Validate type
+    const validTypes = ['prd', 'epic', 'task'];
+    if (!validTypes.includes(type)) {
+      console.error(`❌ Invalid type: ${type}`);
+      console.log(`Valid types: ${validTypes.join(', ')}`);
+      return false;
+    }
+
+    // Ensure template directory exists
+    const typeDir = type === 'prd' ? 'prds' : type === 'epic' ? 'epics' : 'tasks';
+    this.templateEngine.ensureTemplateDir(typeDir);
+
+    const templatePath = path.join('.claude', 'templates', typeDir, `${name}.md`);
+
+    // Check if template already exists
+    if (fs.existsSync(templatePath)) {
+      console.error(`❌ Template already exists: ${templatePath}`);
+      console.log(`💡 Edit file directly or choose a different name`);
+      return false;
+    }
+
+    // Get base template
+    const baseTemplate = this.getBaseTemplate(type);
+
+    // Write template file
+    fs.writeFileSync(templatePath, baseTemplate);
+
+    console.log(`✅ Template created: ${templatePath}`);
+    console.log(`\n📋 Template Structure:`);
+    console.log(`   - Frontmatter: Define metadata variables`);
+    console.log(`   - Variables: Use {{variable_name}} for substitution`);
+    console.log(`   - Conditionals: {{#if var}}...{{/if}}`);
+    console.log(`   - Loops: {{#each items}}...{{/each}}`);
+
+    console.log(`\n🛠️  Next Steps:`);
+    console.log(`   1. Edit template: nano ${templatePath}`);
+    console.log(`   2. Add custom variables and sections`);
+    console.log(`   3. Test template: autopm ${type}:new --template ${name} "Test"`);
+
+    // Try to open in editor
+    this.openInEditor(templatePath);
+
+    return true;
+  }
+
+  /**
+   * Open template in editor
+   */
+  openInEditor(templatePath) {
+    const editors = ['code', 'nano', 'vim', 'vi'];
+
+    for (const editor of editors) {
+      try {
+        // Check if editor exists
+        execSync(`which ${editor}`, { stdio: 'ignore' });
+
+        console.log(`\n📝 Opening in ${editor}...`);
+        console.log(`   Edit the template, save, and exit`);
+
+        // Open editor (blocking)
+        execSync(`${editor} ${templatePath}`, { stdio: 'inherit' });
+
+        // Validate template after editing
+        const content = fs.readFileSync(templatePath, 'utf8');
+        const validation = this.templateEngine.validate(content);
+
+        if (!validation.valid) {
+          console.log(`\n⚠️  Template validation warnings:`);
+          validation.errors.forEach(err => console.log(`   - ${err}`));
+          console.log(`\n💡 These are suggestions. Template will still work.`);
+        } else {
+          console.log(`\n✅ Template is valid!`);
+        }
+
+        return true;
+      } catch (err) {
+        // Editor not found, try next
+        continue;
+      }
+    }
+
+    // No editor found
+    console.log(`\n💡 Edit manually: ${templatePath}`);
+    return false;
+  }
+
+  run(args) {
+    if (args.length < 2) {
+      console.error('❌ Usage: autopm template:new <type> <name>');
+      console.log('\nExamples:');
+      console.log('  autopm template:new prd my-custom-prd');
+      console.log('  autopm template:new epic my-sprint');
+      console.log('  autopm template:new task my-development-task');
+      console.log('\nTypes: prd, epic, task');
+      process.exit(1);
+    }
+
+    const type = args[0];
+    const name = args[1];
+
+    const success = this.create(type, name);
+    process.exit(success ? 0 : 1);
+  }
+}
+
+// Main execution
+if (require.main === module) {
+  const creator = new TemplateCreator();
+  creator.run(process.argv.slice(2));
+}
+
+module.exports = TemplateCreator;

package/autopm/.claude/templates/prds/README.md

@@ -0,0 +1,334 @@
+# Built-in PRD Templates
+
+**Version**: v1.28.0
+**Total Templates**: 5
+**Status**: Production Ready ✅
+
+---
+
+## 📋 Available Templates
+
+### 1. API Feature (`api-feature.md`)
+**Use for**: REST/GraphQL API development
+
+**Best for**:
+- Microservices endpoints
+- Public APIs
+- Internal service APIs
+- Authentication systems
+
+**Includes**:
+- OpenAPI specification (contract-first)
+- JWT authentication & security
+- Performance benchmarks (< 100ms)
+- Rate limiting & error handling
+- Comprehensive testing (TDD)
+
+**Example Variables**:
+```yaml
+title: "User Authentication API"
+api_purpose: "user authentication"
+http_method: "POST"
+api_endpoint: "/api/auth/login"
+auth_method: "JWT"
+rate_limit: "100 req/min"
+```
+
+---
+
+### 2. UI Feature (`ui-feature.md`)
+**Use for**: Frontend components and pages
+
+**Best for**:
+- React/Vue/Angular components
+- Dashboard pages
+- Forms and modals
+- Responsive layouts
+
+**Includes**:
+- WCAG 2.1 AA compliance (legal requirement 2025)
+- Core Web Vitals (LCP, FID, CLS)
+- Mobile-first responsive design
+- Accessibility testing (screen readers)
+- Lighthouse performance targets
+
+**Example Variables**:
+```yaml
+title: "User Dashboard"
+component_type: "Page"
+platform: "Web"
+frontend_framework: "React 18"
+state_management: "Zustand"
+styling_approach: "Tailwind CSS"
+```
+
+---
+
+### 3. Bug Fix (`bug-fix.md`)
+**Use for**: Bug resolution with root cause analysis
+
+**Best for**:
+- Critical production bugs
+- Performance issues
+- Data corruption fixes
+- Security vulnerabilities
+
+**Includes**:
+- 5 Whys root cause analysis
+- Severity classification (P0-P3)
+- Impact analysis (users, revenue, system)
+- Comprehensive rollback plan
+- Post-mortem documentation
+
+**Example Variables**:
+```yaml
+title: "Fix Login Timeout Issue"
+severity: "High"
+bug_id: "BUG-1234"
+affected_users: "5,000 (20%)"
+environment: "Production"
+root_cause: "Database connection pool exhaustion"
+```
+
+---
+
+### 4. Data Migration (`data-migration.md`)
+**Use for**: Database schema changes and data migration
+
+**Best for**:
+- Database migrations
+- Cloud migrations
+- Data consolidation
+- Schema refactoring
+
+**Includes**:
+- Data profiling & quality assessment
+- Migration strategies (Big Bang, Trickle, Phased)
+- Comprehensive validation (pre/post)
+- Performance optimization
+- Rollback procedures
+
+**Example Variables**:
+```yaml
+title: "Migrate User Data to PostgreSQL"
+migration_type: "Platform Migration"
+source_system: "MySQL 5.7"
+target_system: "PostgreSQL 15"
+data_volume: "10M records"
+estimated_duration: "4 hours"
+```
+
+---
+
+### 5. Documentation (`documentation.md`)
+**Use for**: Technical and user documentation
+
+**Best for**:
+- API documentation
+- User guides
+- Developer documentation
+- Runbooks
+- Tutorials
+
+**Includes**:
+- Documentation-as-Code approach
+- WCAG 2.1 AA accessibility
+- SEO optimization
+- Analytics & measurement
+- Localization (i18n) support
+
+**Example Variables**:
+```yaml
+title: "API Reference Documentation"
+doc_type: "API Documentation"
+target_audience: "External Developers"
+delivery_format: "Web (Docusaurus)"
+platform: "GitHub Pages"
+```
+
+---
+
+## 🚀 Quick Start
+
+### Using a Template
+
+```bash
+# With autopm CLI (coming in v1.28.0)
+autopm prd:new --template api-feature "User Authentication API"
+autopm prd:new --template ui-feature "Dashboard Redesign"
+autopm prd:new --template bug-fix "Fix Login Issue"
+autopm prd:new --template data-migration "Migrate to PostgreSQL"
+autopm prd:new --template documentation "API Reference"
+```
+
+### Manual Usage
+
+1. Copy template file to your PRDs directory
+2. Replace `{{variables}}` with actual values
+3. Fill in optional sections as needed
+4. Remove unused sections
+
+---
+
+## 🎯 Template Selection Guide
+
+**Choose based on your feature type**:
+
+| Feature Type | Template | Why |
+|-------------|----------|-----|
+| REST/GraphQL API | `api-feature` | OpenAPI spec, security, performance |
+| Frontend UI | `ui-feature` | WCAG compliance, Core Web Vitals |
+| Production Bug | `bug-fix` | RCA, rollback, post-mortem |
+| Data Work | `data-migration` | Validation, rollback, compliance |
+| Docs Update | `documentation` | Accessibility, SEO, analytics |
+
+---
+
+## 📝 Variable Reference
+
+### Common Variables (All Templates)
+
+**Auto-generated**:
+- `{{id}}` - Sequential ID (prd-001, prd-002...)
+- `{{timestamp}}` - ISO 8601 datetime
+- `{{date}}` - YYYY-MM-DD
+- `{{author}}` - From $USER or git config
+
+**User-provided**:
+- `{{title}}` - Feature/PRD title (required)
+- `{{priority}}` - P0/P1/P2/P3 or Critical/High/Medium/Low
+- `{{timeline}}` - Estimated timeline or "TBD"
+
+### Template-Specific Variables
+
+**api-feature.md**:
+- `{{api_purpose}}`, `{{http_method}}`, `{{api_endpoint}}`
+- `{{auth_method}}`, `{{rate_limit}}`
+- `{{request_body_example}}`, `{{response_body_example}}`
+
+**ui-feature.md**:
+- `{{component_type}}`, `{{platform}}`, `{{frontend_framework}}`
+- `{{wireframe_link}}`, `{{design_link}}`
+- `{{lighthouse_target}}`, `{{usability_score}}`
+
+**bug-fix.md**:
+- `{{severity}}`, `{{bug_id}}`, `{{affected_users}}`
+- `{{root_cause}}`, `{{solution_approach}}`
+- `{{why_1}}` through `{{why_5}}` (5 Whys)
+
+**data-migration.md**:
+- `{{migration_type}}`, `{{source_system}}`, `{{target_system}}`
+- `{{data_volume}}`, `{{migration_strategy}}`
+- `{{source_schema}}`, `{{target_schema}}`
+
+**documentation.md**:
+- `{{doc_type}}`, `{{target_audience}}`, `{{delivery_format}}`
+- `{{platform}}`, `{{content_sections}}`
+- `{{reading_level}}`, `{{adoption_target}}`
+
+---
+
+## ✨ Features
+
+### All Templates Include
+
+✅ **2025 Best Practices**: Context7-verified industry standards
+✅ **TDD Methodology**: Red-Green-Refactor testing approach
+✅ **SMART Goals**: Specific, Measurable, Achievable, Relevant, Time-bound
+✅ **INVEST User Stories**: Independent, Negotiable, Valuable, Estimable, Small, Testable
+✅ **Risk Assessment**: Comprehensive risk analysis and mitigation
+✅ **Rollback Plans**: Detailed rollback procedures and triggers
+✅ **Monitoring**: Metrics, alerts, and observability
+✅ **Communication Plans**: Internal and external stakeholder communication
+
+### Special Features by Template
+
+**API Feature**:
+- OpenAPI/Swagger specification
+- OWASP security compliance
+- Performance targets (p50, p95, p99)
+
+**UI Feature**:
+- WCAG 2.1 AA compliance (legal requirement)
+- Core Web Vitals optimization
+- Cross-browser testing matrix
+
+**Bug Fix**:
+- 5 Whys root cause analysis
+- Post-mortem documentation
+- Prevention strategies
+
+**Data Migration**:
+- Multiple migration strategies
+- Data quality assessment
+- Compliance & security
+
+**Documentation**:
+- Documentation-as-Code
+- SEO optimization
+- Analytics tracking
+
+---
+
+## 📚 References
+
+### Best Practices Sources
+- [PRD Best Practices 2025](https://productschool.com/blog/product-strategy/product-template-requirements-document-prd)
+- [INVEST Criteria](https://ones.com/blog/invest-criteria-scrum-user-stories-guide/)
+- [REST API Design](https://learn.microsoft.com/en-us/azure/architecture/best-practices/api-design)
+- [WCAG 2.1 Guidelines](https://www.w3.org/TR/WCAG21/)
+- [Root Cause Analysis](https://asana.com/resources/root-cause-analysis-template)
+
+### Technical Standards
+- [OpenAPI Specification](https://swagger.io/specification/)
+- [Core Web Vitals](https://web.dev/vitals/)
+- [TDD Methodology](https://martinfowler.com/bliki/TestDrivenDevelopment.html)
+- [SMART Goals](https://www.atlassian.com/blog/productivity/how-to-write-smart-goals)
+
+---
+
+## 🔄 Customization
+
+### Creating Custom Templates
+
+1. **Copy an existing template** as starting point
+2. **Modify sections** to match your needs
+3. **Add/remove variables** as required
+4. **Save to** `.claude/templates/prds/custom-name.md`
+5. **User templates override** built-in templates
+
+### Template Inheritance
+
+Templates support:
+- `{{#if variable}}...{{/if}}` - Conditional sections
+- `{{#each items}}...{{/each}}` - Loops
+- Nested variables and logic
+
+---
+
+## 📊 Template Statistics
+
+| Template | Lines | Size | Variables | Complexity |
+|----------|-------|------|-----------|------------|
+| api-feature.md | 306 | 7.4KB | ~45 | Medium |
+| ui-feature.md | 365 | 10KB | ~60 | High |
+| bug-fix.md | 413 | 9.5KB | ~70 | High |
+| data-migration.md | 483 | 12KB | ~80 | High |
+| documentation.md | 439 | 11KB | ~75 | High |
+
+**Total**: 2,006 lines across 5 templates
+
+---
+
+## 🆘 Support
+
+**Documentation**: See `docs/templates-design.md` for detailed design
+**Implementation**: See `docs/template-engine-implementation.md` for technical details
+**Examples**: See `docs/built-in-templates-summary.md` for comprehensive overview
+
+**Issues**: Report template issues to the ClaudeAutoPM repository
+
+---
+
+*Built-in PRD Templates - v1.28.0*
+*Context7-verified 2025 best practices*