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.
- package/CHANGELOG.md +702 -467
- package/README.md +550 -539
- package/dist/cli/commands/deploy/ci-cd.d.ts +4 -3
- package/dist/cli/commands/deploy/ci-cd.js +10 -9
- package/dist/cli/commands/deploy/configuration.js +10 -11
- package/dist/cli/commands/deploy/directories.js +13 -14
- package/dist/cli/commands/deploy/gitignore.js +3 -5
- package/dist/cli/commands/deploy/index.d.ts +1 -1
- package/dist/cli/commands/deploy/index.js +6 -2
- package/dist/cli/commands/deploy/knowledge-base.js +2 -2
- package/dist/cli/commands/deploy/pre-flight.js +1 -1
- package/dist/cli/commands/deploy/root-files.js +2 -17
- package/dist/cli/commands/deploy/summary.js +3 -3
- package/dist/cli/commands/deploy/templates.js +5 -5
- package/dist/cli/commands/update/backup.js +6 -12
- package/dist/cli/commands/update/knowledge-base.js +1 -1
- package/dist/cli/commands/update/pre-flight.js +11 -11
- package/dist/cli/commands/update/summary.js +5 -5
- package/dist/cli/commands/update/templates.js +1 -1
- package/dist/cli/commands/update/verification.js +5 -5
- package/dist/cli/commands/update/version.js +1 -1
- package/dist/cli/utils/deploy-ci.d.ts +3 -2
- package/dist/cli/utils/deploy-ci.js +24 -24
- package/dist/cli/utils/deploy-linting.js +100 -5
- package/dist/cli/utils/error-classes.d.ts +2 -2
- package/dist/cli/utils/linting-tools.js +14 -6
- package/dist/cli/utils/template-processor.js +1 -3
- package/dist/templates/.claude/EMPLOYEE-DIRECTORY.md.template +16 -22
- package/dist/templates/.claude/agents/aj-team/apo-documentation-specialist.md.template +7 -7
- package/dist/templates/.claude/agents/aj-team/bas-quality-gate.md.template +8 -8
- package/dist/templates/.claude/agents/aj-team/dra-code-reviewer.md.template +3 -3
- package/dist/templates/.claude/agents/aj-team/kil-task-executor.md.template +6 -6
- package/dist/templates/.claude/agents/audit/juno-auditor.md.template +39 -40
- package/dist/templates/.claude/agents/deployment/ein-cicd.md.template +56 -159
- package/dist/templates/.claude/agents/deployment/ino-context.md.template +21 -21
- package/dist/templates/.claude/agents/deployment/tan-structure.md.template +28 -29
- package/dist/templates/.claude/agents/deployment/zen-knowledge.md.template +22 -23
- package/dist/templates/.claude/agents/leadership/aj-maestro.md.template +6 -6
- package/dist/templates/.claude/agents/leadership/aly-cto.md.template +17 -18
- package/dist/templates/.claude/agents/planning/eus-decomposer.md.template +4 -4
- package/dist/templates/.claude/agents/planning/mon-requirements.md.template +4 -4
- package/dist/templates/.claude/agents/planning/ror-design.md.template +4 -4
- package/dist/templates/.claude/agents/planning/tra-planner.md.template +4 -4
- package/dist/templates/.claude/commands/execution/trinity-audit.md.template +9 -9
- package/dist/templates/.claude/commands/execution/trinity-breakdown.md.template +535 -0
- package/dist/templates/.claude/commands/execution/trinity-orchestrate.md.template +43 -43
- package/dist/templates/.claude/commands/infrastructure/trinity-init.md.template +20 -43
- package/dist/templates/.claude/commands/investigation/trinity-create-investigation.md.template +5 -5
- package/dist/templates/.claude/commands/investigation/trinity-investigate-templates.md.template +10 -10
- package/dist/templates/.claude/commands/investigation/trinity-plan-investigation.md.template +1 -1
- package/dist/templates/.claude/commands/maintenance/trinity-changelog.md.template +4 -4
- package/dist/templates/.claude/commands/maintenance/trinity-docs-update.md.template +10 -10
- package/dist/templates/.claude/commands/maintenance/trinity-docs.md.template +62 -62
- package/dist/templates/.claude/commands/maintenance/trinity-readme.md.template +16 -16
- package/dist/templates/.claude/commands/session/trinity-continue.md.template +22 -22
- package/dist/templates/.claude/commands/session/trinity-end.md.template +22 -22
- package/dist/templates/.claude/commands/session/trinity-start.md.template +1 -2
- package/dist/templates/.claude/commands/utility/trinity-agents.md.template +3 -6
- package/dist/templates/.claude/commands/utility/trinity-verify.md.template +48 -54
- package/dist/templates/.claude/commands/utility/trinity-workorder.md.template +5 -5
- package/dist/templates/ci/ci.yml.template +2 -2
- package/dist/templates/root/CLAUDE.md.template +9 -9
- package/dist/templates/root/linting/nodejs/.husky-pre-commit.template +5 -0
- package/dist/templates/source/base-CLAUDE.md.template +310 -310
- package/dist/templates/source/flutter-CLAUDE.md.template +593 -593
- package/dist/templates/source/nodejs-CLAUDE.md.template +531 -531
- package/dist/templates/source/python-CLAUDE.md.template +510 -510
- package/dist/templates/source/react-CLAUDE.md.template +513 -513
- package/dist/templates/source/rust-CLAUDE.md.template +653 -653
- package/dist/templates/trinity/CLAUDE.md.template +14 -14
- package/dist/templates/trinity/knowledge-base/ARCHITECTURE.md.template +4 -4
- package/dist/templates/trinity/knowledge-base/ISSUES.md.template +8 -8
- package/dist/templates/trinity/knowledge-base/Technical-Debt.md.template +1 -3
- package/dist/templates/trinity/knowledge-base/To-do.md.template +1 -1
- package/dist/templates/trinity/knowledge-base/Trinity.md.template +5 -5
- package/dist/templates/trinity/templates/documentation/configuration/env-example-generator.md.template +1 -1
- package/dist/templates/trinity/templates/documentation/processes/error-handling-protocol.md.template +2 -2
- package/dist/templates/trinity/templates/documentation/reports/apo-docs-update-checklist.md.template +7 -7
- package/dist/templates/trinity/templates/documentation/reports/juno-docs-update-checklist.md.template +4 -4
- package/dist/templates/trinity/templates/documentation/reports/juno-internal-report.md.template +10 -10
- package/dist/templates/trinity/templates/investigations/bug.md.template +14 -14
- package/dist/templates/trinity/templates/investigations/feature.md.template +14 -14
- package/dist/templates/trinity/templates/investigations/performance.md.template +14 -14
- package/dist/templates/trinity/templates/investigations/security.md.template +14 -14
- package/dist/templates/trinity/templates/investigations/technical.md.template +14 -14
- package/dist/templates/trinity/templates/work-orders/ANALYSIS-TEMPLATE.md.template +10 -10
- package/dist/templates/trinity/templates/work-orders/AUDIT-TEMPLATE.md.template +10 -10
- package/dist/templates/trinity/templates/work-orders/IMPLEMENTATION-TEMPLATE.md.template +10 -10
- package/dist/templates/trinity/templates/work-orders/INVESTIGATION-TEMPLATE.md.template +10 -10
- package/dist/templates/trinity/templates/work-orders/PATTERN-TEMPLATE.md.template +10 -10
- package/dist/templates/trinity/templates/work-orders/VERIFICATION-TEMPLATE.md.template +10 -10
- package/package.json +99 -94
- package/dist/templates/.claude/agents/leadership/aj-cc.md.template +0 -467
- package/dist/templates/ci/cd.yml.template +0 -175
- package/dist/templates/ci/github-actions.yml +0 -86
- 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
|
|
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:
|
|
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
|
|
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:
|
|
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:
|
|
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:**
|
|
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:**
|
|
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:**
|
|
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:**
|
|
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:
|
|
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:
|
|
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
|
-
-
|
|
354
|
-
-
|
|
355
|
-
-
|
|
356
|
-
-
|
|
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
|
|
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
|
|
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) -
|
|
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
|
-
-
|
|
669
|
-
-
|
|
670
|
-
-
|
|
671
|
-
-
|
|
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
|
-
-
|
|
100
|
-
-
|
|
101
|
-
-
|
|
102
|
-
-
|
|
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
|
-
-
|
|
108
|
-
-
|
|
109
|
-
-
|
|
110
|
-
-
|
|
111
|
-
-
|
|
112
|
-
-
|
|
113
|
-
-
|
|
114
|
-
-
|
|
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
|
|
120
|
+
## AJ MAESTRO & THE 18-AGENT TEAM
|
|
121
121
|
|
|
122
122
|
### Team Structure (5 Role-Based Subdirectories)
|
|
123
123
|
|
|
124
|
-
**Leadership Tier** (
|
|
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 (
|
|
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
|
|
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
|
-
-
|
|
32
|
-
-
|
|
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 (
|
|
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:
|
|
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:
|
|
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.**
|