trinity-method-sdk 2.1.0 → 2.2.0

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 (96) hide show
  1. package/CHANGELOG.md +702 -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 -5
  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/knowledge-base.js +1 -1
  17. package/dist/cli/commands/update/pre-flight.js +11 -11
  18. package/dist/cli/commands/update/summary.js +5 -5
  19. package/dist/cli/commands/update/templates.js +1 -1
  20. package/dist/cli/commands/update/verification.js +5 -5
  21. package/dist/cli/commands/update/version.js +1 -1
  22. package/dist/cli/utils/deploy-ci.d.ts +3 -2
  23. package/dist/cli/utils/deploy-ci.js +24 -24
  24. package/dist/cli/utils/deploy-linting.js +100 -5
  25. package/dist/cli/utils/error-classes.d.ts +2 -2
  26. package/dist/cli/utils/linting-tools.js +14 -6
  27. package/dist/cli/utils/template-processor.js +1 -3
  28. package/dist/templates/.claude/EMPLOYEE-DIRECTORY.md.template +16 -22
  29. package/dist/templates/.claude/agents/aj-team/apo-documentation-specialist.md.template +7 -7
  30. package/dist/templates/.claude/agents/aj-team/bas-quality-gate.md.template +8 -8
  31. package/dist/templates/.claude/agents/aj-team/dra-code-reviewer.md.template +3 -3
  32. package/dist/templates/.claude/agents/aj-team/kil-task-executor.md.template +6 -6
  33. package/dist/templates/.claude/agents/audit/juno-auditor.md.template +39 -40
  34. package/dist/templates/.claude/agents/deployment/ein-cicd.md.template +56 -159
  35. package/dist/templates/.claude/agents/deployment/ino-context.md.template +21 -21
  36. package/dist/templates/.claude/agents/deployment/tan-structure.md.template +28 -29
  37. package/dist/templates/.claude/agents/deployment/zen-knowledge.md.template +22 -23
  38. package/dist/templates/.claude/agents/leadership/aj-maestro.md.template +6 -6
  39. package/dist/templates/.claude/agents/leadership/aly-cto.md.template +17 -18
  40. package/dist/templates/.claude/agents/planning/eus-decomposer.md.template +4 -4
  41. package/dist/templates/.claude/agents/planning/mon-requirements.md.template +4 -4
  42. package/dist/templates/.claude/agents/planning/ror-design.md.template +4 -4
  43. package/dist/templates/.claude/agents/planning/tra-planner.md.template +4 -4
  44. package/dist/templates/.claude/commands/execution/trinity-audit.md.template +9 -9
  45. package/dist/templates/.claude/commands/execution/trinity-breakdown.md.template +535 -0
  46. package/dist/templates/.claude/commands/execution/trinity-orchestrate.md.template +43 -43
  47. package/dist/templates/.claude/commands/infrastructure/trinity-init.md.template +20 -43
  48. package/dist/templates/.claude/commands/investigation/trinity-create-investigation.md.template +5 -5
  49. package/dist/templates/.claude/commands/investigation/trinity-investigate-templates.md.template +10 -10
  50. package/dist/templates/.claude/commands/investigation/trinity-plan-investigation.md.template +1 -1
  51. package/dist/templates/.claude/commands/maintenance/trinity-changelog.md.template +4 -4
  52. package/dist/templates/.claude/commands/maintenance/trinity-docs-update.md.template +10 -10
  53. package/dist/templates/.claude/commands/maintenance/trinity-docs.md.template +62 -62
  54. package/dist/templates/.claude/commands/maintenance/trinity-readme.md.template +16 -16
  55. package/dist/templates/.claude/commands/session/trinity-continue.md.template +22 -22
  56. package/dist/templates/.claude/commands/session/trinity-end.md.template +22 -22
  57. package/dist/templates/.claude/commands/session/trinity-start.md.template +1 -2
  58. package/dist/templates/.claude/commands/utility/trinity-agents.md.template +3 -6
  59. package/dist/templates/.claude/commands/utility/trinity-verify.md.template +48 -54
  60. package/dist/templates/.claude/commands/utility/trinity-workorder.md.template +5 -5
  61. package/dist/templates/ci/ci.yml.template +2 -2
  62. package/dist/templates/root/CLAUDE.md.template +9 -9
  63. package/dist/templates/root/linting/nodejs/.husky-pre-commit.template +5 -0
  64. package/dist/templates/source/base-CLAUDE.md.template +310 -310
  65. package/dist/templates/source/flutter-CLAUDE.md.template +593 -593
  66. package/dist/templates/source/nodejs-CLAUDE.md.template +531 -531
  67. package/dist/templates/source/python-CLAUDE.md.template +510 -510
  68. package/dist/templates/source/react-CLAUDE.md.template +513 -513
  69. package/dist/templates/source/rust-CLAUDE.md.template +653 -653
  70. package/dist/templates/trinity/CLAUDE.md.template +14 -14
  71. package/dist/templates/trinity/knowledge-base/ARCHITECTURE.md.template +4 -4
  72. package/dist/templates/trinity/knowledge-base/ISSUES.md.template +8 -8
  73. package/dist/templates/trinity/knowledge-base/Technical-Debt.md.template +1 -3
  74. package/dist/templates/trinity/knowledge-base/To-do.md.template +1 -1
  75. package/dist/templates/trinity/knowledge-base/Trinity.md.template +5 -5
  76. package/dist/templates/trinity/templates/documentation/configuration/env-example-generator.md.template +1 -1
  77. package/dist/templates/trinity/templates/documentation/processes/error-handling-protocol.md.template +2 -2
  78. package/dist/templates/trinity/templates/documentation/reports/apo-docs-update-checklist.md.template +7 -7
  79. package/dist/templates/trinity/templates/documentation/reports/juno-docs-update-checklist.md.template +4 -4
  80. package/dist/templates/trinity/templates/documentation/reports/juno-internal-report.md.template +10 -10
  81. package/dist/templates/trinity/templates/investigations/bug.md.template +14 -14
  82. package/dist/templates/trinity/templates/investigations/feature.md.template +14 -14
  83. package/dist/templates/trinity/templates/investigations/performance.md.template +14 -14
  84. package/dist/templates/trinity/templates/investigations/security.md.template +14 -14
  85. package/dist/templates/trinity/templates/investigations/technical.md.template +14 -14
  86. package/dist/templates/trinity/templates/work-orders/ANALYSIS-TEMPLATE.md.template +10 -10
  87. package/dist/templates/trinity/templates/work-orders/AUDIT-TEMPLATE.md.template +10 -10
  88. package/dist/templates/trinity/templates/work-orders/IMPLEMENTATION-TEMPLATE.md.template +10 -10
  89. package/dist/templates/trinity/templates/work-orders/INVESTIGATION-TEMPLATE.md.template +10 -10
  90. package/dist/templates/trinity/templates/work-orders/PATTERN-TEMPLATE.md.template +10 -10
  91. package/dist/templates/trinity/templates/work-orders/VERIFICATION-TEMPLATE.md.template +10 -10
  92. package/package.json +99 -94
  93. package/dist/templates/.claude/agents/leadership/aj-cc.md.template +0 -467
  94. package/dist/templates/ci/cd.yml.template +0 -175
  95. package/dist/templates/ci/github-actions.yml +0 -86
  96. package/dist/templates/root/TRINITY.md.template +0 -52
@@ -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
 
@@ -28,8 +28,8 @@
28
28
  - ✅ **Tool-based:** Uses actual linters/scanners, not just file reading
29
29
 
30
30
  **Deliverable:**
31
- - `trinity/reports/CODEBASE-AUDIT-{date}.md` (human-readable report)
32
- - `trinity/reports/AUDIT-BASELINE-{date}.json` (machine-readable baseline for future comparisons)
31
+ - `.claude/trinity/reports/CODEBASE-AUDIT-{date}.md` (human-readable report)
32
+ - `.claude/trinity/reports/AUDIT-BASELINE-{date}.json` (machine-readable baseline for future comparisons)
33
33
 
34
34
  ---
35
35
 
@@ -56,7 +56,7 @@
56
56
 
57
57
  ### ⚠️ Second Audit Behavior:
58
58
 
59
- When a baseline exists (`trinity/reports/AUDIT-BASELINE-*.json`):
59
+ When a baseline exists (`.claude/trinity/reports/AUDIT-BASELINE-*.json`):
60
60
  - **FIXED issues:** ✅ Marked as resolved (celebrate!)
61
61
  - **NEW issues:** ⚠️ Flagged as introduced since last audit
62
62
  - **PERSISTENT issues:** 🔴 Still present from previous audit
@@ -75,7 +75,7 @@ JUNO follows a **strict, repeatable process** to ensure consistent results:
75
75
 
76
76
  ```bash
77
77
  # Check for existing baseline
78
- IF trinity/reports/AUDIT-BASELINE-*.json exists:
78
+ IF .claude/trinity/reports/AUDIT-BASELINE-*.json exists:
79
79
  - Load previous findings
80
80
  - Track what's been fixed ✅
81
81
  - Track what's new ⚠️
@@ -425,7 +425,7 @@ IF baseline exists:
425
425
 
426
426
  **Two files created:**
427
427
 
428
- #### 1. Human-Readable Report: `trinity/reports/CODEBASE-AUDIT-{date}.md`
428
+ #### 1. Human-Readable Report: `.claude/trinity/reports/CODEBASE-AUDIT-{date}.md`
429
429
 
430
430
  ```markdown
431
431
  # Codebase Audit Report
@@ -503,10 +503,10 @@ Expected result: "0 new issues, 0 persistent issues, X fixed issues"
503
503
 
504
504
  **Audit Complete:** {timestamp}
505
505
  **Confidence:** {HIGH|MEDIUM|LOW}
506
- **Baseline Saved:** trinity/reports/AUDIT-BASELINE-{date}.json
506
+ **Baseline Saved:** .claude/trinity/reports/AUDIT-BASELINE-{date}.json
507
507
  ```
508
508
 
509
- #### 2. Machine-Readable Baseline: `trinity/reports/AUDIT-BASELINE-{date}.json`
509
+ #### 2. Machine-Readable Baseline: `.claude/trinity/reports/AUDIT-BASELINE-{date}.json`
510
510
 
511
511
  ```json
512
512
  {
@@ -599,8 +599,8 @@ JUNO: Loading previous audit baseline...
599
599
 
600
600
  **Recommendation:** You're done! The codebase is in excellent shape.
601
601
 
602
- **Audit saved:** trinity/reports/CODEBASE-AUDIT-2025-12-21.md
603
- **Baseline updated:** trinity/reports/AUDIT-BASELINE-2025-12-21.json
602
+ **Audit saved:** .claude/trinity/reports/CODEBASE-AUDIT-2025-12-21.md
603
+ **Baseline updated:** .claude/trinity/reports/AUDIT-BASELINE-2025-12-21.json
604
604
  ```
605
605
 
606
606
  **This is how the cycle ends.**