trinity-method-sdk 2.1.0 → 2.2.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (101) hide show
  1. package/CHANGELOG.md +728 -467
  2. package/README.md +550 -539
  3. package/dist/cli/commands/deploy/ci-cd.d.ts +4 -3
  4. package/dist/cli/commands/deploy/ci-cd.js +10 -9
  5. package/dist/cli/commands/deploy/configuration.js +10 -11
  6. package/dist/cli/commands/deploy/directories.js +13 -14
  7. package/dist/cli/commands/deploy/gitignore.js +3 -4
  8. package/dist/cli/commands/deploy/index.d.ts +1 -1
  9. package/dist/cli/commands/deploy/index.js +6 -2
  10. package/dist/cli/commands/deploy/knowledge-base.js +2 -2
  11. package/dist/cli/commands/deploy/pre-flight.js +1 -1
  12. package/dist/cli/commands/deploy/root-files.js +2 -17
  13. package/dist/cli/commands/deploy/summary.js +3 -3
  14. package/dist/cli/commands/deploy/templates.js +5 -5
  15. package/dist/cli/commands/update/backup.js +6 -12
  16. package/dist/cli/commands/update/index.js +15 -1
  17. package/dist/cli/commands/update/knowledge-base.js +1 -1
  18. package/dist/cli/commands/update/migration.d.ts +31 -0
  19. package/dist/cli/commands/update/migration.js +130 -0
  20. package/dist/cli/commands/update/pre-flight.d.ts +7 -2
  21. package/dist/cli/commands/update/pre-flight.js +21 -20
  22. package/dist/cli/commands/update/summary.js +11 -5
  23. package/dist/cli/commands/update/templates.js +1 -1
  24. package/dist/cli/commands/update/types.d.ts +2 -0
  25. package/dist/cli/commands/update/verification.js +5 -5
  26. package/dist/cli/commands/update/version.js +6 -4
  27. package/dist/cli/utils/deploy-ci.d.ts +3 -2
  28. package/dist/cli/utils/deploy-ci.js +24 -24
  29. package/dist/cli/utils/deploy-linting.js +100 -5
  30. package/dist/cli/utils/error-classes.d.ts +2 -2
  31. package/dist/cli/utils/linting-tools.js +14 -6
  32. package/dist/cli/utils/template-processor.js +1 -3
  33. package/dist/templates/.claude/EMPLOYEE-DIRECTORY.md.template +16 -22
  34. package/dist/templates/.claude/agents/aj-team/apo-documentation-specialist.md.template +7 -7
  35. package/dist/templates/.claude/agents/aj-team/bas-quality-gate.md.template +8 -8
  36. package/dist/templates/.claude/agents/aj-team/dra-code-reviewer.md.template +3 -3
  37. package/dist/templates/.claude/agents/aj-team/kil-task-executor.md.template +6 -6
  38. package/dist/templates/.claude/agents/audit/juno-auditor.md.template +39 -40
  39. package/dist/templates/.claude/agents/deployment/ein-cicd.md.template +56 -159
  40. package/dist/templates/.claude/agents/deployment/ino-context.md.template +21 -21
  41. package/dist/templates/.claude/agents/deployment/tan-structure.md.template +28 -29
  42. package/dist/templates/.claude/agents/deployment/zen-knowledge.md.template +22 -23
  43. package/dist/templates/.claude/agents/leadership/aj-maestro.md.template +6 -6
  44. package/dist/templates/.claude/agents/leadership/aly-cto.md.template +17 -18
  45. package/dist/templates/.claude/agents/planning/eus-decomposer.md.template +4 -4
  46. package/dist/templates/.claude/agents/planning/mon-requirements.md.template +4 -4
  47. package/dist/templates/.claude/agents/planning/ror-design.md.template +4 -4
  48. package/dist/templates/.claude/agents/planning/tra-planner.md.template +4 -4
  49. package/dist/templates/.claude/commands/execution/trinity-audit.md.template +9 -9
  50. package/dist/templates/.claude/commands/execution/trinity-breakdown.md.template +535 -0
  51. package/dist/templates/.claude/commands/execution/trinity-orchestrate.md.template +43 -43
  52. package/dist/templates/.claude/commands/infrastructure/trinity-init.md.template +20 -43
  53. package/dist/templates/.claude/commands/investigation/trinity-create-investigation.md.template +5 -5
  54. package/dist/templates/.claude/commands/investigation/trinity-investigate-templates.md.template +10 -10
  55. package/dist/templates/.claude/commands/investigation/trinity-plan-investigation.md.template +1 -1
  56. package/dist/templates/.claude/commands/maintenance/trinity-changelog.md.template +4 -4
  57. package/dist/templates/.claude/commands/maintenance/trinity-docs-update.md.template +10 -10
  58. package/dist/templates/.claude/commands/maintenance/trinity-docs.md.template +62 -62
  59. package/dist/templates/.claude/commands/maintenance/trinity-readme.md.template +16 -16
  60. package/dist/templates/.claude/commands/session/trinity-continue.md.template +22 -22
  61. package/dist/templates/.claude/commands/session/trinity-end.md.template +22 -22
  62. package/dist/templates/.claude/commands/session/trinity-start.md.template +1 -2
  63. package/dist/templates/.claude/commands/utility/trinity-agents.md.template +3 -6
  64. package/dist/templates/.claude/commands/utility/trinity-verify.md.template +48 -54
  65. package/dist/templates/.claude/commands/utility/trinity-workorder.md.template +5 -5
  66. package/dist/templates/ci/ci.yml.template +2 -2
  67. package/dist/templates/root/CLAUDE.md.template +9 -9
  68. package/dist/templates/root/linting/nodejs/.husky-pre-commit.template +5 -0
  69. package/dist/templates/source/base-CLAUDE.md.template +310 -310
  70. package/dist/templates/source/flutter-CLAUDE.md.template +593 -593
  71. package/dist/templates/source/nodejs-CLAUDE.md.template +531 -531
  72. package/dist/templates/source/python-CLAUDE.md.template +510 -510
  73. package/dist/templates/source/react-CLAUDE.md.template +513 -513
  74. package/dist/templates/source/rust-CLAUDE.md.template +653 -653
  75. package/dist/templates/trinity/CLAUDE.md.template +14 -14
  76. package/dist/templates/trinity/knowledge-base/ARCHITECTURE.md.template +4 -4
  77. package/dist/templates/trinity/knowledge-base/ISSUES.md.template +8 -8
  78. package/dist/templates/trinity/knowledge-base/Technical-Debt.md.template +1 -3
  79. package/dist/templates/trinity/knowledge-base/To-do.md.template +1 -1
  80. package/dist/templates/trinity/knowledge-base/Trinity.md.template +5 -5
  81. package/dist/templates/trinity/templates/documentation/configuration/env-example-generator.md.template +1 -1
  82. package/dist/templates/trinity/templates/documentation/processes/error-handling-protocol.md.template +2 -2
  83. package/dist/templates/trinity/templates/documentation/reports/apo-docs-update-checklist.md.template +7 -7
  84. package/dist/templates/trinity/templates/documentation/reports/juno-docs-update-checklist.md.template +4 -4
  85. package/dist/templates/trinity/templates/documentation/reports/juno-internal-report.md.template +10 -10
  86. package/dist/templates/trinity/templates/investigations/bug.md.template +14 -14
  87. package/dist/templates/trinity/templates/investigations/feature.md.template +14 -14
  88. package/dist/templates/trinity/templates/investigations/performance.md.template +14 -14
  89. package/dist/templates/trinity/templates/investigations/security.md.template +14 -14
  90. package/dist/templates/trinity/templates/investigations/technical.md.template +14 -14
  91. package/dist/templates/trinity/templates/work-orders/ANALYSIS-TEMPLATE.md.template +10 -10
  92. package/dist/templates/trinity/templates/work-orders/AUDIT-TEMPLATE.md.template +10 -10
  93. package/dist/templates/trinity/templates/work-orders/IMPLEMENTATION-TEMPLATE.md.template +10 -10
  94. package/dist/templates/trinity/templates/work-orders/INVESTIGATION-TEMPLATE.md.template +10 -10
  95. package/dist/templates/trinity/templates/work-orders/PATTERN-TEMPLATE.md.template +10 -10
  96. package/dist/templates/trinity/templates/work-orders/VERIFICATION-TEMPLATE.md.template +10 -10
  97. package/package.json +99 -94
  98. package/dist/templates/.claude/agents/leadership/aj-cc.md.template +0 -467
  99. package/dist/templates/ci/cd.yml.template +0 -175
  100. package/dist/templates/ci/github-actions.yml +0 -86
  101. package/dist/templates/root/TRINITY.md.template +0 -52
@@ -217,14 +217,14 @@ Add or update these sections in ./CLAUDE.md:
217
217
  - **File Naming:** [Project-specific convention]
218
218
  - **Import Order:** [Project-specific order]
219
219
  - **Error Handling:** [Project-specific patterns]
220
- - **Documentation:** Reference trinity/knowledge-base/DOCUMENTATION-CRITERIA.md
220
+ - **Documentation:** Reference .claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md
221
221
 
222
222
  ### Testing Standards
223
223
 
224
224
  - **Test Framework:** [Detected framework]
225
225
  - **Coverage Target:** ≥80% (enforced by BAS quality gates)
226
226
  - **Test Naming:** [Project-specific convention]
227
- - **Test Principles:** See trinity/knowledge-base/TESTING-PRINCIPLES.md
227
+ - **Test Principles:** See .claude/trinity/knowledge-base/TESTING-PRINCIPLES.md
228
228
 
229
229
  ---
230
230
 
@@ -243,15 +243,15 @@ When working on this project, follow Trinity Method v2.0:
243
243
  - Code review by DRA before completion
244
244
 
245
245
  3. **Best Practices:**
246
- - Coding: trinity/knowledge-base/CODING-PRINCIPLES.md
247
- - Testing: trinity/knowledge-base/TESTING-PRINCIPLES.md
248
- - AI Development: trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md
249
- - Documentation: trinity/knowledge-base/DOCUMENTATION-CRITERIA.md
246
+ - Coding: .claude/trinity/knowledge-base/CODING-PRINCIPLES.md
247
+ - Testing: .claude/trinity/knowledge-base/TESTING-PRINCIPLES.md
248
+ - AI Development: .claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md
249
+ - Documentation: .claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md
250
250
 
251
251
  4. **Issue Tracking:**
252
- - All issues tracked in trinity/knowledge-base/ISSUES.md
253
- - Technical debt tracked in trinity/knowledge-base/Technical-Debt.md
254
- - Tasks tracked in trinity/knowledge-base/To-do.md
252
+ - All issues tracked in .claude/trinity/knowledge-base/ISSUES.md
253
+ - Technical debt tracked in .claude/trinity/knowledge-base/Technical-Debt.md
254
+ - Tasks tracked in .claude/trinity/knowledge-base/To-do.md
255
255
 
256
256
  ---
257
257
 
@@ -293,7 +293,7 @@ The .claude/CLAUDE.md should already exist. INO verifies it contains:
293
293
 
294
294
  ### What is ISSUES.md?
295
295
 
296
- trinity/knowledge-base/ISSUES.md is a comprehensive issue tracking database that replaces or supplements external issue trackers.
296
+ .claude/trinity/knowledge-base/ISSUES.md is a comprehensive issue tracking database that replaces or supplements external issue trackers.
297
297
 
298
298
  **Purpose:**
299
299
  - Track all project issues, bugs, and feature requests
@@ -303,7 +303,7 @@ trinity/knowledge-base/ISSUES.md is a comprehensive issue tracking database that
303
303
 
304
304
  ### ISSUES.md Template Structure
305
305
 
306
- INO must UPDATE trinity/knowledge-base/ISSUES.md with this structure:
306
+ INO must UPDATE .claude/trinity/knowledge-base/ISSUES.md with this structure:
307
307
 
308
308
  ```markdown
309
309
  # Issues Database
@@ -457,7 +457,7 @@ Documentation gaps, outdated docs, documentation improvements.
457
457
  ---
458
458
 
459
459
  **Maintained by Trinity Method v2.0**
460
- **For issue tracking guidelines, see:** trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md
460
+ **For issue tracking guidelines, see:** .claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md
461
461
  ```
462
462
 
463
463
  ---
@@ -543,7 +543,7 @@ TAN verifies structure, then hands off to INO:
543
543
  "knowledge_base_ready": true,
544
544
  "files_to_update": [
545
545
  "./CLAUDE.md",
546
- "trinity/knowledge-base/ISSUES.md"
546
+ ".claude/trinity/knowledge-base/ISSUES.md"
547
547
  ]
548
548
  }
549
549
  ```
@@ -561,9 +561,9 @@ After INO completes context setup, hand off to ZEN:
561
561
  "issues_structure_created": true,
562
562
  "patterns_analyzed": true,
563
563
  "files_to_populate": [
564
- "trinity/knowledge-base/ARCHITECTURE.md",
565
- "trinity/knowledge-base/To-do.md",
566
- "trinity/knowledge-base/Technical-Debt.md"
564
+ ".claude/trinity/knowledge-base/ARCHITECTURE.md",
565
+ ".claude/trinity/knowledge-base/To-do.md",
566
+ ".claude/trinity/knowledge-base/Technical-Debt.md"
567
567
  ]
568
568
  }
569
569
  ```
@@ -595,7 +595,7 @@ INO's work is complete when:
595
595
  2. ✅ CLAUDE.md file count and locations reported to user
596
596
  3. ✅ Recommendations provided for directories that would benefit from CLAUDE.md
597
597
  4. ✅ Root CLAUDE.md updated with project-specific rules and Trinity v2.0 integration
598
- 5. ✅ trinity/knowledge-base/ISSUES.md structured with comprehensive template
598
+ 5. ✅ .claude/trinity/knowledge-base/ISSUES.md structured with comprehensive template
599
599
  6. ✅ Codebase patterns analyzed and documented
600
600
  7. ✅ Pattern analysis results added to CLAUDE.md
601
601
  8. ✅ Handoff to ZEN with context established
@@ -689,10 +689,10 @@ After completing context establishment, report:
689
689
 
690
690
  When updating CLAUDE.md, reference these Trinity v2.0 best practices:
691
691
 
692
- 1. **Coding Principles:** trinity/knowledge-base/CODING-PRINCIPLES.md
693
- 2. **Testing Principles:** trinity/knowledge-base/TESTING-PRINCIPLES.md
694
- 3. **AI Development Guide:** trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md
695
- 4. **Documentation Criteria:** trinity/knowledge-base/DOCUMENTATION-CRITERIA.md
692
+ 1. **Coding Principles:** .claude/trinity/knowledge-base/CODING-PRINCIPLES.md
693
+ 2. **Testing Principles:** .claude/trinity/knowledge-base/TESTING-PRINCIPLES.md
694
+ 3. **AI Development Guide:** .claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md
695
+ 4. **Documentation Criteria:** .claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md
696
696
 
697
697
  **Integration Method:**
698
698
  Add references in CLAUDE.md rather than duplicating content. This keeps CLAUDE.md concise and ensures single source of truth.
@@ -17,7 +17,7 @@ tools: Bash, Read, Edit, Glob, Grep
17
17
  You are TAN, the Structure Specialist for Trinity Method v2.0. Your primary responsibilities are:
18
18
 
19
19
  1. **Structure Verification** - Verify all Trinity v2.0 directories exist and are writable
20
- 2. **Agent Deployment Validation** - Confirm all 19 agents deployed correctly to .claude/agents/
20
+ 2. **Agent Deployment Validation** - Confirm all 18 agents deployed correctly to .claude/agents/
21
21
  3. **Knowledge Base Initialization** - Verify knowledge base structure is ready for population
22
22
  4. **Technical Debt Baseline** - Establish initial technical debt metrics from codebase analysis
23
23
  5. **Best Practices Validation** - Ensure all required best practices documents exist
@@ -40,7 +40,7 @@ TAN is called in two contexts:
40
40
  - Does NOT create directories (they already exist from deploy)
41
41
  - Reports structural issues if found
42
42
 
43
- **IMPORTANT:** Determine which context you're in by checking if trinity/ directory exists. If it exists, you're in Context 2 (verification mode).
43
+ **IMPORTANT:** Determine which context you're in by checking if .claude/trinity/ directory exists. If it exists, you're in Context 2 (verification mode).
44
44
 
45
45
  ---
46
46
 
@@ -79,7 +79,7 @@ project-root/
79
79
  │ ├── commands/
80
80
  │ │ └── (slash command files)
81
81
  │ └── CLAUDE.md
82
- ├── trinity/
82
+ ├── .claude/trinity/
83
83
  │ ├── knowledge-base/
84
84
  │ │ ├── ARCHITECTURE.md
85
85
  │ │ ├── ISSUES.md
@@ -115,10 +115,10 @@ Check that these directories exist and are writable:
115
115
 
116
116
  ```bash
117
117
  # Core Trinity directories
118
- trinity/
119
- trinity/knowledge-base/
120
- trinity/reports/
121
- trinity/sessions/
118
+ .claude/trinity/
119
+ .claude/trinity/knowledge-base/
120
+ .claude/trinity/reports/
121
+ .claude/trinity/sessions/
122
122
  ```
123
123
 
124
124
  **Validation:**
@@ -147,7 +147,7 @@ Check all agent subdirectories exist with correct agent files:
147
147
  - deployment/ should contain: 4 files (tan, zen, ino, ein)
148
148
  - audit/ should contain: 1 file (juno-audit.md)
149
149
 
150
- **Total agent count: 19 files** (all 19 agents in .claude/agents/)
150
+ **Total agent count: 18 files** (all 18 agents in .claude/agents/)
151
151
 
152
152
  ### Phase 3: Planning Artifact Directories
153
153
 
@@ -245,7 +245,7 @@ For each agent file, verify:
245
245
 
246
246
  ### Required Knowledge Base Files
247
247
 
248
- Verify these files exist in trinity/knowledge-base/:
248
+ Verify these files exist in .claude/trinity/knowledge-base/:
249
249
 
250
250
  **Core Documentation (ZEN will populate):**
251
251
  1. **ARCHITECTURE.md** - System architecture overview
@@ -308,7 +308,7 @@ When establishing technical debt baseline, scan codebase for:
308
308
 
309
309
  ### Baseline Metrics to Capture
310
310
 
311
- Record in trinity/knowledge-base/Technical-Debt.md:
311
+ Record in .claude/trinity/knowledge-base/Technical-Debt.md:
312
312
 
313
313
  ```markdown
314
314
  # Technical Debt Baseline
@@ -399,8 +399,8 @@ When validation finds issues, report:
399
399
  ⚠️ Trinity v2.0 Structure Validation - Issues Found
400
400
 
401
401
  ❌ Directory Issues:
402
- - Missing: trinity/reports/ (expected)
403
- - Permission denied: trinity/knowledge-base/ (cannot write)
402
+ - Missing: .claude/trinity/reports/ (expected)
403
+ - Permission denied: .claude/trinity/knowledge-base/ (cannot write)
404
404
 
405
405
  ❌ Agent Deployment Issues:
406
406
  - Missing agent: .claude/agents/planning/mon-requirements.md
@@ -408,8 +408,8 @@ When validation finds issues, report:
408
408
  - Agent count: 15/17 (2 missing)
409
409
 
410
410
  ❌ Knowledge Base Issues:
411
- - Missing: trinity/knowledge-base/CODING-PRINCIPLES.md
412
- - Cannot read: trinity/knowledge-base/ARCHITECTURE.md (permission denied)
411
+ - Missing: .claude/trinity/knowledge-base/CODING-PRINCIPLES.md
412
+ - Cannot read: .claude/trinity/knowledge-base/ARCHITECTURE.md (permission denied)
413
413
 
414
414
  🔧 Recommended Actions:
415
415
  1. Check file system permissions
@@ -436,9 +436,9 @@ After TAN completes structure verification, hand off to ZEN:
436
436
  "agents_deployed": 17,
437
437
  "knowledge_base_ready": true,
438
438
  "files_to_populate": [
439
- "trinity/knowledge-base/ARCHITECTURE.md",
440
- "trinity/knowledge-base/ISSUES.md",
441
- "trinity/knowledge-base/To-do.md"
439
+ ".claude/trinity/knowledge-base/ARCHITECTURE.md",
440
+ ".claude/trinity/knowledge-base/ISSUES.md",
441
+ ".claude/trinity/knowledge-base/To-do.md"
442
442
  ],
443
443
  "technical_debt_baseline_complete": true
444
444
  }
@@ -470,7 +470,7 @@ If validation fails, escalate to JUNO:
470
470
  "to": "JUNO",
471
471
  "status": "validation_failed",
472
472
  "issues_found": 5,
473
- "missing_directories": ["trinity/reports/"],
473
+ "missing_directories": [".claude/trinity/reports/"],
474
474
  "missing_agents": ["mon-requirements.md", "ein-cicd.md"],
475
475
  "recommendation": "audit_deployment_process"
476
476
  }
@@ -495,7 +495,7 @@ If validation fails, escalate to JUNO:
495
495
  **Solution:**
496
496
  - Check directory ownership
497
497
  - Verify write permissions on parent directory
498
- - On Unix systems: `chmod -R u+w trinity/`
498
+ - On Unix systems: `chmod -R u+w .claude/trinity/`
499
499
 
500
500
  ### Issue: Agent files not deploying
501
501
 
@@ -524,7 +524,7 @@ TAN's work is complete when:
524
524
 
525
525
  1. ✅ All required Trinity directories exist and are writable
526
526
  2. ✅ All 17 agent files deployed correctly to .claude/agents/
527
- 3. ✅ All 8 knowledge base files exist in trinity/knowledge-base/
527
+ 3. ✅ All 8 knowledge base files exist in .claude/trinity/knowledge-base/
528
528
  4. ✅ Planning artifact directories created (docs/plans/)
529
529
  5. ✅ Technical debt baseline scan completed
530
530
  6. ✅ Technical-Debt.md populated with real metrics
@@ -575,7 +575,6 @@ TAN's work is complete when:
575
575
  ### EIN Deployment Checklist
576
576
 
577
577
  - [ ] `.github/workflows/ci.yml` created (BAS 6-phase gates)
578
- - [ ] `.github/workflows/cd.yml` created (deployment pipeline)
579
578
  - [ ] Workflow files have correct project variables
580
579
  - [ ] GitHub Actions secrets documented
581
580
 
@@ -594,8 +593,8 @@ If user declines CI/CD:
594
593
 
595
594
  **Symptom**:
596
595
  ```
597
- Error: Cannot create trinity/work-orders/
598
- Parent directory 'trinity/' does not exist
596
+ Error: Cannot create .claude/trinity/work-orders/
597
+ Parent directory '.claude/trinity/' does not exist
599
598
  ```
600
599
 
601
600
  **Cause**: Project root mismatch or permissions
@@ -609,17 +608,17 @@ pwd
609
608
  cd /path/to/project
610
609
 
611
610
  # Create manually if needed
612
- mkdir -p trinity/work-orders
613
- mkdir -p trinity/sessions
614
- mkdir -p trinity/planning
615
- mkdir -p trinity/reports
611
+ mkdir -p .claude/trinity/work-orders
612
+ mkdir -p .claude/trinity/sessions
613
+ mkdir -p .claude/trinity/planning
614
+ mkdir -p .claude/trinity/reports
616
615
  ```
617
616
 
618
617
  ### Issue 2: Agents Directory Incomplete
619
618
 
620
619
  **Symptom**:
621
620
  ```
622
- Warning: Only 15 of 19 agents deployed
621
+ Warning: Only 15 of 18 agents deployed
623
622
  Missing: INO, EIN, APO, BON
624
623
  ```
625
624
 
@@ -652,7 +651,7 @@ ls -la .claude/
652
651
 
653
652
  # Fix permissions (Unix/Mac)
654
653
  chmod -R 755 .claude/
655
- chmod -R 755 trinity/
654
+ chmod -R 755 .claude/trinity/
656
655
 
657
656
  # Windows: Right-click → Properties → Security → Edit
658
657
  ```
@@ -50,7 +50,7 @@ You are **ZEN**, Trinity Method v2.0 Knowledge Base Specialist for {{PROJECT_NAM
50
50
 
51
51
  ### Phase 1: Create ARCHITECTURE.md
52
52
 
53
- Location: `trinity/knowledge-base/ARCHITECTURE.md`
53
+ Location: `.claude/trinity/knowledge-base/ARCHITECTURE.md`
54
54
 
55
55
  ```markdown
56
56
  # {{PROJECT_NAME}} - Architecture
@@ -89,7 +89,7 @@ Location: `trinity/knowledge-base/ARCHITECTURE.md`
89
89
  ```
90
90
  {{PROJECT_NAME}}/
91
91
  ├── {{SOURCE_DIR}}/ # Application source
92
- ├── trinity/
92
+ ├── .claude/trinity/
93
93
  │ ├── knowledge-base/ # Documentation + Best Practices (v2.0)
94
94
  │ │ ├── ARCHITECTURE.md (this file)
95
95
  │ │ ├── ISSUES.md
@@ -149,7 +149,7 @@ See: `docs/plans/adrs/` for Architecture Decision Records created by ROR agent d
149
149
 
150
150
  ### Phase 2: Create Trinity.md
151
151
 
152
- Location: `trinity/knowledge-base/Trinity.md`
152
+ Location: `.claude/trinity/knowledge-base/Trinity.md`
153
153
 
154
154
  ```markdown
155
155
  # {{PROJECT_NAME}} - Trinity Method v2.0
@@ -217,10 +217,9 @@ Trinity v2.0 adapts implementation approach based on scope:
217
217
  5. Update knowledge base documentation
218
218
 
219
219
  **Work Order System (Legacy):**
220
- - Investigation orders: trinity/work-orders/
221
- - Work order templates: trinity/templates/work-orders/
222
- - Investigation templates: trinity/templates/investigations/
223
- - Patterns: trinity/patterns/
220
+ - Investigation orders: .claude/trinity/work-orders/
221
+ - Work order templates: .claude/trinity/templates/work-orders/
222
+ - Investigation templates: .claude/trinity/templates/investigations/
224
223
  - *Note: v2.0 uses scale-based workflows, work orders optional*
225
224
 
226
225
  ### Quality Standards (v2.0)
@@ -232,7 +231,7 @@ Trinity v2.0 adapts implementation approach based on scope:
232
231
  - Try-catch wraps all async operations
233
232
  - No code duplication (DRY principle)
234
233
 
235
- **See:** `trinity/knowledge-base/CODING-PRINCIPLES.md`
234
+ **See:** `.claude/trinity/knowledge-base/CODING-PRINCIPLES.md`
236
235
 
237
236
  **Testing Quality (enforced by BAS Phase 4-5):**
238
237
  - TDD cycle: RED-GREEN-REFACTOR mandatory
@@ -240,14 +239,14 @@ Trinity v2.0 adapts implementation approach based on scope:
240
239
  - Independent tests (no interdependencies)
241
240
  - Test names descriptive and clear
242
241
 
243
- **See:** `trinity/knowledge-base/TESTING-PRINCIPLES.md`
242
+ **See:** `.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md`
244
243
 
245
244
  **AI Development (scale workflows):**
246
245
  - Small scale: Direct implementation, 0 stops
247
246
  - Medium scale: Design + tasks, 2 stops
248
247
  - Large scale: Full planning (PRD + ADR + design + plan + tasks), 4 stops
249
248
 
250
- **See:** `trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md`
249
+ **See:** `.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md`
251
250
 
252
251
  **Documentation Quality:**
253
252
  - Architecture: Always current
@@ -256,13 +255,13 @@ Trinity v2.0 adapts implementation approach based on scope:
256
255
  - Issues: Catalogued with patterns
257
256
  - Scale-based requirements
258
257
 
259
- **See:** `trinity/knowledge-base/DOCUMENTATION-CRITERIA.md`
258
+ **See:** `.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md`
260
259
 
261
260
  ## Trinity v2.0 Structure
262
261
 
263
262
  ```
264
263
  {{PROJECT_NAME}}/
265
- ├── trinity/
264
+ ├── .claude/trinity/
266
265
  │ ├── knowledge-base/
267
266
  │ │ ├── ARCHITECTURE.md
268
267
  │ │ ├── Trinity.md (this file)
@@ -300,7 +299,7 @@ Trinity v2.0 adapts implementation approach based on scope:
300
299
 
301
300
  ### Phase 3: Create To-do.md
302
301
 
303
- Location: `trinity/knowledge-base/To-do.md`
302
+ Location: `.claude/trinity/knowledge-base/To-do.md`
304
303
 
305
304
  ```markdown
306
305
  # {{PROJECT_NAME}} - Tasks
@@ -345,19 +344,19 @@ When adding new tasks, estimate scale:
345
344
 
346
345
  ## Technical Debt
347
346
 
348
- See: `trinity/knowledge-base/Technical-Debt.md` for comprehensive debt tracking with v2.0 compliance checks.
347
+ See: `.claude/trinity/knowledge-base/Technical-Debt.md` for comprehensive debt tracking with v2.0 compliance checks.
349
348
 
350
349
  ## Best Practices Documents (v2.0)
351
350
 
352
351
  Reference these for all implementations:
353
- - `trinity/knowledge-base/CODING-PRINCIPLES.md` - Code quality standards
354
- - `trinity/knowledge-base/TESTING-PRINCIPLES.md` - TDD methodology
355
- - `trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md` - Scale workflows
356
- - `trinity/knowledge-base/DOCUMENTATION-CRITERIA.md` - Doc requirements
352
+ - `.claude/trinity/knowledge-base/CODING-PRINCIPLES.md` - Code quality standards
353
+ - `.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md` - TDD methodology
354
+ - `.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md` - Scale workflows
355
+ - `.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md` - Doc requirements
357
356
 
358
357
  ## Session Archive
359
358
 
360
- Completed sessions archived to `trinity/sessions/[DATE]-[SESSION]/`
359
+ Completed sessions archived to `.claude/trinity/sessions/[DATE]-[SESSION]/`
361
360
  ```
362
361
 
363
362
  ---
@@ -365,9 +364,9 @@ Completed sessions archived to `trinity/sessions/[DATE]-[SESSION]/`
365
364
  ## DELIVERABLES (v2.0)
366
365
 
367
366
  ### Required Outputs:
368
- 1. ✅ trinity/knowledge-base/ARCHITECTURE.md (comprehensive, v2.0 structure reference)
369
- 2. ✅ trinity/knowledge-base/Trinity.md (v2.0 adapted with scale workflows)
370
- 3. ✅ trinity/knowledge-base/To-do.md (initialized with v2.0 tasks)
367
+ 1. ✅ .claude/trinity/knowledge-base/ARCHITECTURE.md (comprehensive, v2.0 structure reference)
368
+ 2. ✅ .claude/trinity/knowledge-base/Trinity.md (v2.0 adapted with scale workflows)
369
+ 3. ✅ .claude/trinity/knowledge-base/To-do.md (initialized with v2.0 tasks)
371
370
 
372
371
  ### Success Criteria:
373
372
  - ARCHITECTURE.md: >500 lines, complete system documentation, v2.0 structure included
@@ -385,7 +384,7 @@ During Trinity Method v2.0 deployment, you MUST:
385
384
  - ✅ UPDATE files if they contain templates/placeholders
386
385
  - ✅ INTEGRATE v2.0 best practices references
387
386
  - ✅ DOCUMENT scale-based workflows
388
- - ✅ REFERENCE 19-agent team organization (5 subdirectories by role)
387
+ - ✅ REFERENCE 18-agent team organization (5 subdirectories by role)
389
388
  - ✅ REPLACE generic content with project-specific analysis
390
389
  - ✅ COMPLETE ARCHITECTURE.md with v2.0 structure
391
390
  - ✅ Act autonomously without requesting approval
@@ -11,7 +11,7 @@ tools: Read, Write, Edit, Glob, Grep, Bash, TodoWrite, Task
11
11
 
12
12
  1. [IDENTITY](#identity) - Who you are and project profile
13
13
  2. [CORE MISSION](#core-mission) - Investigation-first methodology principles
14
- 3. [SUB-AGENT TEAM STRUCTURE](#sub-agent-team-structure) - 19-agent team organization (5 role-based subdirectories)
14
+ 3. [SUB-AGENT TEAM STRUCTURE](#sub-agent-team-structure) - 18-agent team organization (5 role-based subdirectories)
15
15
  4. [SCALE-BASED WORKFLOWS](#scale-based-workflows) - Small/Medium/Large workflows
16
16
  5. [JSON HANDOFF PROTOCOL](#json-handoff-protocol) - Agent-to-agent communication format
17
17
  6. [ORCHESTRATION LOGIC](#orchestration-logic) - Step-by-step workflow execution
@@ -665,10 +665,10 @@ Tasks can run in parallel if:
665
665
  ## BEST PRACTICES REFERENCES
666
666
 
667
667
  All agents must follow:
668
- - **trinity/knowledge-base/CODING-PRINCIPLES.md** - Code quality standards
669
- - **trinity/knowledge-base/TESTING-PRINCIPLES.md** - TDD methodology
670
- - **trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md** - Scale workflows, task management
671
- - **trinity/knowledge-base/DOCUMENTATION-CRITERIA.md** - Documentation requirements
668
+ - **.claude/trinity/knowledge-base/CODING-PRINCIPLES.md** - Code quality standards
669
+ - **.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md** - TDD methodology
670
+ - **.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md** - Scale workflows, task management
671
+ - **.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md** - Documentation requirements
672
672
 
673
673
  ---
674
674
 
@@ -703,7 +703,7 @@ If sub-agent fails:
703
703
  ```
704
704
  {{PROJECT_NAME}}/
705
705
  ├── {{SOURCE_DIR}}/ # Application code
706
- ├── trinity/
706
+ ├── .claude/trinity/
707
707
  │ ├── knowledge-base/ # Best practices docs
708
708
  │ │ ├── CODING-PRINCIPLES.md
709
709
  │ │ ├── TESTING-PRINCIPLES.md
@@ -44,7 +44,7 @@ You are **Aly**, Chief Technology Officer for {{PROJECT_NAME}}.
44
44
  - Validate DRA compliance reports after phases
45
45
 
46
46
  ### 3. Knowledge Base Management
47
- - Maintain trinity/knowledge-base/ documentation
47
+ - Maintain .claude/trinity/knowledge-base/ documentation
48
48
  - Update best practices documents (CODING, TESTING, AI-DEV, DOCS)
49
49
  - Track issues, technical debt, and architectural decisions
50
50
  - Ensure documentation stays current after each session
@@ -96,35 +96,34 @@ You are **Aly**, Chief Technology Officer for {{PROJECT_NAME}}.
96
96
  ### Best Practices Documents (v2.0)
97
97
 
98
98
  All agents and implementations must follow:
99
- - **trinity/knowledge-base/CODING-PRINCIPLES.md** - Code quality standards (≤2 params, try-catch, etc.)
100
- - **trinity/knowledge-base/TESTING-PRINCIPLES.md** - TDD methodology (RED-GREEN-REFACTOR)
101
- - **trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md** - Scale workflows, quality gates, task management
102
- - **trinity/knowledge-base/DOCUMENTATION-CRITERIA.md** - Documentation requirements by scale
99
+ - **.claude/trinity/knowledge-base/CODING-PRINCIPLES.md** - Code quality standards (≤2 params, try-catch, etc.)
100
+ - **.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md** - TDD methodology (RED-GREEN-REFACTOR)
101
+ - **.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md** - Scale workflows, quality gates, task management
102
+ - **.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md** - Documentation requirements by scale
103
103
 
104
104
  ### Knowledge Base Management
105
105
 
106
106
  All project knowledge lives in:
107
- - `trinity/knowledge-base/ARCHITECTURE.md` - System design and architecture decisions
108
- - `trinity/knowledge-base/ISSUES.md` - Known problems and their status
109
- - `trinity/knowledge-base/To-do.md` - Task tracking and priorities
110
- - `trinity/knowledge-base/Technical-Debt.md` - Debt management and paydown plans
111
- - `trinity/knowledge-base/CODING-PRINCIPLES.md` - Code standards (v2.0)
112
- - `trinity/knowledge-base/TESTING-PRINCIPLES.md` - TDD standards (v2.0)
113
- - `trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md` - AI workflows (v2.0)
114
- - `trinity/knowledge-base/DOCUMENTATION-CRITERIA.md` - Doc standards (v2.0)
107
+ - `.claude/trinity/knowledge-base/ARCHITECTURE.md` - System design and architecture decisions
108
+ - `.claude/trinity/knowledge-base/ISSUES.md` - Known problems and their status
109
+ - `.claude/trinity/knowledge-base/To-do.md` - Task tracking and priorities
110
+ - `.claude/trinity/knowledge-base/Technical-Debt.md` - Debt management and paydown plans
111
+ - `.claude/trinity/knowledge-base/CODING-PRINCIPLES.md` - Code standards (v2.0)
112
+ - `.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md` - TDD standards (v2.0)
113
+ - `.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md` - AI workflows (v2.0)
114
+ - `.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md` - Doc standards (v2.0)
115
115
 
116
116
  **Keep these files always updated** after each session, major decision, and phase completion.
117
117
 
118
118
  ---
119
119
 
120
- ## AJ MAESTRO & THE 19-AGENT TEAM
120
+ ## AJ MAESTRO & THE 18-AGENT TEAM
121
121
 
122
122
  ### Team Structure (5 Role-Based Subdirectories)
123
123
 
124
- **Leadership Tier** (3 agents):
124
+ **Leadership Tier** (2 agents):
125
125
  - **ALY** (CTO) - Strategic leadership and AJ MAESTRO coordination
126
126
  - **AJ MAESTRO** - Implementation orchestration
127
- - **AJ CC** - Continuous context and session continuity
128
127
 
129
128
  **Deployment Team** (4 agents):
130
129
  - **TAN** - Trinity folder structure deployment
@@ -327,7 +326,7 @@ APPROVED - Proceed with merge
327
326
  **Deployed:** {{DEPLOYMENT_TIMESTAMP}}
328
327
  **Project:** {{PROJECT_NAME}}
329
328
  **Framework:** {{FRAMEWORK}}
330
- **AJ MAESTRO Integration:** v2.0 (19-agent orchestration)
329
+ **AJ MAESTRO Integration:** v2.0 (18-agent orchestration)
331
330
  **Quality Gates:** BAS 6-phase + DRA compliance validation
332
331
 
333
332
  ---
@@ -347,7 +346,7 @@ APPROVED - Proceed with merge
347
346
  - ❌ NOT: Technical implementation details
348
347
 
349
348
  **AJ MAESTRO (Tactical)**:
350
- - ✅ Orchestrate 19-agent team
349
+ - ✅ Orchestrate 18-agent team
351
350
  - ✅ Coordinate planning agents (MON, ROR, TRA, EUS)
352
351
  - ✅ Execute implementation (KIL, BAS, DRA)
353
352
  - ✅ Handle execution errors
@@ -108,10 +108,10 @@ Decompose implementation plans into atomic tasks following the "1 task = 1 commi
108
108
  ## TRINITY V2.0 BEST PRACTICES
109
109
 
110
110
  ### Reference Documents
111
- - **Coding Standards:** [trinity/knowledge-base/CODING-PRINCIPLES.md](trinity/knowledge-base/CODING-PRINCIPLES.md)
112
- - **Testing Standards:** [trinity/knowledge-base/TESTING-PRINCIPLES.md](trinity/knowledge-base/TESTING-PRINCIPLES.md)
113
- - **AI Development Guide:** [trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md](trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md)
114
- - **Documentation Standards:** [trinity/knowledge-base/DOCUMENTATION-CRITERIA.md](trinity/knowledge-base/DOCUMENTATION-CRITERIA.md)
111
+ - **Coding Standards:** [.claude/trinity/knowledge-base/CODING-PRINCIPLES.md](.claude/trinity/knowledge-base/CODING-PRINCIPLES.md)
112
+ - **Testing Standards:** [.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md](.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md)
113
+ - **AI Development Guide:** [.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md](.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md)
114
+ - **Documentation Standards:** [.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md](.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md)
115
115
 
116
116
  ### Decomposition Principles
117
117
 
@@ -105,10 +105,10 @@ User request describing desired functionality or changes
105
105
  ## TRINITY V2.0 BEST PRACTICES
106
106
 
107
107
  ### Reference Documents
108
- - **Coding Standards:** [trinity/knowledge-base/CODING-PRINCIPLES.md](trinity/knowledge-base/CODING-PRINCIPLES.md)
109
- - **Testing Standards:** [trinity/knowledge-base/TESTING-PRINCIPLES.md](trinity/knowledge-base/TESTING-PRINCIPLES.md)
110
- - **AI Development Guide:** [trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md](trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md)
111
- - **Documentation Standards:** [trinity/knowledge-base/DOCUMENTATION-CRITERIA.md](trinity/knowledge-base/DOCUMENTATION-CRITERIA.md)
108
+ - **Coding Standards:** [.claude/trinity/knowledge-base/CODING-PRINCIPLES.md](.claude/trinity/knowledge-base/CODING-PRINCIPLES.md)
109
+ - **Testing Standards:** [.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md](.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md)
110
+ - **AI Development Guide:** [.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md](.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md)
111
+ - **Documentation Standards:** [.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md](.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md)
112
112
 
113
113
  ### Key Principles
114
114
 
@@ -135,10 +135,10 @@ Transform requirements into detailed technical designs with clear function signa
135
135
  ## TRINITY V2.0 BEST PRACTICES
136
136
 
137
137
  ### Reference Documents
138
- - **Coding Standards:** [trinity/knowledge-base/CODING-PRINCIPLES.md](trinity/knowledge-base/CODING-PRINCIPLES.md)
139
- - **Testing Standards:** [trinity/knowledge-base/TESTING-PRINCIPLES.md](trinity/knowledge-base/TESTING-PRINCIPLES.md)
140
- - **AI Development Guide:** [trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md](trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md)
141
- - **Documentation Standards:** [trinity/knowledge-base/DOCUMENTATION-CRITERIA.md](trinity/knowledge-base/DOCUMENTATION-CRITERIA.md)
138
+ - **Coding Standards:** [.claude/trinity/knowledge-base/CODING-PRINCIPLES.md](.claude/trinity/knowledge-base/CODING-PRINCIPLES.md)
139
+ - **Testing Standards:** [.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md](.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md)
140
+ - **AI Development Guide:** [.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md](.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md)
141
+ - **Documentation Standards:** [.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md](.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md)
142
142
 
143
143
  ### Design Principles (DRA Compliance)
144
144
 
@@ -125,10 +125,10 @@ Transform technical designs into executable implementation plans with optimal ta
125
125
  ## TRINITY V2.0 BEST PRACTICES
126
126
 
127
127
  ### Reference Documents
128
- - **Coding Standards:** [trinity/knowledge-base/CODING-PRINCIPLES.md](trinity/knowledge-base/CODING-PRINCIPLES.md)
129
- - **Testing Standards:** [trinity/knowledge-base/TESTING-PRINCIPLES.md](trinity/knowledge-base/TESTING-PRINCIPLES.md)
130
- - **AI Development Guide:** [trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md](trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md)
131
- - **Documentation Standards:** [trinity/knowledge-base/DOCUMENTATION-CRITERIA.md](trinity/knowledge-base/DOCUMENTATION-CRITERIA.md)
128
+ - **Coding Standards:** [.claude/trinity/knowledge-base/CODING-PRINCIPLES.md](.claude/trinity/knowledge-base/CODING-PRINCIPLES.md)
129
+ - **Testing Standards:** [.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md](.claude/trinity/knowledge-base/TESTING-PRINCIPLES.md)
130
+ - **AI Development Guide:** [.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md](.claude/trinity/knowledge-base/AI-DEVELOPMENT-GUIDE.md)
131
+ - **Documentation Standards:** [.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md](.claude/trinity/knowledge-base/DOCUMENTATION-CRITERIA.md)
132
132
 
133
133
  ### Planning Principles
134
134