@uluops/setup 0.2.0 → 0.6.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 (253) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +109 -89
  3. package/assets/auto-tracker-save.mjs +142 -0
  4. package/assets/claude-code/agents/anxiety-reader-agent.md +464 -0
  5. package/assets/{agents → claude-code/agents}/api-contract-validator-agent.md +9 -228
  6. package/assets/{agents → claude-code/agents}/aristotle-analyst-agent.md +51 -4
  7. package/assets/{agents → claude-code/agents}/aristotle-explorer-agent.md +6 -2
  8. package/assets/{agents → claude-code/agents}/aristotle-forecaster-agent.md +15 -230
  9. package/assets/{agents → claude-code/agents}/aristotle-validator-agent.md +12 -252
  10. package/assets/{agents → claude-code/agents}/assumption-excavator-agent.md +21 -247
  11. package/assets/{agents → claude-code/agents}/code-auditor-agent.md +12 -255
  12. package/assets/{agents → claude-code/agents}/code-optimizer-agent.md +15 -236
  13. package/assets/{agents → claude-code/agents}/code-validator-agent.md +31 -300
  14. package/assets/claude-code/agents/docs-validator-agent.md +472 -0
  15. package/assets/{agents → claude-code/agents}/frontend-validator-agent.md +15 -258
  16. package/assets/{agents → claude-code/agents}/mcp-validator-agent.md +8 -252
  17. package/assets/{agents → claude-code/agents}/pre-implementation-architect-agent.md +8 -224
  18. package/assets/{agents → claude-code/agents}/prompt-engineer-agent.md +57 -290
  19. package/assets/{agents → claude-code/agents}/prompt-pattern-analyzer-agent.md +10 -225
  20. package/assets/{agents → claude-code/agents}/prompt-quality-validator-agent.md +11 -249
  21. package/assets/{agents → claude-code/agents}/public-interface-validator-agent.md +15 -268
  22. package/assets/claude-code/agents/release-readiness-agent.md +495 -0
  23. package/assets/{agents → claude-code/agents}/security-analyst-agent.md +236 -480
  24. package/assets/{agents → claude-code/agents}/test-architect-agent.md +16 -259
  25. package/assets/{agents → claude-code/agents}/type-safety-validator-agent.md +23 -266
  26. package/assets/{agents → claude-code/agents}/workflow-synthesis-agent.md +23 -226
  27. package/assets/claude-code/commands/agents/anxiety-reader.md +157 -0
  28. package/assets/{commands → claude-code/commands}/agents/api-contract.md +156 -135
  29. package/assets/{commands → claude-code/commands}/agents/architect.md +156 -135
  30. package/assets/claude-code/commands/agents/aristotle-analyst.md +157 -0
  31. package/assets/claude-code/commands/agents/aristotle-explorer.md +157 -0
  32. package/assets/claude-code/commands/agents/aristotle-forecaster.md +157 -0
  33. package/assets/claude-code/commands/agents/aristotle-validator.md +157 -0
  34. package/assets/{commands → claude-code/commands}/agents/assumption-excavator.md +49 -6
  35. package/assets/{commands → claude-code/commands}/agents/audit.md +156 -136
  36. package/assets/{commands → claude-code/commands}/agents/docs-validate.md +156 -133
  37. package/assets/{commands → claude-code/commands}/agents/frontend.md +156 -135
  38. package/assets/{commands → claude-code/commands}/agents/mcp-validate.md +156 -136
  39. package/assets/{commands → claude-code/commands}/agents/optimize.md +156 -133
  40. package/assets/{commands → claude-code/commands}/agents/pattern-analyzer.md +150 -126
  41. package/assets/{commands → claude-code/commands}/agents/prompt-quality.md +155 -134
  42. package/assets/claude-code/commands/agents/prompt-validate.md +155 -0
  43. package/assets/{commands → claude-code/commands}/agents/public-interface.md +156 -134
  44. package/assets/{commands → claude-code/commands}/agents/release.md +156 -135
  45. package/assets/{commands → claude-code/commands}/agents/security.md +156 -137
  46. package/assets/{commands → claude-code/commands}/agents/test-review.md +156 -136
  47. package/assets/{commands → claude-code/commands}/agents/type-safety.md +156 -135
  48. package/assets/{commands → claude-code/commands}/agents/validate.md +156 -134
  49. package/assets/claude-code/commands/agents/workflow-synthesis.md +157 -0
  50. package/assets/claude-code/commands/pipelines/aristotle.md +143 -0
  51. package/assets/claude-code/commands/pipelines/ship.md +188 -0
  52. package/assets/claude-code/commands/workflows/post-implementation.md +60 -0
  53. package/assets/claude-code/commands/workflows/pre-implementation.md +46 -0
  54. package/assets/claude-code/commands/workflows/prompt-audit.md +44 -0
  55. package/assets/codex/agents/anxiety-reader-agent.toml +462 -0
  56. package/assets/codex/agents/api-contract-validator-agent.toml +738 -0
  57. package/assets/codex/agents/aristotle-analyst-agent.toml +750 -0
  58. package/assets/codex/agents/aristotle-explorer-agent.toml +155 -0
  59. package/assets/codex/agents/aristotle-forecaster-agent.toml +449 -0
  60. package/assets/codex/agents/aristotle-validator-agent.toml +424 -0
  61. package/assets/codex/agents/assumption-excavator-agent.toml +1126 -0
  62. package/assets/codex/agents/code-auditor-agent.toml +815 -0
  63. package/assets/codex/agents/code-optimizer-agent.toml +652 -0
  64. package/assets/codex/agents/code-validator-agent.toml +573 -0
  65. package/assets/codex/agents/docs-validator-agent.toml +468 -0
  66. package/assets/codex/agents/frontend-validator-agent.toml +598 -0
  67. package/assets/codex/agents/mcp-validator-agent.toml +580 -0
  68. package/assets/codex/agents/pre-implementation-architect-agent.toml +817 -0
  69. package/assets/codex/agents/prompt-engineer-agent.toml +922 -0
  70. package/assets/codex/agents/prompt-pattern-analyzer-agent.toml +689 -0
  71. package/assets/codex/agents/prompt-quality-validator-agent.toml +777 -0
  72. package/assets/codex/agents/public-interface-validator-agent.toml +695 -0
  73. package/assets/codex/agents/release-readiness-agent.toml +491 -0
  74. package/assets/codex/agents/security-analyst-agent.toml +847 -0
  75. package/assets/codex/agents/test-architect-agent.toml +615 -0
  76. package/assets/codex/agents/type-safety-validator-agent.toml +686 -0
  77. package/assets/codex/agents/workflow-synthesis-agent.toml +631 -0
  78. package/assets/gemini-cli/agents/anxiety-reader-agent.md +470 -0
  79. package/assets/gemini-cli/agents/api-contract-validator-agent.md +747 -0
  80. package/assets/gemini-cli/agents/aristotle-analyst-agent.md +758 -0
  81. package/assets/gemini-cli/agents/aristotle-explorer-agent.md +163 -0
  82. package/assets/gemini-cli/agents/aristotle-forecaster-agent.md +457 -0
  83. package/assets/gemini-cli/agents/aristotle-validator-agent.md +432 -0
  84. package/assets/gemini-cli/agents/assumption-excavator-agent.md +1134 -0
  85. package/assets/gemini-cli/agents/code-auditor-agent.md +827 -0
  86. package/assets/gemini-cli/agents/code-optimizer-agent.md +661 -0
  87. package/assets/gemini-cli/agents/code-validator-agent.md +582 -0
  88. package/assets/gemini-cli/agents/docs-validator-agent.md +477 -0
  89. package/assets/gemini-cli/agents/frontend-validator-agent.md +610 -0
  90. package/assets/gemini-cli/agents/mcp-validator-agent.md +589 -0
  91. package/assets/gemini-cli/agents/pre-implementation-architect-agent.md +826 -0
  92. package/assets/gemini-cli/agents/prompt-engineer-agent.md +931 -0
  93. package/assets/gemini-cli/agents/prompt-pattern-analyzer-agent.md +698 -0
  94. package/assets/gemini-cli/agents/prompt-quality-validator-agent.md +786 -0
  95. package/assets/gemini-cli/agents/public-interface-validator-agent.md +707 -0
  96. package/assets/gemini-cli/agents/release-readiness-agent.md +500 -0
  97. package/assets/gemini-cli/agents/security-analyst-agent.md +859 -0
  98. package/assets/gemini-cli/agents/test-architect-agent.md +624 -0
  99. package/assets/gemini-cli/agents/type-safety-validator-agent.md +695 -0
  100. package/assets/gemini-cli/agents/workflow-synthesis-agent.md +639 -0
  101. package/assets/gemini-cli/commands/agents/anxiety-reader.toml +155 -0
  102. package/assets/gemini-cli/commands/agents/api-contract.toml +154 -0
  103. package/assets/gemini-cli/commands/agents/architect.toml +154 -0
  104. package/assets/gemini-cli/commands/agents/aristotle-analyst.toml +155 -0
  105. package/assets/gemini-cli/commands/agents/aristotle-explorer.toml +155 -0
  106. package/assets/gemini-cli/commands/agents/aristotle-forecaster.toml +155 -0
  107. package/assets/gemini-cli/commands/agents/aristotle-validator.toml +155 -0
  108. package/assets/gemini-cli/commands/agents/assumption-excavator.toml +155 -0
  109. package/assets/gemini-cli/commands/agents/audit.toml +154 -0
  110. package/assets/gemini-cli/commands/agents/docs-validate.toml +154 -0
  111. package/assets/gemini-cli/commands/agents/frontend.toml +154 -0
  112. package/assets/gemini-cli/commands/agents/mcp-validate.toml +154 -0
  113. package/assets/gemini-cli/commands/agents/optimize.toml +154 -0
  114. package/assets/gemini-cli/commands/agents/pattern-analyzer.toml +148 -0
  115. package/assets/gemini-cli/commands/agents/prompt-quality.toml +153 -0
  116. package/assets/gemini-cli/commands/agents/prompt-validate.toml +153 -0
  117. package/assets/gemini-cli/commands/agents/public-interface.toml +154 -0
  118. package/assets/gemini-cli/commands/agents/release.toml +154 -0
  119. package/assets/gemini-cli/commands/agents/security.toml +154 -0
  120. package/assets/gemini-cli/commands/agents/test-review.toml +154 -0
  121. package/assets/gemini-cli/commands/agents/type-safety.toml +154 -0
  122. package/assets/gemini-cli/commands/agents/validate.toml +154 -0
  123. package/assets/gemini-cli/commands/agents/workflow-synthesis.toml +155 -0
  124. package/assets/gemini-cli/commands/pipelines/aristotle.toml +139 -0
  125. package/assets/gemini-cli/commands/pipelines/ship.toml +184 -0
  126. package/assets/gemini-cli/commands/workflows/post-implementation.toml +56 -0
  127. package/assets/gemini-cli/commands/workflows/pre-implementation.toml +42 -0
  128. package/assets/gemini-cli/commands/workflows/prompt-audit.toml +40 -0
  129. package/assets/opencode/agents/anxiety-reader-agent.md +472 -0
  130. package/assets/opencode/agents/api-contract-validator-agent.md +749 -0
  131. package/assets/opencode/agents/aristotle-analyst-agent.md +760 -0
  132. package/assets/opencode/agents/aristotle-explorer-agent.md +164 -0
  133. package/assets/opencode/agents/aristotle-forecaster-agent.md +459 -0
  134. package/assets/opencode/agents/aristotle-validator-agent.md +434 -0
  135. package/assets/opencode/agents/assumption-excavator-agent.md +1136 -0
  136. package/assets/opencode/agents/code-auditor-agent.md +826 -0
  137. package/assets/opencode/agents/code-optimizer-agent.md +663 -0
  138. package/assets/opencode/agents/code-validator-agent.md +584 -0
  139. package/assets/opencode/agents/docs-validator-agent.md +479 -0
  140. package/assets/opencode/agents/frontend-validator-agent.md +609 -0
  141. package/assets/opencode/agents/mcp-validator-agent.md +591 -0
  142. package/assets/opencode/agents/pre-implementation-architect-agent.md +828 -0
  143. package/assets/opencode/agents/prompt-engineer-agent.md +933 -0
  144. package/assets/opencode/agents/prompt-pattern-analyzer-agent.md +700 -0
  145. package/assets/opencode/agents/prompt-quality-validator-agent.md +788 -0
  146. package/assets/opencode/agents/public-interface-validator-agent.md +706 -0
  147. package/assets/opencode/agents/release-readiness-agent.md +502 -0
  148. package/assets/opencode/agents/security-analyst-agent.md +858 -0
  149. package/assets/opencode/agents/test-architect-agent.md +626 -0
  150. package/assets/opencode/agents/type-safety-validator-agent.md +697 -0
  151. package/assets/opencode/agents/workflow-synthesis-agent.md +641 -0
  152. package/dist/cli.js +22 -380
  153. package/dist/commands/helpers.d.ts +73 -0
  154. package/dist/commands/helpers.js +274 -0
  155. package/dist/commands/setup.d.ts +13 -0
  156. package/dist/commands/setup.js +93 -0
  157. package/dist/commands/uninstall.d.ts +3 -0
  158. package/dist/commands/uninstall.js +126 -0
  159. package/dist/commands/verify.d.ts +1 -0
  160. package/dist/commands/verify.js +28 -0
  161. package/dist/harnesses/claude-code.d.ts +8 -0
  162. package/dist/harnesses/claude-code.js +74 -0
  163. package/dist/harnesses/codex.d.ts +15 -0
  164. package/dist/harnesses/codex.js +54 -0
  165. package/dist/harnesses/gemini-cli.d.ts +12 -0
  166. package/dist/harnesses/gemini-cli.js +80 -0
  167. package/dist/harnesses/index.d.ts +27 -0
  168. package/dist/harnesses/index.js +54 -0
  169. package/dist/harnesses/opencode.d.ts +14 -0
  170. package/dist/harnesses/opencode.js +139 -0
  171. package/dist/harnesses/types.d.ts +106 -0
  172. package/dist/harnesses/types.js +26 -0
  173. package/dist/lib/agent-transform.d.ts +12 -0
  174. package/dist/lib/agent-transform.js +129 -0
  175. package/dist/lib/asset-catalog.d.ts +9 -0
  176. package/dist/lib/asset-catalog.js +56 -0
  177. package/dist/lib/atomic-write.d.ts +11 -0
  178. package/dist/lib/atomic-write.js +28 -0
  179. package/dist/lib/config-merger.d.ts +9 -2
  180. package/dist/lib/config-merger.js +44 -7
  181. package/dist/lib/display.d.ts +14 -0
  182. package/dist/lib/display.js +66 -0
  183. package/dist/lib/file-ops.d.ts +11 -0
  184. package/dist/lib/file-ops.js +40 -4
  185. package/dist/lib/hash.d.ts +1 -0
  186. package/dist/lib/hash.js +2 -1
  187. package/dist/lib/health.d.ts +2 -0
  188. package/dist/lib/health.js +10 -0
  189. package/dist/lib/manifest.d.ts +51 -5
  190. package/dist/lib/manifest.js +146 -13
  191. package/dist/lib/paths.d.ts +30 -3
  192. package/dist/lib/paths.js +98 -12
  193. package/dist/lib/settings-merger.d.ts +31 -8
  194. package/dist/lib/settings-merger.js +87 -24
  195. package/dist/lib/version.d.ts +2 -0
  196. package/dist/lib/version.js +10 -0
  197. package/dist/steps/agents.d.ts +4 -1
  198. package/dist/steps/agents.js +48 -9
  199. package/dist/steps/auth.js +26 -10
  200. package/dist/steps/cli.d.ts +53 -0
  201. package/dist/steps/cli.js +90 -0
  202. package/dist/steps/commands.d.ts +6 -1
  203. package/dist/steps/commands.js +36 -9
  204. package/dist/steps/detect.d.ts +3 -0
  205. package/dist/steps/detect.js +11 -0
  206. package/dist/steps/mcp.d.ts +6 -2
  207. package/dist/steps/mcp.js +39 -22
  208. package/dist/steps/metrics.d.ts +26 -10
  209. package/dist/steps/metrics.js +108 -108
  210. package/dist/steps/shell.d.ts +2 -0
  211. package/dist/steps/shell.js +26 -9
  212. package/dist/steps/signup.d.ts +7 -4
  213. package/dist/steps/signup.js +29 -20
  214. package/dist/steps/verify.d.ts +2 -2
  215. package/dist/steps/verify.js +118 -112
  216. package/package.json +40 -14
  217. package/assets/agents/docs-validator-agent.md +0 -490
  218. package/assets/agents/release-readiness-agent.md +0 -482
  219. package/assets/commands/agents/aristotle-analyst.md +0 -115
  220. package/assets/commands/agents/aristotle-explorer.md +0 -92
  221. package/assets/commands/agents/aristotle-forecaster.md +0 -114
  222. package/assets/commands/agents/aristotle-validator.md +0 -114
  223. package/assets/commands/agents/prompt-validate.md +0 -135
  224. package/assets/commands/agents/workflow-synthesis.md +0 -101
  225. package/assets/commands/workflows/aristotle.md +0 -543
  226. package/assets/commands/workflows/post-implementation.md +0 -577
  227. package/assets/commands/workflows/pre-implementation.md +0 -670
  228. package/assets/commands/workflows/prompt-audit.md +0 -754
  229. package/assets/commands/workflows/ship.md +0 -721
  230. package/dist/test/auth.test.d.ts +0 -1
  231. package/dist/test/auth.test.js +0 -43
  232. package/dist/test/config-io.test.d.ts +0 -1
  233. package/dist/test/config-io.test.js +0 -56
  234. package/dist/test/config-merger.test.d.ts +0 -1
  235. package/dist/test/config-merger.test.js +0 -94
  236. package/dist/test/detect.test.d.ts +0 -1
  237. package/dist/test/detect.test.js +0 -25
  238. package/dist/test/file-ops.test.d.ts +0 -1
  239. package/dist/test/file-ops.test.js +0 -100
  240. package/dist/test/hash.test.d.ts +0 -1
  241. package/dist/test/hash.test.js +0 -14
  242. package/dist/test/manifest.test.d.ts +0 -1
  243. package/dist/test/manifest.test.js +0 -78
  244. package/dist/test/paths.test.d.ts +0 -1
  245. package/dist/test/paths.test.js +0 -30
  246. package/dist/test/settings-merger.test.d.ts +0 -1
  247. package/dist/test/settings-merger.test.js +0 -167
  248. package/dist/test/shell-profile.test.d.ts +0 -1
  249. package/dist/test/shell-profile.test.js +0 -40
  250. package/dist/test/shell.test.d.ts +0 -1
  251. package/dist/test/shell.test.js +0 -71
  252. package/dist/test/signup.test.d.ts +0 -1
  253. package/dist/test/signup.test.js +0 -83
@@ -0,0 +1,155 @@
1
+ description = "Reads from the position of someone afraid of the artifact's failure modes. Surfaces concerns hiding beneath confident language — classified by anxiety register (tactical/structural/epistemic). Decision CONFIDENCE_WARRANTED/FRAGILITY_MASKED."
2
+ prompt = '''
3
+ # Anxiety Reader v1
4
+ Reads from the position of someone afraid of the artifact's failure modes. Surfaces concerns hiding beneath confident language — classified by anxiety register (tactical/structural/epistemic). Decision CONFIDENCE_WARRANTED/FRAGILITY_MASKED.
5
+
6
+ ## What's New in v1
7
+
8
+ | Feature | Description |
9
+ |---------|-------------|
10
+ | **Calibration Examples** | Reference scenarios for consistent scoring |
11
+ | **Failure Code Examples** | Worked examples mapping issues to taxonomy codes |
12
+ | **Token Budget** | Output length guidance |
13
+ | **Display IDs** | Auto-fail conditions have numbered IDs |
14
+
15
+ ## Arguments
16
+
17
+ **Usage:** `/agents:anxiety-reader <directory>`
18
+
19
+ **Examples:**
20
+ - `/agents:anxiety-reader src/services/auth.ts`
21
+ - `/agents:anxiety-reader udl/adl/v3/code-validator.agent.yaml`
22
+ - `/agents:anxiety-reader infrastructure/`
23
+ - `/agents:anxiety-reader docs/architecture.md`
24
+
25
+ **Target Directory:** {{args}}
26
+
27
+
28
+ ---
29
+
30
+ ## Pre-Flight
31
+
32
+ ```bash
33
+ echo "Running anxiety reader analysis on {{args}}..."
34
+ echo "================================================"
35
+ ```
36
+
37
+ Verify the target directory exists:
38
+
39
+ ```bash
40
+ test -d "{{args}}" && echo "✓ Directory exists: {{args}}" || echo "ERROR: Directory '{{args}}' not found"
41
+ ```
42
+
43
+ Enter and confirm location:
44
+
45
+ ```bash
46
+ cd "{{args}}" && pwd
47
+ ```
48
+
49
+ Check path exists:
50
+
51
+ ```bash
52
+ [ -e "{{args}}" ] && echo "✓ {{args}} exists" || echo "Target file or directory does not exist"
53
+ ```
54
+
55
+
56
+ ---
57
+
58
+ ## Agent Invocation
59
+
60
+ Run the Anxiety Reader agent on the validated target directory:
61
+
62
+ **Agent:** anxiety-reader-agent.md
63
+ **Model:** Opus
64
+ **Target:** {{args}}
65
+
66
+
67
+ ---
68
+
69
+ ## Decision Thresholds
70
+
71
+ | Score | Decision | Meaning |
72
+ |-------|----------|---------|
73
+ | **>=70** | ✅ PASS | Validation passed, proceed to next phase |
74
+ | **<70** | ❌ FAIL | Validation failed, fix issues before proceeding |
75
+
76
+ **Note:** Any critical issue triggers FAIL regardless of score.
77
+
78
+ ---
79
+
80
+ ## Post-Flight Actions
81
+
82
+ ### On Success
83
+
84
+ Artifact CONFIDENCE_WARRANTED — claims survive anxious scrutiny, robustness matches presentation
85
+
86
+ ```bash
87
+ exit 0
88
+ ```
89
+
90
+ ### On Failure
91
+
92
+ Artifact FRAGILITY_MASKED — confident language hides fragility the anxious reader can see
93
+
94
+ ```bash
95
+ exit 1
96
+ ```
97
+
98
+
99
+ ---
100
+
101
+
102
+ ## PERSIST TO TRACKER (Required)
103
+
104
+ > **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
105
+ **1. Get token metrics from buffer:**
106
+ ```bash
107
+ agent-metrics buffer list --since 5m -f tracker
108
+ ```
109
+
110
+ **2. Save to tracker (DO THIS FIRST):**
111
+
112
+ mcp__uluops-tracker__save_run
113
+
114
+ **3. Verify saved:** Compare `json.summary.total_issues` with saved count.
115
+
116
+ **4. THEN present summary to user.**
117
+
118
+ ### Field Mappings
119
+
120
+ **Definition identity (REQUIRED for execution tracking):**
121
+ | Tracker Field | Value | Notes |
122
+ |---------------|-------|-------|
123
+ | `definition_type` | `command` | From CDL interface |
124
+ | `definition_name` | `anxiety-reader` | From CDL interface |
125
+ | `definition_version` | `1.0.2` | From CDL interface |
126
+
127
+ **From JSON OUTPUT to Tracker:**
128
+ | Source | Tracker Field | Notes |
129
+ |--------|---------------|-------|
130
+ | `json.result.score` | `agents[].score` | Total score |
131
+ | `json.result.decision` | `agents[].decision` | PASS/FAIL |
132
+ | `buffer.model` | `validators[].model` | From agent-metrics buffer |
133
+ | `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
134
+ | `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
135
+ | `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
136
+ | `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
137
+ | `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
138
+ | `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
139
+ | `json.analysis.records[]` | `analysis_records[]` | Structured analysis records (v1.4.0) |
140
+ | `json.analysis.system_metrics` | `analysis_summary.system_metrics` | Agent-type-specific metrics |
141
+ | `json.analysis.category_scores[]` | `analysis_summary.category_scores[]` | Category score breakdown |
142
+ | `json.analysis.epistemic_assessment` | `analysis_summary.epistemic_assessment` | Failure signature risk ratings |
143
+ | `json.analysis.audit_implications[]` | `analysis_summary.audit_implications[]` | Trajectory projections |
144
+
145
+ **Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
146
+ **Note:** `analysis_records` and `analysis_summary` are optional (v1.4.0). Omit if agent output has no `analysis` section.
147
+
148
+ ---
149
+
150
+ ## Source
151
+
152
+ **CDL Schema:** `udl/definition-languages/cdl-schema-v1_3_0.json`
153
+ **CDL Source:** `/Users/aself/uluops/uluops-agent-workflows/udl/cdl/v1/anxiety-reader.command.yaml`
154
+ **Agent:** `agents/anxiety-reader-agent.md`
155
+ '''
@@ -0,0 +1,154 @@
1
+ description = "Run API Contract Validator to check consistency between docs, types, and implementation. Use after any API endpoint changes."
2
+ prompt = '''
3
+ # API Contract Validator v1
4
+ Run API Contract Validator to check consistency between docs, types, and implementation. Use after any API endpoint changes.
5
+
6
+ ## What's New in v1
7
+
8
+ | Feature | Description |
9
+ |---------|-------------|
10
+ | **Calibration Examples** | Reference scenarios for consistent scoring |
11
+ | **Failure Code Examples** | Worked examples mapping issues to taxonomy codes |
12
+ | **Token Budget** | Output length guidance |
13
+ | **Display IDs** | Auto-fail conditions have numbered IDs |
14
+
15
+ ## Arguments
16
+
17
+ **Usage:** `/agents:api-contract <directory>`
18
+
19
+ **Examples:**
20
+ - `/agents:api-contract ./api`
21
+ - `/agents:api-contract ./services/api`
22
+ - `/agents:api-contract .`
23
+
24
+ **Target Directory:** {{args}}
25
+
26
+
27
+ ---
28
+
29
+ ## Pre-Flight
30
+
31
+ ```bash
32
+ echo "Running API contract validation on {{args}}..."
33
+ echo "================================================"
34
+ ```
35
+
36
+ Verify the target directory exists:
37
+
38
+ ```bash
39
+ test -d "{{args}}" && echo "✓ Directory exists: {{args}}" || echo "ERROR: Directory '{{args}}' not found"
40
+ ```
41
+
42
+ Enter and confirm location:
43
+
44
+ ```bash
45
+ cd "{{args}}" && pwd
46
+ ```
47
+
48
+ Check path exists:
49
+
50
+ ```bash
51
+ [ -e "{{args}}" ] && echo "✓ {{args}} exists" || echo "Target directory does not exist"
52
+ ```
53
+
54
+
55
+ ---
56
+
57
+ ## Agent Invocation
58
+
59
+ Run the API Contract Validator agent on the validated target directory:
60
+
61
+ **Agent:** api-contract-validator-agent.md
62
+ **Model:** Sonnet
63
+ **Target:** {{args}}
64
+
65
+
66
+ ---
67
+
68
+ ## Decision Thresholds
69
+
70
+ | Score | Decision | Meaning |
71
+ |-------|----------|---------|
72
+ | **>=80** | ✅ PASS | Validation passed, proceed to next phase |
73
+ | **<80** | ❌ FAIL | Validation failed, fix issues before proceeding |
74
+
75
+ **Note:** Any critical issue triggers FAIL regardless of score.
76
+
77
+ ---
78
+
79
+ ## Post-Flight Actions
80
+
81
+ ### On Success
82
+
83
+ API contract validation passed with score >= 80
84
+
85
+ ```bash
86
+ exit 0
87
+ ```
88
+
89
+ ### On Failure
90
+
91
+ API contract validation failed. Review drift above.
92
+
93
+ ```bash
94
+ exit 1
95
+ ```
96
+
97
+
98
+ ---
99
+
100
+
101
+ ## PERSIST TO TRACKER (Required)
102
+
103
+ > **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
104
+ **1. Get token metrics from buffer:**
105
+ ```bash
106
+ agent-metrics buffer list --since 5m -f tracker
107
+ ```
108
+
109
+ **2. Save to tracker (DO THIS FIRST):**
110
+
111
+ mcp__uluops-tracker__save_run
112
+
113
+ **3. Verify saved:** Compare `json.summary.total_issues` with saved count.
114
+
115
+ **4. THEN present summary to user.**
116
+
117
+ ### Field Mappings
118
+
119
+ **Definition identity (REQUIRED for execution tracking):**
120
+ | Tracker Field | Value | Notes |
121
+ |---------------|-------|-------|
122
+ | `definition_type` | `command` | From CDL interface |
123
+ | `definition_name` | `api-contract` | From CDL interface |
124
+ | `definition_version` | `1.0.2` | From CDL interface |
125
+
126
+ **From JSON OUTPUT to Tracker:**
127
+ | Source | Tracker Field | Notes |
128
+ |--------|---------------|-------|
129
+ | `json.result.score` | `agents[].score` | Total score |
130
+ | `json.result.decision` | `agents[].decision` | PASS/FAIL |
131
+ | `buffer.model` | `validators[].model` | From agent-metrics buffer |
132
+ | `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
133
+ | `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
134
+ | `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
135
+ | `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
136
+ | `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
137
+ | `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
138
+ | `json.analysis.records[]` | `analysis_records[]` | Structured analysis records (v1.4.0) |
139
+ | `json.analysis.system_metrics` | `analysis_summary.system_metrics` | Agent-type-specific metrics |
140
+ | `json.analysis.category_scores[]` | `analysis_summary.category_scores[]` | Category score breakdown |
141
+ | `json.analysis.epistemic_assessment` | `analysis_summary.epistemic_assessment` | Failure signature risk ratings |
142
+ | `json.analysis.audit_implications[]` | `analysis_summary.audit_implications[]` | Trajectory projections |
143
+
144
+ **Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
145
+ **Note:** `analysis_records` and `analysis_summary` are optional (v1.4.0). Omit if agent output has no `analysis` section.
146
+
147
+ ---
148
+
149
+ ## Source
150
+
151
+ **CDL Schema:** `udl/definition-languages/cdl-schema-v1_3_0.json`
152
+ **CDL Source:** `/Users/aself/uluops/uluops-agent-workflows/udl/cdl/v1/api-contract.command.yaml`
153
+ **Agent:** `agents/api-contract-validator-agent.md`
154
+ '''
@@ -0,0 +1,154 @@
1
+ description = "Run Pre-Implementation Architect to validate design before coding. Reviews architectural fit, complexity, scope. Use BEFORE starting implementation."
2
+ prompt = '''
3
+ # Pre-Implementation Architect v1
4
+ Run Pre-Implementation Architect to validate design before coding. Reviews architectural fit, complexity, scope. Use BEFORE starting implementation.
5
+
6
+ ## What's New in v1
7
+
8
+ | Feature | Description |
9
+ |---------|-------------|
10
+ | **Calibration Examples** | Reference scenarios for consistent scoring |
11
+ | **Failure Code Examples** | Worked examples mapping issues to taxonomy codes |
12
+ | **Token Budget** | Output length guidance |
13
+ | **Display IDs** | Auto-fail conditions have numbered IDs |
14
+
15
+ ## Arguments
16
+
17
+ **Usage:** `/agents:architect <directory>`
18
+
19
+ **Examples:**
20
+ - `/agents:architect ./docs/design.md`
21
+ - `/agents:architect ./PRD.md`
22
+ - `/agents:architect .`
23
+
24
+ **Target Directory:** {{args}}
25
+
26
+
27
+ ---
28
+
29
+ ## Pre-Flight
30
+
31
+ ```bash
32
+ echo "Running architecture review on {{args}}..."
33
+ echo "============================================"
34
+ ```
35
+
36
+ Verify the target directory exists:
37
+
38
+ ```bash
39
+ test -d "{{args}}" && echo "✓ Directory exists: {{args}}" || echo "ERROR: Directory '{{args}}' not found"
40
+ ```
41
+
42
+ Enter and confirm location:
43
+
44
+ ```bash
45
+ cd "{{args}}" && pwd
46
+ ```
47
+
48
+ Check path exists:
49
+
50
+ ```bash
51
+ [ -e "{{args}}" ] && echo "✓ {{args}} exists" || echo "Target directory does not exist"
52
+ ```
53
+
54
+
55
+ ---
56
+
57
+ ## Agent Invocation
58
+
59
+ Run the Pre-Implementation Architect agent on the validated target directory:
60
+
61
+ **Agent:** pre-implementation-architect-agent.md
62
+ **Model:** Sonnet
63
+ **Target:** {{args}}
64
+
65
+
66
+ ---
67
+
68
+ ## Decision Thresholds
69
+
70
+ | Score | Decision | Meaning |
71
+ |-------|----------|---------|
72
+ | **>=80** | ✅ PASS | Validation passed, proceed to next phase |
73
+ | **<80** | ❌ FAIL | Validation failed, fix issues before proceeding |
74
+
75
+ **Note:** Any critical issue triggers FAIL regardless of score.
76
+
77
+ ---
78
+
79
+ ## Post-Flight Actions
80
+
81
+ ### On Success
82
+
83
+ Architecture review passed with score >= 80
84
+
85
+ ```bash
86
+ exit 0
87
+ ```
88
+
89
+ ### On Failure
90
+
91
+ Architecture review failed. Review issues above.
92
+
93
+ ```bash
94
+ exit 1
95
+ ```
96
+
97
+
98
+ ---
99
+
100
+
101
+ ## PERSIST TO TRACKER (Required)
102
+
103
+ > **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
104
+ **1. Get token metrics from buffer:**
105
+ ```bash
106
+ agent-metrics buffer list --since 5m -f tracker
107
+ ```
108
+
109
+ **2. Save to tracker (DO THIS FIRST):**
110
+
111
+ mcp__uluops-tracker__save_run
112
+
113
+ **3. Verify saved:** Compare `json.summary.total_issues` with saved count.
114
+
115
+ **4. THEN present summary to user.**
116
+
117
+ ### Field Mappings
118
+
119
+ **Definition identity (REQUIRED for execution tracking):**
120
+ | Tracker Field | Value | Notes |
121
+ |---------------|-------|-------|
122
+ | `definition_type` | `command` | From CDL interface |
123
+ | `definition_name` | `architect` | From CDL interface |
124
+ | `definition_version` | `1.0.2` | From CDL interface |
125
+
126
+ **From JSON OUTPUT to Tracker:**
127
+ | Source | Tracker Field | Notes |
128
+ |--------|---------------|-------|
129
+ | `json.result.score` | `agents[].score` | Total score |
130
+ | `json.result.decision` | `agents[].decision` | PASS/FAIL |
131
+ | `buffer.model` | `validators[].model` | From agent-metrics buffer |
132
+ | `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
133
+ | `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
134
+ | `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
135
+ | `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
136
+ | `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
137
+ | `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
138
+ | `json.analysis.records[]` | `analysis_records[]` | Structured analysis records (v1.4.0) |
139
+ | `json.analysis.system_metrics` | `analysis_summary.system_metrics` | Agent-type-specific metrics |
140
+ | `json.analysis.category_scores[]` | `analysis_summary.category_scores[]` | Category score breakdown |
141
+ | `json.analysis.epistemic_assessment` | `analysis_summary.epistemic_assessment` | Failure signature risk ratings |
142
+ | `json.analysis.audit_implications[]` | `analysis_summary.audit_implications[]` | Trajectory projections |
143
+
144
+ **Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
145
+ **Note:** `analysis_records` and `analysis_summary` are optional (v1.4.0). Omit if agent output has no `analysis` section.
146
+
147
+ ---
148
+
149
+ ## Source
150
+
151
+ **CDL Schema:** `udl/definition-languages/cdl-schema-v1_3_0.json`
152
+ **CDL Source:** `/Users/aself/uluops/uluops-agent-workflows/udl/cdl/v1/architect.command.yaml`
153
+ **Agent:** `agents/pre-implementation-architect-agent.md`
154
+ '''
@@ -0,0 +1,155 @@
1
+ description = "Performs Aristotelian four-cause decomposition on any artifact. Identifies material, formal, efficient, and final causes. Distinguishes essential from accidental properties. Decision TELEOLOGICAL/ATELEOLOGICAL."
2
+ prompt = '''
3
+ # Aristotle Analyst v1
4
+ Performs Aristotelian four-cause decomposition on any artifact. Identifies material, formal, efficient, and final causes. Distinguishes essential from accidental properties. Decision TELEOLOGICAL/ATELEOLOGICAL.
5
+
6
+ ## What's New in v1
7
+
8
+ | Feature | Description |
9
+ |---------|-------------|
10
+ | **Calibration Examples** | Reference scenarios for consistent scoring |
11
+ | **Failure Code Examples** | Worked examples mapping issues to taxonomy codes |
12
+ | **Token Budget** | Output length guidance |
13
+ | **Display IDs** | Auto-fail conditions have numbered IDs |
14
+
15
+ ## Arguments
16
+
17
+ **Usage:** `/agents:aristotle-analyst <directory>`
18
+
19
+ **Examples:**
20
+ - `/agents:aristotle-analyst udl/adl/v3/code-validator.agent.yaml`
21
+ - `/agents:aristotle-analyst docs/architecture.md`
22
+ - `/agents:aristotle-analyst specs/api-spec.md`
23
+ - `/agents:aristotle-analyst agents/my-agent.md`
24
+
25
+ **Target Directory:** {{args}}
26
+
27
+
28
+ ---
29
+
30
+ ## Pre-Flight
31
+
32
+ ```bash
33
+ echo "Running Aristotelian four-cause decomposition on {{args}}..."
34
+ echo "=============================================================="
35
+ ```
36
+
37
+ Verify the target directory exists:
38
+
39
+ ```bash
40
+ test -d "{{args}}" && echo "✓ Directory exists: {{args}}" || echo "ERROR: Directory '{{args}}' not found"
41
+ ```
42
+
43
+ Enter and confirm location:
44
+
45
+ ```bash
46
+ cd "{{args}}" && pwd
47
+ ```
48
+
49
+ Check path exists:
50
+
51
+ ```bash
52
+ [ -e "{{args}}" ] && echo "✓ {{args}} exists" || echo "Target file or directory does not exist"
53
+ ```
54
+
55
+
56
+ ---
57
+
58
+ ## Agent Invocation
59
+
60
+ Run the Aristotle Analyst agent on the validated target directory:
61
+
62
+ **Agent:** aristotle-analyst-agent.md
63
+ **Model:** Opus
64
+ **Target:** {{args}}
65
+
66
+
67
+ ---
68
+
69
+ ## Decision Thresholds
70
+
71
+ | Score | Decision | Meaning |
72
+ |-------|----------|---------|
73
+ | **>=70** | ✅ PASS | Validation passed, proceed to next phase |
74
+ | **<70** | ❌ FAIL | Validation failed, fix issues before proceeding |
75
+
76
+ **Note:** Any critical issue triggers FAIL regardless of score.
77
+
78
+ ---
79
+
80
+ ## Post-Flight Actions
81
+
82
+ ### On Success
83
+
84
+ Artifact TELEOLOGICAL — means properly ordered toward ends
85
+
86
+ ```bash
87
+ exit 0
88
+ ```
89
+
90
+ ### On Failure
91
+
92
+ Artifact ATELEOLOGICAL — telos incoherent or means disconnected from ends
93
+
94
+ ```bash
95
+ exit 1
96
+ ```
97
+
98
+
99
+ ---
100
+
101
+
102
+ ## PERSIST TO TRACKER (Required)
103
+
104
+ > **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
105
+ **1. Get token metrics from buffer:**
106
+ ```bash
107
+ agent-metrics buffer list --since 5m -f tracker
108
+ ```
109
+
110
+ **2. Save to tracker (DO THIS FIRST):**
111
+
112
+ mcp__uluops-tracker__save_run
113
+
114
+ **3. Verify saved:** Compare `json.summary.total_issues` with saved count.
115
+
116
+ **4. THEN present summary to user.**
117
+
118
+ ### Field Mappings
119
+
120
+ **Definition identity (REQUIRED for execution tracking):**
121
+ | Tracker Field | Value | Notes |
122
+ |---------------|-------|-------|
123
+ | `definition_type` | `command` | From CDL interface |
124
+ | `definition_name` | `aristotle-analyst` | From CDL interface |
125
+ | `definition_version` | `1.0.2` | From CDL interface |
126
+
127
+ **From JSON OUTPUT to Tracker:**
128
+ | Source | Tracker Field | Notes |
129
+ |--------|---------------|-------|
130
+ | `json.result.score` | `agents[].score` | Total score |
131
+ | `json.result.decision` | `agents[].decision` | PASS/FAIL |
132
+ | `buffer.model` | `validators[].model` | From agent-metrics buffer |
133
+ | `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
134
+ | `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
135
+ | `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
136
+ | `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
137
+ | `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
138
+ | `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
139
+ | `json.analysis.records[]` | `analysis_records[]` | Structured analysis records (v1.4.0) |
140
+ | `json.analysis.system_metrics` | `analysis_summary.system_metrics` | Agent-type-specific metrics |
141
+ | `json.analysis.category_scores[]` | `analysis_summary.category_scores[]` | Category score breakdown |
142
+ | `json.analysis.epistemic_assessment` | `analysis_summary.epistemic_assessment` | Failure signature risk ratings |
143
+ | `json.analysis.audit_implications[]` | `analysis_summary.audit_implications[]` | Trajectory projections |
144
+
145
+ **Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
146
+ **Note:** `analysis_records` and `analysis_summary` are optional (v1.4.0). Omit if agent output has no `analysis` section.
147
+
148
+ ---
149
+
150
+ ## Source
151
+
152
+ **CDL Schema:** `udl/definition-languages/cdl-schema-v1_3_0.json`
153
+ **CDL Source:** `/Users/aself/uluops/uluops-agent-workflows/udl/cdl/v1/aristotle-analyst.command.yaml`
154
+ **Agent:** `agents/aristotle-analyst-agent.md`
155
+ '''