@orchestrator-claude/cli 1.7.1 → 1.7.3

package/templates/base/.orchestrator/templates/legacy/tech-debt.md.hbs

@@ -0,0 +1,412 @@
+# Technical Debt Catalog: {{projectName}}
+
+**Generated:** {{generatedAt}}
+**Agent:** code-archaeologist
+**Workflow Phase:** ANALYZE
+**Total Tech Debt Score:** {{techDebtScore}}/100 ({{techDebtLevel}})
+
+---
+
+## Executive Summary
+
+This catalog documents all technical debt identified in the codebase, categorized by type and priority.
+
+**Total Issues:** {{totalIssues}}
+**Estimated Remediation:** {{totalRemediationHours}} hours (~{{totalRemediationWeeks}} weeks)
+**Annual Interest Cost:** ~{{annualInterestCost}} hours/year in maintenance overhead
+
+---
+
+## Debt by Category
+
+| Category | Count | Severity | Remediation | Priority |
+|----------|-------|----------|-------------|----------|
+| **Code Quality** | {{categories.codeQuality.count}} | {{categories.codeQuality.severity}} | {{categories.codeQuality.hours}}h | {{categories.codeQuality.priority}} |
+| **Architecture** | {{categories.architecture.count}} | {{categories.architecture.severity}} | {{categories.architecture.hours}}h | {{categories.architecture.priority}} |
+| **Security** | {{categories.security.count}} | {{categories.security.severity}} | {{categories.security.hours}}h | {{categories.security.priority}} |
+| **Performance** | {{categories.performance.count}} | {{categories.performance.severity}} | {{categories.performance.hours}}h | {{categories.performance.priority}} |
+| **Testing** | {{categories.testing.count}} | {{categories.testing.severity}} | {{categories.testing.hours}}h | {{categories.testing.priority}} |
+| **Documentation** | {{categories.documentation.count}} | {{categories.documentation.severity}} | {{categories.documentation.hours}}h | {{categories.documentation.priority}} |
+| **Dependencies** | {{categories.dependencies.count}} | {{categories.dependencies.severity}} | {{categories.dependencies.hours}}h | {{categories.dependencies.priority}} |
+
+---
+
+## Code Quality Debt
+
+{{#if codeQuality.items}}
+{{#each codeQuality.items}}
+### TD-CQ-{{id}}: {{title}}
+
+- **Severity:** {{severity}}
+- **Location:** `{{location.file}}:{{location.line}}`
+- **Impact:** {{impact}}
+- **Effort:** {{effort}} hours
+- **Interest:** {{interest}}/10 (maintenance overhead)
+
+**Problem:**
+{{problem}}
+
+**Current State:**
+```{{language}}
+{{currentCode}}
+```
+
+**Recommended Solution:**
+{{solution}}
+
+{{#if benefitsOfFixing}}
+**Benefits of Fixing:**
+{{#each benefitsOfFixing}}
+- {{this}}
+{{/each}}
+{{/if}}
+
+**Priority:** {{priority}} - {{priorityReason}}
+
+---
+
+{{/each}}
+{{else}}
+✅ No code quality debt identified.
+{{/if}}
+
+---
+
+## Architecture Debt
+
+{{#if architecture.items}}
+{{#each architecture.items}}
+### TD-ARCH-{{id}}: {{title}}
+
+- **Severity:** {{severity}}
+- **Location:** {{location.module}}
+- **Impact:** {{impact}}
+- **Effort:** {{effort}} hours
+- **Interest:** {{interest}}/10
+
+**Problem:**
+{{problem}}
+
+**Current Architecture:**
+```mermaid
+{{currentArchitectureDiagram}}
+```
+
+**Recommended Architecture:**
+```mermaid
+{{recommendedArchitectureDiagram}}
+```
+
+**Migration Path:**
+{{#each migrationSteps}}
+{{@index}}. {{this}}
+{{/each}}
+
+**Priority:** {{priority}}
+
+---
+
+{{/each}}
+{{else}}
+✅ No architectural debt identified.
+{{/if}}
+
+---
+
+## Security Debt
+
+{{#if security.items}}
+{{#each security.items}}
+### TD-SEC-{{id}}: {{title}}
+
+- **Severity:** ❌ {{severity}}
+- **Location:** `{{location.file}}:{{location.line}}`
+- **CVE/CWE:** {{cve}}
+- **Impact:** {{impact}}
+- **Exploit Risk:** {{exploitRisk}}
+- **Effort:** {{effort}} hours
+
+**Vulnerability:**
+{{vulnerability}}
+
+**Evidence:**
+```{{language}}
+{{vulnerableCode}}
+```
+**NOTE:** Actual sensitive data has been sanitized in this report.
+
+**Fix:**
+{{fix}}
+
+**Priority:** IMMEDIATE - Security vulnerabilities MUST be fixed first
+
+---
+
+{{/each}}
+{{else}}
+✅ No security debt identified.
+{{/if}}
+
+---
+
+## Performance Debt
+
+{{#if performance.items}}
+{{#each performance.items}}
+### TD-PERF-{{id}}: {{title}}
+
+- **Severity:** {{severity}}
+- **Location:** `{{location.file}}:{{location.line}}`
+- **Impact:** {{impact}}
+- **Current Performance:** {{currentPerformance}}
+- **Expected Performance:** {{expectedPerformance}}
+- **Effort:** {{effort}} hours
+
+**Problem:**
+{{problem}}
+
+**Bottleneck:**
+{{bottleneck}}
+
+**Optimization:**
+{{optimization}}
+
+**Priority:** {{priority}}
+
+---
+
+{{/each}}
+{{else}}
+✅ No performance debt identified.
+{{/if}}
+
+---
+
+## Testing Debt
+
+{{#if testing.items}}
+{{#each testing.items}}
+### TD-TEST-{{id}}: {{title}}
+
+- **Severity:** {{severity}}
+- **Location:** {{location.module}}
+- **Impact:** {{impact}}
+- **Current Coverage:** {{currentCoverage}}%
+- **Target Coverage:** {{targetCoverage}}%
+- **Effort:** {{effort}} hours
+
+**Problem:**
+{{problem}}
+
+**Missing Tests:**
+{{#each missingTests}}
+- {{this}}
+{{/each}}
+
+**Recommended Actions:**
+{{#each actions}}
+{{@index}}. {{this}}
+{{/each}}
+
+**Priority:** {{priority}}
+
+---
+
+{{/each}}
+{{else}}
+✅ No testing debt identified.
+{{/if}}
+
+---
+
+## Documentation Debt
+
+{{#if documentation.items}}
+{{#each documentation.items}}
+### TD-DOC-{{id}}: {{title}}
+
+- **Severity:** {{severity}}
+- **Location:** {{location}}
+- **Impact:** {{impact}}
+- **Effort:** {{effort}} hours
+
+**Problem:**
+{{problem}}
+
+**What's Missing:**
+{{#each missing}}
+- {{this}}
+{{/each}}
+
+**Priority:** {{priority}}
+
+---
+
+{{/each}}
+{{else}}
+✅ No documentation debt identified.
+{{/if}}
+
+---
+
+## Dependency Debt
+
+{{#if dependencies.items}}
+{{#each dependencies.items}}
+### TD-DEP-{{id}}: {{title}}
+
+- **Severity:** {{severity}}
+- **Package:** {{package}}
+- **Current Version:** {{currentVersion}}
+- **Latest Version:** {{latestVersion}}
+- **Age:** {{age}}
+- **Security Issues:** {{securityIssues}}
+- **Effort:** {{effort}} hours
+
+**Problem:**
+{{problem}}
+
+**Breaking Changes:**
+{{#if breakingChanges}}
+{{#each breakingChanges}}
+- {{this}}
+{{/each}}
+{{else}}
+None identified
+{{/if}}
+
+**Migration Path:**
+{{migrationPath}}
+
+**Priority:** {{priority}}
+
+---
+
+{{/each}}
+{{else}}
+✅ No dependency debt identified.
+{{/if}}
+
+---
+
+## Prioritized Remediation Roadmap
+
+### Phase 1: Critical (Immediate Action) - {{roadmap.phase1.effort}}h
+
+**Timeline:** 1-2 weeks
+**Focus:** Security vulnerabilities, critical bugs, blocking issues
+
+{{#each roadmap.phase1.items}}
+{{@index}}. {{title}} ({{effort}}h) - `{{location}}`
+{{/each}}
+
+### Phase 2: High Priority (Short-Term) - {{roadmap.phase2.effort}}h
+
+**Timeline:** 1-2 months
+**Focus:** Architecture improvements, major refactoring
+
+{{#each roadmap.phase2.items}}
+{{@index}}. {{title}} ({{effort}}h)
+{{/each}}
+
+### Phase 3: Medium Priority (Medium-Term) - {{roadmap.phase3.effort}}h
+
+**Timeline:** 3-6 months
+**Focus:** Code quality, testing, documentation
+
+{{#each roadmap.phase3.items}}
+{{@index}}. {{title}} ({{effort}}h)
+{{/each}}
+
+### Phase 4: Low Priority (Long-Term) - {{roadmap.phase4.effort}}h
+
+**Timeline:** 6-12 months
+**Focus:** Minor improvements, optimizations
+
+{{#each roadmap.phase4.items}}
+{{@index}}. {{title}} ({{effort}}h)
+{{/each}}
+
+---
+
+## Debt Interest Calculation
+
+Technical debt accrues "interest" in the form of increased maintenance cost:
+
+| Debt Type | Interest Rate | Annual Cost |
+|-----------|---------------|-------------|
+| Security | High (3x) | {{interest.security}}h/year |
+| Architecture | High (2.5x) | {{interest.architecture}}h/year |
+| Code Quality | Medium (1.5x) | {{interest.codeQuality}}h/year |
+| Performance | Medium (1.5x) | {{interest.performance}}h/year |
+| Testing | Medium (2x) | {{interest.testing}}h/year |
+| Documentation | Low (1x) | {{interest.documentation}}h/year |
+| **Total** | - | **{{interest.total}}h/year** |
+
+**Cost Interpretation:**
+- Each hour of unresolved debt costs {{interest.multiplier}}x that in annual maintenance
+- Fixing debt early reduces long-term costs significantly
+- Security debt compounds faster than other types
+
+---
+
+## Quick Wins (Low Effort, High Impact)
+
+{{#if quickWins}}
+These items provide maximum benefit for minimum effort:
+
+{{#each quickWins}}
+{{@index}}. **{{title}}** ({{effort}}h) - {{benefit}}
+   - Location: `{{location}}`
+   - Impact: {{impact}}
+{{/each}}
+{{else}}
+No quick wins identified.
+{{/if}}
+
+---
+
+## Debt Prevention Strategies
+
+To prevent future technical debt:
+
+{{#each preventionStrategies}}
+### {{title}}
+{{description}}
+
+**Actions:**
+{{#each actions}}
+- {{this}}
+{{/each}}
+
+{{/each}}
+
+---
+
+## Monitoring & Metrics
+
+Track these metrics over time to measure debt reduction:
+
+| Metric | Current | Target | Status |
+|--------|---------|--------|--------|
+| Tech Debt Score | {{metrics.current.score}} | {{metrics.target.score}} | {{#if metrics.improving}}⬆️{{else}}⬇️{{/if}} |
+| Total Issues | {{metrics.current.issues}} | {{metrics.target.issues}} | {{#if metrics.improving}}⬆️{{else}}⬇️{{/if}} |
+| Cyclomatic Complexity | {{metrics.current.complexity}} | {{metrics.target.complexity}} | {{#if metrics.improving}}⬆️{{else}}⬇️{{/if}} |
+| Test Coverage | {{metrics.current.coverage}}% | {{metrics.target.coverage}}% | {{#if metrics.improving}}⬆️{{else}}⬇️{{/if}} |
+| Security Issues | {{metrics.current.security}} | {{metrics.target.security}} | {{#if metrics.improving}}⬆️{{else}}⬇️{{/if}} |
+
+---
+
+## Next Steps
+
+1. Review and approve prioritized roadmap
+2. Allocate dedicated time for debt reduction (recommend 20% per sprint)
+3. Start with Phase 1 (Critical items)
+4. Track progress using metrics dashboard
+5. Re-assess debt quarterly
+
+---
+
+**Generated by:** code-archaeologist agent
+**Standards:** AGENT-PROMPT-STANDARDS v1.1
+**RFC:** RFC-004-LEGACY-ANALYSIS-WORKFLOW