trinity-method-sdk 2.0.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 (191) hide show
  1. package/CHANGELOG.md +116 -0
  2. package/LICENSE +21 -0
  3. package/README.md +555 -0
  4. package/dist/cli/commands/deploy/agents.d.ts +14 -0
  5. package/dist/cli/commands/deploy/agents.js +59 -0
  6. package/dist/cli/commands/deploy/ci-cd.d.ts +13 -0
  7. package/dist/cli/commands/deploy/ci-cd.js +50 -0
  8. package/dist/cli/commands/deploy/claude-setup.d.ts +17 -0
  9. package/dist/cli/commands/deploy/claude-setup.js +91 -0
  10. package/dist/cli/commands/deploy/configuration.d.ts +13 -0
  11. package/dist/cli/commands/deploy/configuration.js +215 -0
  12. package/dist/cli/commands/deploy/directories.d.ts +12 -0
  13. package/dist/cli/commands/deploy/directories.js +38 -0
  14. package/dist/cli/commands/deploy/gitignore.d.ts +12 -0
  15. package/dist/cli/commands/deploy/gitignore.js +53 -0
  16. package/dist/cli/commands/deploy/index.d.ts +38 -0
  17. package/dist/cli/commands/deploy/index.js +156 -0
  18. package/dist/cli/commands/deploy/knowledge-base.d.ts +16 -0
  19. package/dist/cli/commands/deploy/knowledge-base.js +75 -0
  20. package/dist/cli/commands/deploy/linting.d.ts +18 -0
  21. package/dist/cli/commands/deploy/linting.js +51 -0
  22. package/dist/cli/commands/deploy/metrics.d.ts +13 -0
  23. package/dist/cli/commands/deploy/metrics.js +34 -0
  24. package/dist/cli/commands/deploy/pre-flight.d.ts +13 -0
  25. package/dist/cli/commands/deploy/pre-flight.js +29 -0
  26. package/dist/cli/commands/deploy/root-files.d.ts +16 -0
  27. package/dist/cli/commands/deploy/root-files.js +178 -0
  28. package/dist/cli/commands/deploy/sdk-install.d.ts +12 -0
  29. package/dist/cli/commands/deploy/sdk-install.js +57 -0
  30. package/dist/cli/commands/deploy/summary.d.ts +14 -0
  31. package/dist/cli/commands/deploy/summary.js +130 -0
  32. package/dist/cli/commands/deploy/templates.d.ts +14 -0
  33. package/dist/cli/commands/deploy/templates.js +84 -0
  34. package/dist/cli/commands/deploy/types.d.ts +39 -0
  35. package/dist/cli/commands/deploy/types.js +5 -0
  36. package/dist/cli/commands/update/agents.d.ts +14 -0
  37. package/dist/cli/commands/update/agents.js +31 -0
  38. package/dist/cli/commands/update/backup.d.ts +31 -0
  39. package/dist/cli/commands/update/backup.js +97 -0
  40. package/dist/cli/commands/update/commands.d.ts +14 -0
  41. package/dist/cli/commands/update/commands.js +75 -0
  42. package/dist/cli/commands/update/index.d.ts +15 -0
  43. package/dist/cli/commands/update/index.js +118 -0
  44. package/dist/cli/commands/update/knowledge-base.d.ts +14 -0
  45. package/dist/cli/commands/update/knowledge-base.js +38 -0
  46. package/dist/cli/commands/update/pre-flight.d.ts +13 -0
  47. package/dist/cli/commands/update/pre-flight.js +37 -0
  48. package/dist/cli/commands/update/summary.d.ts +20 -0
  49. package/dist/cli/commands/update/summary.js +47 -0
  50. package/dist/cli/commands/update/templates.d.ts +14 -0
  51. package/dist/cli/commands/update/templates.js +25 -0
  52. package/dist/cli/commands/update/types.d.ts +13 -0
  53. package/dist/cli/commands/update/types.js +7 -0
  54. package/dist/cli/commands/update/utils.d.ts +11 -0
  55. package/dist/cli/commands/update/utils.js +19 -0
  56. package/dist/cli/commands/update/verification.d.ts +20 -0
  57. package/dist/cli/commands/update/verification.js +54 -0
  58. package/dist/cli/commands/update/version.d.ts +18 -0
  59. package/dist/cli/commands/update/version.js +36 -0
  60. package/dist/cli/commands/update.d.ts +7 -0
  61. package/dist/cli/commands/update.js +7 -0
  62. package/dist/cli/index.d.ts +3 -0
  63. package/dist/cli/index.js +36 -0
  64. package/dist/cli/types.d.ts +77 -0
  65. package/dist/cli/types.js +5 -0
  66. package/dist/cli/utils/deploy-ci.d.ts +22 -0
  67. package/dist/cli/utils/deploy-ci.js +138 -0
  68. package/dist/cli/utils/deploy-linting.d.ts +3 -0
  69. package/dist/cli/utils/deploy-linting.js +136 -0
  70. package/dist/cli/utils/detect-stack.d.ts +3 -0
  71. package/dist/cli/utils/detect-stack.js +270 -0
  72. package/dist/cli/utils/error-classes.d.ts +63 -0
  73. package/dist/cli/utils/error-classes.js +84 -0
  74. package/dist/cli/utils/error-handler.d.ts +59 -0
  75. package/dist/cli/utils/error-handler.js +127 -0
  76. package/dist/cli/utils/errors.d.ts +52 -0
  77. package/dist/cli/utils/errors.js +102 -0
  78. package/dist/cli/utils/get-sdk-path.d.ts +18 -0
  79. package/dist/cli/utils/get-sdk-path.js +31 -0
  80. package/dist/cli/utils/inject-dependencies.d.ts +2 -0
  81. package/dist/cli/utils/inject-dependencies.js +55 -0
  82. package/dist/cli/utils/linting-tools.d.ts +8 -0
  83. package/dist/cli/utils/linting-tools.js +206 -0
  84. package/dist/cli/utils/metrics/code-quality.d.ts +32 -0
  85. package/dist/cli/utils/metrics/code-quality.js +122 -0
  86. package/dist/cli/utils/metrics/dependency-parser.d.ts +21 -0
  87. package/dist/cli/utils/metrics/dependency-parser.js +153 -0
  88. package/dist/cli/utils/metrics/file-complexity.d.ts +26 -0
  89. package/dist/cli/utils/metrics/file-complexity.js +77 -0
  90. package/dist/cli/utils/metrics/framework-detector.d.ts +17 -0
  91. package/dist/cli/utils/metrics/framework-detector.js +120 -0
  92. package/dist/cli/utils/metrics/git-metrics.d.ts +30 -0
  93. package/dist/cli/utils/metrics/git-metrics.js +83 -0
  94. package/dist/cli/utils/metrics/index.d.ts +28 -0
  95. package/dist/cli/utils/metrics/index.js +100 -0
  96. package/dist/cli/utils/template-processor.d.ts +10 -0
  97. package/dist/cli/utils/template-processor.js +188 -0
  98. package/dist/cli/utils/validate-path.d.ts +80 -0
  99. package/dist/cli/utils/validate-path.js +180 -0
  100. package/dist/index.d.ts +6 -0
  101. package/dist/index.js +8 -0
  102. package/dist/templates/agents/aj-team/apo-documentation-specialist.md.template +572 -0
  103. package/dist/templates/agents/aj-team/bas-quality-gate.md.template +906 -0
  104. package/dist/templates/agents/aj-team/bon-dependency-manager.md.template +636 -0
  105. package/dist/templates/agents/aj-team/cap-configuration-specialist.md.template +670 -0
  106. package/dist/templates/agents/aj-team/dra-code-reviewer.md.template +768 -0
  107. package/dist/templates/agents/aj-team/kil-task-executor.md.template +764 -0
  108. package/dist/templates/agents/aj-team/uro-refactoring-specialist.md.template +759 -0
  109. package/dist/templates/agents/audit/juno-auditor.md.template +447 -0
  110. package/dist/templates/agents/deployment/ein-cicd.md.template +694 -0
  111. package/dist/templates/agents/deployment/ino-context.md.template +733 -0
  112. package/dist/templates/agents/deployment/tan-structure.md.template +661 -0
  113. package/dist/templates/agents/deployment/zen-knowledge.md.template +451 -0
  114. package/dist/templates/agents/leadership/aj-cc.md.template +462 -0
  115. package/dist/templates/agents/leadership/aj-maestro.md.template +943 -0
  116. package/dist/templates/agents/leadership/aly-cto.md.template +407 -0
  117. package/dist/templates/agents/planning/eus-decomposer.md.template +496 -0
  118. package/dist/templates/agents/planning/mon-requirements.md.template +323 -0
  119. package/dist/templates/agents/planning/ror-design.md.template +465 -0
  120. package/dist/templates/agents/planning/tra-planner.md.template +432 -0
  121. package/dist/templates/ci/cd.yml.template +175 -0
  122. package/dist/templates/ci/ci.yml.template +196 -0
  123. package/dist/templates/ci/generic-ci.yml +115 -0
  124. package/dist/templates/ci/github-actions.yml +86 -0
  125. package/dist/templates/ci/gitlab-ci.yml +103 -0
  126. package/dist/templates/claude/EMPLOYEE-DIRECTORY.md.template +545 -0
  127. package/dist/templates/documentation/ROOT-README.md.template +307 -0
  128. package/dist/templates/documentation/SUBDIRECTORY-README.md.template +261 -0
  129. package/dist/templates/investigations/bug.md.template +484 -0
  130. package/dist/templates/investigations/feature.md.template +564 -0
  131. package/dist/templates/investigations/performance.md.template +625 -0
  132. package/dist/templates/investigations/security.md.template +714 -0
  133. package/dist/templates/investigations/technical.md.template +433 -0
  134. package/dist/templates/knowledge-base/AI-DEVELOPMENT-GUIDE.md.template +957 -0
  135. package/dist/templates/knowledge-base/ARCHITECTURE.md.template +452 -0
  136. package/dist/templates/knowledge-base/CODING-PRINCIPLES.md.template +750 -0
  137. package/dist/templates/knowledge-base/DOCUMENTATION-CRITERIA.md.template +1118 -0
  138. package/dist/templates/knowledge-base/ISSUES.md.template +539 -0
  139. package/dist/templates/knowledge-base/TESTING-PRINCIPLES.md.template +894 -0
  140. package/dist/templates/knowledge-base/Technical-Debt.md.template +640 -0
  141. package/dist/templates/knowledge-base/To-do.md.template +407 -0
  142. package/dist/templates/knowledge-base/Trinity.md.template +464 -0
  143. package/dist/templates/linting/flutter/.pre-commit-config.yaml.template +27 -0
  144. package/dist/templates/linting/flutter/analysis_options.yaml.template +26 -0
  145. package/dist/templates/linting/nodejs/.eslintrc-commonjs.json.template +19 -0
  146. package/dist/templates/linting/nodejs/.eslintrc-esm.json.template +19 -0
  147. package/dist/templates/linting/nodejs/.eslintrc-typescript.json.template +22 -0
  148. package/dist/templates/linting/nodejs/.pre-commit-config.yaml.template +51 -0
  149. package/dist/templates/linting/nodejs/.prettierrc.json.template +10 -0
  150. package/dist/templates/linting/python/.flake8.template +16 -0
  151. package/dist/templates/linting/python/.pre-commit-config.yaml.template +30 -0
  152. package/dist/templates/linting/python/pyproject.toml.template +38 -0
  153. package/dist/templates/linting/rust/.pre-commit-config.yaml.template +28 -0
  154. package/dist/templates/linting/rust/clippy.toml.template +14 -0
  155. package/dist/templates/linting/rust/rustfmt.toml.template +12 -0
  156. package/dist/templates/root/CLAUDE.md.template +65 -0
  157. package/dist/templates/root/TRINITY.md.template +52 -0
  158. package/dist/templates/shared/claude-commands/trinity-agents.md.template +168 -0
  159. package/dist/templates/shared/claude-commands/trinity-audit.md.template +646 -0
  160. package/dist/templates/shared/claude-commands/trinity-changelog.md.template +624 -0
  161. package/dist/templates/shared/claude-commands/trinity-continue.md.template +549 -0
  162. package/dist/templates/shared/claude-commands/trinity-create-investigation.md.template +232 -0
  163. package/dist/templates/shared/claude-commands/trinity-decompose.md.template +181 -0
  164. package/dist/templates/shared/claude-commands/trinity-design.md.template +347 -0
  165. package/dist/templates/shared/claude-commands/trinity-docs.md.template +2093 -0
  166. package/dist/templates/shared/claude-commands/trinity-end.md.template +397 -0
  167. package/dist/templates/shared/claude-commands/trinity-init.md.template +606 -0
  168. package/dist/templates/shared/claude-commands/trinity-investigate-templates.md.template +725 -0
  169. package/dist/templates/shared/claude-commands/trinity-orchestrate.md.template +1061 -0
  170. package/dist/templates/shared/claude-commands/trinity-plan-investigation.md.template +135 -0
  171. package/dist/templates/shared/claude-commands/trinity-plan.md.template +201 -0
  172. package/dist/templates/shared/claude-commands/trinity-readme.md.template +1971 -0
  173. package/dist/templates/shared/claude-commands/trinity-requirements.md.template +148 -0
  174. package/dist/templates/shared/claude-commands/trinity-start.md.template +268 -0
  175. package/dist/templates/shared/claude-commands/trinity-verify.md.template +453 -0
  176. package/dist/templates/shared/claude-commands/trinity-workorder.md.template +249 -0
  177. package/dist/templates/source/base-CLAUDE.md.template +310 -0
  178. package/dist/templates/source/flutter-CLAUDE.md.template +593 -0
  179. package/dist/templates/source/nodejs-CLAUDE.md.template +531 -0
  180. package/dist/templates/source/python-CLAUDE.md.template +510 -0
  181. package/dist/templates/source/react-CLAUDE.md.template +513 -0
  182. package/dist/templates/source/rust-CLAUDE.md.template +653 -0
  183. package/dist/templates/source/tests-CLAUDE.md.template +432 -0
  184. package/dist/templates/trinity/CLAUDE.md.template +372 -0
  185. package/dist/templates/work-orders/ANALYSIS-TEMPLATE.md.template +276 -0
  186. package/dist/templates/work-orders/AUDIT-TEMPLATE.md.template +262 -0
  187. package/dist/templates/work-orders/IMPLEMENTATION-TEMPLATE.md.template +260 -0
  188. package/dist/templates/work-orders/INVESTIGATION-TEMPLATE.md.template +206 -0
  189. package/dist/templates/work-orders/PATTERN-TEMPLATE.md.template +320 -0
  190. package/dist/templates/work-orders/VERIFICATION-TEMPLATE.md.template +273 -0
  191. package/package.json +94 -0
@@ -0,0 +1,38 @@
1
+ # {{PROJECT_NAME}} - Python Tool Configuration
2
+ # Trinity Method v{{TRINITY_VERSION}}
3
+
4
+ [tool.black]
5
+ line-length = 100
6
+ target-version = ['py39']
7
+ include = '\.pyi?$'
8
+ extend-exclude = '''
9
+ /(
10
+ # directories
11
+ \.eggs
12
+ | \.git
13
+ | \.hg
14
+ | \.mypy_cache
15
+ | \.tox
16
+ | \.venv
17
+ | build
18
+ | dist
19
+ )/
20
+ '''
21
+
22
+ [tool.isort]
23
+ profile = "black"
24
+ line_length = 100
25
+ multi_line_output = 3
26
+ include_trailing_comma = true
27
+ force_grid_wrap = 0
28
+ use_parentheses = true
29
+ ensure_newline_before_comments = true
30
+
31
+ [tool.pylint.messages_control]
32
+ disable = [
33
+ "C0330", # Wrong hanging indentation before block
34
+ "C0326", # Bad whitespace
35
+ ]
36
+
37
+ [tool.pylint.format]
38
+ max-line-length = 100
@@ -0,0 +1,28 @@
1
+ # {{PROJECT_NAME}} - Pre-commit Configuration
2
+ # Trinity Method v{{TRINITY_VERSION}}
3
+
4
+ repos:
5
+ - repo: local
6
+ hooks:
7
+ - id: cargo-fmt
8
+ name: cargo fmt
9
+ entry: cargo fmt
10
+ language: system
11
+ types: [rust]
12
+ pass_filenames: false
13
+
14
+ - id: cargo-clippy
15
+ name: cargo clippy
16
+ entry: cargo clippy -- -D warnings
17
+ language: system
18
+ types: [rust]
19
+ pass_filenames: false
20
+
21
+ - repo: https://github.com/pre-commit/pre-commit-hooks
22
+ rev: v4.5.0
23
+ hooks:
24
+ - id: trailing-whitespace
25
+ - id: end-of-file-fixer
26
+ - id: check-yaml
27
+ - id: check-toml
28
+ - id: check-merge-conflict
@@ -0,0 +1,14 @@
1
+ # {{PROJECT_NAME}} - Clippy Configuration
2
+ # Trinity Method v{{TRINITY_VERSION}}
3
+
4
+ # Clippy lints
5
+ msrv = "1.70.0"
6
+
7
+ # Deny warnings in CI
8
+ warn-on-all-wildcard-imports = true
9
+
10
+ # Allowed by default
11
+ allow = [
12
+ "clippy::module_name_repetitions",
13
+ "clippy::must_use_candidate",
14
+ ]
@@ -0,0 +1,12 @@
1
+ # {{PROJECT_NAME}} - Rustfmt Configuration
2
+ # Trinity Method v{{TRINITY_VERSION}}
3
+
4
+ edition = "2021"
5
+ max_width = 100
6
+ hard_tabs = false
7
+ tab_spaces = 4
8
+ newline_style = "Unix"
9
+ use_small_heuristics = "Default"
10
+ reorder_imports = true
11
+ reorder_modules = true
12
+ remove_nested_parens = true
@@ -0,0 +1,65 @@
1
+ # {{PROJECT_NAME}} - Claude Code Memory
2
+
3
+ **Framework:** {{FRAMEWORK}}
4
+ **Tech Stack:** {{TECH_STACK}}
5
+ **Source Directory:** {{SOURCE_DIR}}
6
+ **Trinity Version:** {{TRINITY_VERSION}}
7
+ **Deployed:** {{DEPLOYMENT_TIMESTAMP}}
8
+
9
+ ---
10
+
11
+ ## Project Overview
12
+
13
+ [Describe your project here]
14
+
15
+ ## Claude Context Hierarchy
16
+
17
+ This project uses the Trinity Method with layered context files:
18
+
19
+ ### 1. Root Context (this file)
20
+ Project-specific overview, architecture, and living documentation references.
21
+
22
+ ### 2. Trinity Method Context
23
+ **File**: [trinity/CLAUDE.md](trinity/CLAUDE.md)
24
+ Enforces Trinity Method protocols: investigation-first development, quality gates, crisis management.
25
+
26
+ ### 3. Technology-Specific Context
27
+ **File**: [{{SOURCE_DIR}}/CLAUDE.md]({{SOURCE_DIR}}/CLAUDE.md)
28
+ Framework-specific debugging standards, performance optimization, testing patterns.
29
+
30
+ ### 4. Agent Directory
31
+ **File**: [.claude/EMPLOYEE-DIRECTORY.md](.claude/EMPLOYEE-DIRECTORY.md)
32
+ Complete guide to the 19-agent Trinity team and workflow orchestration.
33
+
34
+ ---
35
+
36
+ ## Living Documentation
37
+
38
+ ### Architecture
39
+
40
+ See: [trinity/knowledge-base/ARCHITECTURE.md](trinity/knowledge-base/ARCHITECTURE.md)
41
+
42
+ ### Current Tasks
43
+
44
+ See: [trinity/knowledge-base/To-do.md](trinity/knowledge-base/To-do.md)
45
+
46
+ ### Known Issues
47
+
48
+ See: [trinity/knowledge-base/ISSUES.md](trinity/knowledge-base/ISSUES.md)
49
+
50
+ ### Technical Debt
51
+
52
+ See: [trinity/knowledge-base/Technical-Debt.md](trinity/knowledge-base/Technical-Debt.md)
53
+
54
+ ### Testing Standards
55
+
56
+ See: [trinity/knowledge-base/TESTING-PRINCIPLES.md](trinity/knowledge-base/TESTING-PRINCIPLES.md)
57
+
58
+ ### Coding Principles
59
+
60
+ See: [trinity/knowledge-base/CODING-PRINCIPLES.md](trinity/knowledge-base/CODING-PRINCIPLES.md)
61
+
62
+ ---
63
+
64
+ **Trinity Method:** Investigation-first development methodology
65
+ **Session Location:** trinity/sessions/
@@ -0,0 +1,52 @@
1
+ # {{PROJECT_NAME}} - Trinity Method
2
+
3
+ **Version:** {{TRINITY_VERSION}}
4
+ **Deployed:** {{DEPLOYMENT_TIMESTAMP}}
5
+
6
+ ---
7
+
8
+ ## What is Trinity Method?
9
+
10
+ Trinity Method is an investigation-first development methodology that emphasizes:
11
+ - Understanding before implementing
12
+ - Strategic planning over reactive coding
13
+ - Quality and maintainability from the start
14
+
15
+ ## Trinity Structure
16
+
17
+ ```
18
+ {{PROJECT_NAME}}/
19
+ ├── trinity/
20
+ │ ├── knowledge-base/
21
+ │ │ ├── ARCHITECTURE.md # System architecture
22
+ │ │ ├── Trinity.md # Trinity guidelines
23
+ │ │ ├── To-do.md # Task management
24
+ │ │ ├── ISSUES.md # Known issues
25
+ │ │ └── Technical-Debt.md # Tech debt tracking
26
+ │ └── sessions/ # Session archives
27
+ ├── .claude/
28
+ │ └── agents/ # AI agent configurations
29
+ ├── CLAUDE.md # Claude Code memory
30
+ └── TRINITY.md # This file
31
+ ```
32
+
33
+ ## Starting a Session
34
+
35
+ To start working with Trinity Method, use Claude Code:
36
+
37
+ ```bash
38
+ claude
39
+ ```
40
+
41
+ Then reference this TRINITY.md file to understand the project structure.
42
+
43
+ ## Core Principles
44
+
45
+ 1. **Investigate First:** Understand before implementing
46
+ 2. **Document Thoroughly:** Keep knowledge-base updated
47
+ 3. **Archive Sessions:** Track progress in trinity/sessions/
48
+ 4. **Quality Focus:** Maintainability over speed
49
+
50
+ ---
51
+
52
+ For more information, see: [trinity/knowledge-base/Trinity.md](trinity/knowledge-base/Trinity.md)
@@ -0,0 +1,168 @@
1
+ ---
2
+ description: Display Trinity agent directory and information
3
+ ---
4
+
5
+ Display the Trinity Method Agent Directory with all 19 specialized agents.
6
+
7
+ **Important:** Claude doesn't "delegate" to agents. When you invoke an agent or slash command, Claude adopts that agent's persona and expertise to help you. All agents are Claude with specialized context and responsibilities.
8
+
9
+ ## Agent Organization
10
+
11
+ Agents are organized in 5 subdirectories by role:
12
+
13
+ ### 1. Leadership Team (3 agents)
14
+ Located in: `.claude/agents/leadership/`
15
+ - **ALY (Chief Technology Officer)** - Strategic planning and architecture decisions
16
+ - **AJ MAESTRO (Orchestration Lead)** - Workflow planning and agent coordination
17
+ - **AJ CC (Code Coordinator)** - Code quality and implementation oversight
18
+
19
+ ### 2. Deployment Team (4 agents)
20
+ Located in: `.claude/agents/deployment/`
21
+ - **TAN (Structure Specialist)** - Trinity infrastructure deployment and verification
22
+ - **ZEN (Knowledge Base Specialist)** - Documentation and knowledge management
23
+ - **INO (Context Specialist)** - CLAUDE.md hierarchy and ISSUES.md database
24
+ - **EIN (CI/CD Specialist)** - Continuous integration and deployment pipelines
25
+
26
+ ### 3. Audit Team (1 agent)
27
+ Located in: `.claude/agents/audit/`
28
+ - **JUNO (Quality Auditor)** - Comprehensive codebase audits (invoke with `/trinity-audit`) and deployment validation
29
+
30
+ ### 4. Planning Team (4 agents)
31
+ Located in: `.claude/agents/planning/`
32
+ - **MON (Requirements Analyst)** - Scale determination and acceptance criteria
33
+ - **ROR (Design Architect)** - Technical design and ADR documentation
34
+ - **TRA (Work Planner)** - Implementation sequencing and BAS quality gates
35
+ - **EUS (Task Decomposer)** - Atomic task breakdown following TDD
36
+
37
+ ### 5. AJ Implementation Team (7 agents)
38
+ Located in: `.claude/agents/aj-team/`
39
+ - **KIL (Task Executor)** - TDD implementation specialist (RED-GREEN-REFACTOR)
40
+ - **BAS (Quality Gate)** - 6-phase validation (Lint, Structure, Build, Test, Coverage, Practices)
41
+ - **DRA (Code Reviewer)** - Design Doc compliance validation
42
+ - **APO (Documentation Specialist)** - Documentation management (invoke with `/trinity-readme`, `/trinity-docs`, or `/trinity-changelog`), API docs, and inline comments
43
+ - **BON (Dependency Manager)** - Package management and security
44
+ - **CAP (Configuration Specialist)** - Environment and configuration files
45
+ - **URO (Refactoring Specialist)** - Code refactoring and technical debt reduction
46
+
47
+ ## Usage
48
+
49
+ Ask which agent you want to learn more about, and Claude will read that agent's template from `.claude/agents/{subdirectory}/` and provide a detailed summary of their capabilities and responsibilities.
50
+
51
+ **Example:** "Tell me about MON's requirements analysis process"
52
+
53
+ ---
54
+
55
+ ## Common Workflows with Agents
56
+
57
+ ### 1. Unfamiliar Codebase Workflow
58
+ ```bash
59
+ /trinity-audit # JUNO analyzes codebase
60
+ /trinity-readme # APO ensures README coverage
61
+ /trinity-docs # APO organizes docs/ directory
62
+ ```
63
+ **Use Case:** Just cloned an unfamiliar repository and need to understand it
64
+
65
+ ---
66
+
67
+ ### 2. Feature Development Workflow
68
+ ```bash
69
+ /trinity-orchestrate @WO-XXX.md # AJ MAESTRO coordinates agents
70
+ ```
71
+ **Use Case:** Implementing a feature with formal work order
72
+ **Agents Involved:** MON → ROR → TRA → EUS → KIL + BAS → DRA → JUNO
73
+
74
+ ---
75
+
76
+ ### 3. Documentation Maintenance
77
+ ```bash
78
+ /trinity-readme # APO ensures 100% README coverage
79
+ /trinity-docs # APO organizes docs/ directory
80
+ /trinity-changelog # APO maintains CHANGELOG.md
81
+ ```
82
+ **Use Case:** Regular documentation reviews, pre-release updates
83
+ **Agents Involved:** APO (standalone)
84
+
85
+ ---
86
+
87
+ ### 4. Session Recovery
88
+ ```bash
89
+ /trinity-continue # ALY recovers session state
90
+ ```
91
+ **Use Case:** Context window limit reached, interruption occurred
92
+ **Agents Involved:** ALY (session state analysis)
93
+
94
+ ---
95
+
96
+ ## Quick Agent Lookup
97
+
98
+ | Agent | Role | When to Use | File Location |
99
+ |-------|------|-------------|---------------|
100
+ | **ALY** | CTO | Strategic decisions, stop point reviews | leadership/aly-cto.md |
101
+ | **AJ MAESTRO** | Orchestrator | Coordinate Medium/Large workflows | leadership/aj-maestro.md |
102
+ | **AJ CC** | Continuity | Session recovery, investigations | leadership/aj-cc.md |
103
+ | **TAN** | Structure | Deploy Trinity folders (init only) | deployment/tan-structure.md |
104
+ | **ZEN** | Knowledge | Populate knowledge base (init only) | deployment/zen-knowledge.md |
105
+ | **INO** | Context | CLAUDE.md hierarchy (init only) | deployment/ino-context.md |
106
+ | **EIN** | CI/CD | GitHub Actions setup (init only) | deployment/ein-cicd.md |
107
+ | **MON** | Requirements | Extract requirements, determine scale | planning/mon-requirements.md |
108
+ | **ROR** | Design | Technical design, ADRs | planning/ror-design.md |
109
+ | **TRA** | Planner | Work plans, phase breakdown | planning/tra-planner.md |
110
+ | **EUS** | Decomposer | Break into atomic tasks | planning/eus-decomposer.md |
111
+ | **KIL** | Executor | TDD implementation | aj-team/kil-task-executor.md |
112
+ | **BAS** | Quality Gate | 6-phase validation | aj-team/bas-quality-gate.md |
113
+ | **DRA** | Reviewer | Code review, compliance | aj-team/dra-code-reviewer.md |
114
+ | **APO** | Documentation | API docs, comments | aj-team/apo-documentation-specialist.md |
115
+ | **BON** | Dependencies | Package management | aj-team/bon-dependency-manager.md |
116
+ | **CAP** | Configuration | Config files, env vars | aj-team/cap-configuration-specialist.md |
117
+ | **URO** | Refactoring | Code optimization | aj-team/uro-refactoring-specialist.md |
118
+ | **JUNO** | Auditor | Deployment verification | audit/juno-auditor.md |
119
+
120
+ ---
121
+
122
+ ## Agent Selection Flowchart
123
+
124
+ ```
125
+ What do you need?
126
+
127
+ ├─ Deploy Trinity → TAN, ZEN, INO (+ EIN if CI/CD)
128
+
129
+ ├─ Start new work → ALY (determines scale) → AJ MAESTRO
130
+
131
+ ├─ Resume interrupted work → AJ CC (session recovery)
132
+
133
+ ├─ Investigation only → AJ CC (read-only analysis)
134
+
135
+ └─ Specific task:
136
+
137
+ ├─ Extract requirements → MON
138
+ ├─ Create design → ROR
139
+ ├─ Plan work → TRA
140
+ ├─ Break into tasks → EUS
141
+ ├─ Implement code → KIL
142
+ ├─ Validate quality → BAS
143
+ ├─ Review code → DRA
144
+ ├─ Write docs → APO
145
+ ├─ Manage packages → BON
146
+ ├─ Configure app → CAP
147
+ ├─ Refactor code → URO
148
+ └─ Audit deployment → JUNO
149
+ ```
150
+
151
+ ---
152
+
153
+ ---
154
+
155
+ ## Agent Naming Standard
156
+
157
+ **Format**: `**AGENT** - Full Title (Acronym)`
158
+
159
+ **Examples**:
160
+ - **ALY** - Chief Technology Officer (CTO)
161
+ - **AJ MAESTRO** - Implementation Orchestrator
162
+ - **AJ CC** - Continuous Context Specialist
163
+ - **MON** - Requirements Analyst
164
+ - **KIL** - Task Executor
165
+
166
+ **Consistency**: All agent references across Trinity use this format for clarity.
167
+
168
+ ---