@uluops/setup 0.4.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 (211) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +67 -50
  3. package/assets/auto-tracker-save.mjs +142 -0
  4. package/assets/{agents → claude-code/agents}/api-contract-validator-agent.md +9 -228
  5. package/assets/{agents → claude-code/agents}/aristotle-analyst-agent.md +51 -4
  6. package/assets/{agents → claude-code/agents}/aristotle-explorer-agent.md +6 -2
  7. package/assets/{agents → claude-code/agents}/aristotle-forecaster-agent.md +15 -230
  8. package/assets/{agents → claude-code/agents}/aristotle-validator-agent.md +12 -252
  9. package/assets/{agents → claude-code/agents}/assumption-excavator-agent.md +21 -247
  10. package/assets/{agents → claude-code/agents}/code-auditor-agent.md +12 -255
  11. package/assets/{agents → claude-code/agents}/code-optimizer-agent.md +15 -236
  12. package/assets/{agents → claude-code/agents}/code-validator-agent.md +31 -300
  13. package/assets/claude-code/agents/docs-validator-agent.md +472 -0
  14. package/assets/{agents → claude-code/agents}/frontend-validator-agent.md +15 -258
  15. package/assets/{agents → claude-code/agents}/mcp-validator-agent.md +8 -252
  16. package/assets/{agents → claude-code/agents}/pre-implementation-architect-agent.md +8 -224
  17. package/assets/{agents → claude-code/agents}/prompt-engineer-agent.md +57 -290
  18. package/assets/{agents → claude-code/agents}/prompt-pattern-analyzer-agent.md +10 -225
  19. package/assets/{agents → claude-code/agents}/prompt-quality-validator-agent.md +11 -249
  20. package/assets/{agents → claude-code/agents}/public-interface-validator-agent.md +15 -268
  21. package/assets/claude-code/agents/release-readiness-agent.md +495 -0
  22. package/assets/{agents → claude-code/agents}/security-analyst-agent.md +236 -480
  23. package/assets/{agents → claude-code/agents}/test-architect-agent.md +16 -259
  24. package/assets/{agents → claude-code/agents}/type-safety-validator-agent.md +23 -266
  25. package/assets/{agents → claude-code/agents}/workflow-synthesis-agent.md +23 -226
  26. package/assets/{commands → claude-code/commands}/agents/anxiety-reader.md +12 -15
  27. package/assets/{commands → claude-code/commands}/agents/api-contract.md +156 -136
  28. package/assets/{commands → claude-code/commands}/agents/architect.md +156 -136
  29. package/assets/claude-code/commands/agents/aristotle-analyst.md +157 -0
  30. package/assets/claude-code/commands/agents/aristotle-explorer.md +157 -0
  31. package/assets/claude-code/commands/agents/aristotle-forecaster.md +157 -0
  32. package/assets/claude-code/commands/agents/aristotle-validator.md +157 -0
  33. package/assets/{commands → claude-code/commands}/agents/assumption-excavator.md +49 -7
  34. package/assets/{commands → claude-code/commands}/agents/audit.md +156 -137
  35. package/assets/{commands → claude-code/commands}/agents/docs-validate.md +156 -134
  36. package/assets/{commands → claude-code/commands}/agents/frontend.md +156 -136
  37. package/assets/{commands → claude-code/commands}/agents/mcp-validate.md +156 -137
  38. package/assets/{commands → claude-code/commands}/agents/optimize.md +156 -134
  39. package/assets/{commands → claude-code/commands}/agents/pattern-analyzer.md +150 -127
  40. package/assets/{commands → claude-code/commands}/agents/prompt-quality.md +155 -135
  41. package/assets/claude-code/commands/agents/prompt-validate.md +155 -0
  42. package/assets/{commands → claude-code/commands}/agents/public-interface.md +156 -135
  43. package/assets/{commands → claude-code/commands}/agents/release.md +156 -136
  44. package/assets/{commands → claude-code/commands}/agents/security.md +156 -138
  45. package/assets/{commands → claude-code/commands}/agents/test-review.md +156 -137
  46. package/assets/{commands → claude-code/commands}/agents/type-safety.md +156 -136
  47. package/assets/{commands/agents/code-validate.md → claude-code/commands/agents/validate.md} +156 -135
  48. package/assets/claude-code/commands/agents/workflow-synthesis.md +157 -0
  49. package/assets/{commands → claude-code/commands}/pipelines/aristotle.md +8 -8
  50. package/assets/{commands → claude-code/commands}/pipelines/ship.md +8 -8
  51. package/assets/claude-code/commands/workflows/post-implementation.md +60 -0
  52. package/assets/claude-code/commands/workflows/pre-implementation.md +46 -0
  53. package/assets/{commands → claude-code/commands}/workflows/prompt-audit.md +2 -2
  54. package/assets/codex/agents/anxiety-reader-agent.toml +462 -0
  55. package/assets/codex/agents/api-contract-validator-agent.toml +738 -0
  56. package/assets/codex/agents/aristotle-analyst-agent.toml +750 -0
  57. package/assets/codex/agents/aristotle-explorer-agent.toml +155 -0
  58. package/assets/codex/agents/aristotle-forecaster-agent.toml +449 -0
  59. package/assets/codex/agents/aristotle-validator-agent.toml +424 -0
  60. package/assets/codex/agents/assumption-excavator-agent.toml +1126 -0
  61. package/assets/codex/agents/code-auditor-agent.toml +815 -0
  62. package/assets/codex/agents/code-optimizer-agent.toml +652 -0
  63. package/assets/codex/agents/code-validator-agent.toml +573 -0
  64. package/assets/codex/agents/docs-validator-agent.toml +468 -0
  65. package/assets/codex/agents/frontend-validator-agent.toml +598 -0
  66. package/assets/codex/agents/mcp-validator-agent.toml +580 -0
  67. package/assets/codex/agents/pre-implementation-architect-agent.toml +817 -0
  68. package/assets/codex/agents/prompt-engineer-agent.toml +922 -0
  69. package/assets/codex/agents/prompt-pattern-analyzer-agent.toml +689 -0
  70. package/assets/codex/agents/prompt-quality-validator-agent.toml +777 -0
  71. package/assets/codex/agents/public-interface-validator-agent.toml +695 -0
  72. package/assets/codex/agents/release-readiness-agent.toml +491 -0
  73. package/assets/codex/agents/security-analyst-agent.toml +847 -0
  74. package/assets/codex/agents/test-architect-agent.toml +615 -0
  75. package/assets/codex/agents/type-safety-validator-agent.toml +686 -0
  76. package/assets/codex/agents/workflow-synthesis-agent.toml +631 -0
  77. package/assets/gemini-cli/agents/anxiety-reader-agent.md +470 -0
  78. package/assets/gemini-cli/agents/api-contract-validator-agent.md +747 -0
  79. package/assets/gemini-cli/agents/aristotle-analyst-agent.md +758 -0
  80. package/assets/gemini-cli/agents/aristotle-explorer-agent.md +163 -0
  81. package/assets/gemini-cli/agents/aristotle-forecaster-agent.md +457 -0
  82. package/assets/gemini-cli/agents/aristotle-validator-agent.md +432 -0
  83. package/assets/gemini-cli/agents/assumption-excavator-agent.md +1134 -0
  84. package/assets/gemini-cli/agents/code-auditor-agent.md +827 -0
  85. package/assets/gemini-cli/agents/code-optimizer-agent.md +661 -0
  86. package/assets/gemini-cli/agents/code-validator-agent.md +582 -0
  87. package/assets/gemini-cli/agents/docs-validator-agent.md +477 -0
  88. package/assets/gemini-cli/agents/frontend-validator-agent.md +610 -0
  89. package/assets/gemini-cli/agents/mcp-validator-agent.md +589 -0
  90. package/assets/gemini-cli/agents/pre-implementation-architect-agent.md +826 -0
  91. package/assets/gemini-cli/agents/prompt-engineer-agent.md +931 -0
  92. package/assets/gemini-cli/agents/prompt-pattern-analyzer-agent.md +698 -0
  93. package/assets/gemini-cli/agents/prompt-quality-validator-agent.md +786 -0
  94. package/assets/gemini-cli/agents/public-interface-validator-agent.md +707 -0
  95. package/assets/gemini-cli/agents/release-readiness-agent.md +500 -0
  96. package/assets/gemini-cli/agents/security-analyst-agent.md +859 -0
  97. package/assets/gemini-cli/agents/test-architect-agent.md +624 -0
  98. package/assets/gemini-cli/agents/type-safety-validator-agent.md +695 -0
  99. package/assets/gemini-cli/agents/workflow-synthesis-agent.md +639 -0
  100. package/assets/gemini-cli/commands/agents/anxiety-reader.toml +155 -0
  101. package/assets/gemini-cli/commands/agents/api-contract.toml +154 -0
  102. package/assets/gemini-cli/commands/agents/architect.toml +154 -0
  103. package/assets/gemini-cli/commands/agents/aristotle-analyst.toml +155 -0
  104. package/assets/gemini-cli/commands/agents/aristotle-explorer.toml +155 -0
  105. package/assets/gemini-cli/commands/agents/aristotle-forecaster.toml +155 -0
  106. package/assets/gemini-cli/commands/agents/aristotle-validator.toml +155 -0
  107. package/assets/gemini-cli/commands/agents/assumption-excavator.toml +155 -0
  108. package/assets/gemini-cli/commands/agents/audit.toml +154 -0
  109. package/assets/gemini-cli/commands/agents/docs-validate.toml +154 -0
  110. package/assets/gemini-cli/commands/agents/frontend.toml +154 -0
  111. package/assets/gemini-cli/commands/agents/mcp-validate.toml +154 -0
  112. package/assets/gemini-cli/commands/agents/optimize.toml +154 -0
  113. package/assets/gemini-cli/commands/agents/pattern-analyzer.toml +148 -0
  114. package/assets/gemini-cli/commands/agents/prompt-quality.toml +153 -0
  115. package/assets/gemini-cli/commands/agents/prompt-validate.toml +153 -0
  116. package/assets/gemini-cli/commands/agents/public-interface.toml +154 -0
  117. package/assets/gemini-cli/commands/agents/release.toml +154 -0
  118. package/assets/gemini-cli/commands/agents/security.toml +154 -0
  119. package/assets/gemini-cli/commands/agents/test-review.toml +154 -0
  120. package/assets/gemini-cli/commands/agents/type-safety.toml +154 -0
  121. package/assets/gemini-cli/commands/agents/validate.toml +154 -0
  122. package/assets/gemini-cli/commands/agents/workflow-synthesis.toml +155 -0
  123. package/assets/gemini-cli/commands/pipelines/aristotle.toml +139 -0
  124. package/assets/gemini-cli/commands/pipelines/ship.toml +184 -0
  125. package/assets/gemini-cli/commands/workflows/post-implementation.toml +56 -0
  126. package/assets/gemini-cli/commands/workflows/pre-implementation.toml +42 -0
  127. package/assets/gemini-cli/commands/workflows/prompt-audit.toml +40 -0
  128. package/assets/opencode/agents/anxiety-reader-agent.md +472 -0
  129. package/assets/opencode/agents/api-contract-validator-agent.md +749 -0
  130. package/assets/opencode/agents/aristotle-analyst-agent.md +760 -0
  131. package/assets/opencode/agents/aristotle-explorer-agent.md +164 -0
  132. package/assets/opencode/agents/aristotle-forecaster-agent.md +459 -0
  133. package/assets/opencode/agents/aristotle-validator-agent.md +434 -0
  134. package/assets/opencode/agents/assumption-excavator-agent.md +1136 -0
  135. package/assets/opencode/agents/code-auditor-agent.md +826 -0
  136. package/assets/opencode/agents/code-optimizer-agent.md +663 -0
  137. package/assets/opencode/agents/code-validator-agent.md +584 -0
  138. package/assets/opencode/agents/docs-validator-agent.md +479 -0
  139. package/assets/opencode/agents/frontend-validator-agent.md +609 -0
  140. package/assets/opencode/agents/mcp-validator-agent.md +591 -0
  141. package/assets/opencode/agents/pre-implementation-architect-agent.md +828 -0
  142. package/assets/opencode/agents/prompt-engineer-agent.md +933 -0
  143. package/assets/opencode/agents/prompt-pattern-analyzer-agent.md +700 -0
  144. package/assets/opencode/agents/prompt-quality-validator-agent.md +788 -0
  145. package/assets/opencode/agents/public-interface-validator-agent.md +706 -0
  146. package/assets/opencode/agents/release-readiness-agent.md +502 -0
  147. package/assets/opencode/agents/security-analyst-agent.md +858 -0
  148. package/assets/opencode/agents/test-architect-agent.md +626 -0
  149. package/assets/opencode/agents/type-safety-validator-agent.md +697 -0
  150. package/assets/opencode/agents/workflow-synthesis-agent.md +641 -0
  151. package/dist/cli.js +12 -414
  152. package/dist/commands/helpers.d.ts +73 -0
  153. package/dist/commands/helpers.js +274 -0
  154. package/dist/commands/setup.d.ts +13 -0
  155. package/dist/commands/setup.js +93 -0
  156. package/dist/commands/uninstall.d.ts +3 -0
  157. package/dist/commands/uninstall.js +126 -0
  158. package/dist/commands/verify.d.ts +1 -0
  159. package/dist/commands/verify.js +28 -0
  160. package/dist/harnesses/claude-code.d.ts +1 -1
  161. package/dist/harnesses/claude-code.js +3 -1
  162. package/dist/harnesses/codex.js +6 -5
  163. package/dist/harnesses/gemini-cli.d.ts +4 -8
  164. package/dist/harnesses/gemini-cli.js +47 -21
  165. package/dist/harnesses/index.d.ts +10 -1
  166. package/dist/harnesses/index.js +11 -2
  167. package/dist/harnesses/opencode.d.ts +1 -1
  168. package/dist/harnesses/opencode.js +15 -6
  169. package/dist/harnesses/types.d.ts +19 -0
  170. package/dist/harnesses/types.js +2 -0
  171. package/dist/lib/asset-catalog.js +2 -2
  172. package/dist/lib/config-merger.d.ts +2 -1
  173. package/dist/lib/config-merger.js +12 -4
  174. package/dist/lib/file-ops.d.ts +5 -0
  175. package/dist/lib/file-ops.js +18 -3
  176. package/dist/lib/hash.d.ts +1 -1
  177. package/dist/lib/hash.js +2 -2
  178. package/dist/lib/manifest.d.ts +30 -1
  179. package/dist/lib/manifest.js +5 -7
  180. package/dist/lib/paths.d.ts +16 -1
  181. package/dist/lib/paths.js +31 -3
  182. package/dist/lib/settings-merger.d.ts +24 -9
  183. package/dist/lib/settings-merger.js +57 -22
  184. package/dist/lib/version.d.ts +2 -0
  185. package/dist/lib/version.js +10 -0
  186. package/dist/steps/agents.d.ts +1 -2
  187. package/dist/steps/agents.js +7 -18
  188. package/dist/steps/cli.d.ts +53 -0
  189. package/dist/steps/cli.js +90 -0
  190. package/dist/steps/commands.d.ts +1 -1
  191. package/dist/steps/commands.js +20 -71
  192. package/dist/steps/detect.js +4 -0
  193. package/dist/steps/mcp.js +7 -15
  194. package/dist/steps/metrics.d.ts +12 -0
  195. package/dist/steps/metrics.js +52 -22
  196. package/dist/steps/shell.js +11 -1
  197. package/dist/steps/signup.d.ts +2 -2
  198. package/dist/steps/signup.js +9 -12
  199. package/dist/steps/verify.js +47 -8
  200. package/package.json +12 -11
  201. package/assets/agents/docs-validator-agent.md +0 -490
  202. package/assets/agents/release-readiness-agent.md +0 -482
  203. package/assets/commands/agents/aristotle-analyst.md +0 -116
  204. package/assets/commands/agents/aristotle-explorer.md +0 -93
  205. package/assets/commands/agents/aristotle-forecaster.md +0 -115
  206. package/assets/commands/agents/aristotle-validator.md +0 -115
  207. package/assets/commands/agents/prompt-validate.md +0 -136
  208. package/assets/commands/agents/workflow-synthesis.md +0 -102
  209. package/assets/commands/workflows/post-implementation.md +0 -577
  210. package/assets/commands/workflows/pre-implementation.md +0 -670
  211. /package/assets/{agents → claude-code/agents}/anxiety-reader-agent.md +0 -0
@@ -0,0 +1,155 @@
1
+ description = "Performs Aristotelian categorical mapping on any artifact. Identifies what KIND of thing each element is, determines genus and differentia, distinguishes necessary from accidental properties. Produces a taxonomic map."
2
+ prompt = '''
3
+ # Aristotle Explorer v1
4
+ Performs Aristotelian categorical mapping on any artifact. Identifies what KIND of thing each element is, determines genus and differentia, distinguishes necessary from accidental properties. Produces a taxonomic map.
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-explorer <directory>`
18
+
19
+ **Examples:**
20
+ - `/agents:aristotle-explorer udl/adl/v3/code-validator.agent.yaml`
21
+ - `/agents:aristotle-explorer docs/architecture.md`
22
+ - `/agents:aristotle-explorer src/lib/domain/`
23
+ - `/agents:aristotle-explorer packages/cli/src/commands/`
24
+
25
+ **Target Directory:** {{args}}
26
+
27
+
28
+ ---
29
+
30
+ ## Pre-Flight
31
+
32
+ ```bash
33
+ echo "Running Aristotelian categorical mapping 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 Explorer agent on the validated target directory:
61
+
62
+ **Agent:** aristotle-explorer-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
+ Taxonomic map complete — categorical structure visible
85
+
86
+ ```bash
87
+ exit 0
88
+ ```
89
+
90
+ ### On Failure
91
+
92
+ Categorical mapping incomplete — significant elements unclassified
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-explorer` | 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-explorer.command.yaml`
154
+ **Agent:** `agents/aristotle-explorer-agent.md`
155
+ '''
@@ -0,0 +1,155 @@
1
+ description = "Performs Aristotelian potentiality-to-actuality projection on any artifact. Maps trajectory from current state to full actualization and identifies impediments to telos realization. Decision HIGH_CONFIDENCE/MODERATE_CONFIDENCE/LOW_CONFIDENCE."
2
+ prompt = '''
3
+ # Aristotle Forecaster v1
4
+ Performs Aristotelian potentiality-to-actuality projection on any artifact. Maps trajectory from current state to full actualization and identifies impediments to telos realization. Decision HIGH_CONFIDENCE/MODERATE_CONFIDENCE/LOW_CONFIDENCE.
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-forecaster <directory>`
18
+
19
+ **Examples:**
20
+ - `/agents:aristotle-forecaster udl/adl/v3/code-validator.agent.yaml`
21
+ - `/agents:aristotle-forecaster docs/recursive-appreciation-hypothesis-v1.3.0.md`
22
+ - `/agents:aristotle-forecaster packages/cli/src/commands/exec/agent.ts`
23
+ - `/agents:aristotle-forecaster specs/api-spec.md`
24
+
25
+ **Target Directory:** {{args}}
26
+
27
+
28
+ ---
29
+
30
+ ## Pre-Flight
31
+
32
+ ```bash
33
+ echo "Running Aristotelian potentiality-to-actuality projection 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 Forecaster agent on the validated target directory:
61
+
62
+ **Agent:** aristotle-forecaster-agent.md
63
+ **Model:** Opus
64
+ **Target:** {{args}}
65
+
66
+
67
+ ---
68
+
69
+ ## Decision Thresholds
70
+
71
+ | Score | Decision | Meaning |
72
+ |-------|----------|---------|
73
+ | **>=75** | ✅ PASS | Validation passed, proceed to next phase |
74
+ | **<75** | ❌ 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
+ Actualization trajectory projected — developmental path mapped
85
+
86
+ ```bash
87
+ exit 0
88
+ ```
89
+
90
+ ### On Failure
91
+
92
+ Trajectory projection incomplete — impediments to actualization may be underestimated
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-forecaster` | 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-forecaster.command.yaml`
154
+ **Agent:** `agents/aristotle-forecaster-agent.md`
155
+ '''
@@ -0,0 +1,155 @@
1
+ description = "Performs Aristotelian teleological alignment validation on any artifact. Checks whether means are properly ordered toward ends and whether components fulfill their natural function. Decision ALIGNED/MISALIGNED."
2
+ prompt = '''
3
+ # Aristotle Validator v1
4
+ Performs Aristotelian teleological alignment validation on any artifact. Checks whether means are properly ordered toward ends and whether components fulfill their natural function. Decision ALIGNED/MISALIGNED.
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-validator <directory>`
18
+
19
+ **Examples:**
20
+ - `/agents:aristotle-validator udl/adl/v3/code-validator.agent.yaml`
21
+ - `/agents:aristotle-validator docs/architecture.md`
22
+ - `/agents:aristotle-validator specs/api-spec.md`
23
+ - `/agents:aristotle-validator agents/my-agent.md`
24
+
25
+ **Target Directory:** {{args}}
26
+
27
+
28
+ ---
29
+
30
+ ## Pre-Flight
31
+
32
+ ```bash
33
+ echo "Running Aristotelian teleological alignment validation 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 Validator agent on the validated target directory:
61
+
62
+ **Agent:** aristotle-validator-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 ALIGNED — teleological coherence confirmed
85
+
86
+ ```bash
87
+ exit 0
88
+ ```
89
+
90
+ ### On Failure
91
+
92
+ Artifact MISALIGNED — category errors or teleological incoherence detected
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-validator` | 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-validator.command.yaml`
154
+ **Agent:** `agents/aristotle-validator-agent.md`
155
+ '''
@@ -0,0 +1,155 @@
1
+ description = "Surfaces implicit assumptions buried in any artifact — agent definitions, prompts, specs, plans, workflows, or documents. Produces a ranked assumption inventory with fragility scores."
2
+ prompt = '''
3
+ # Assumption Excavator v1
4
+ Surfaces implicit assumptions buried in any artifact — agent definitions, prompts, specs, plans, workflows, or documents. Produces a ranked assumption inventory with fragility scores.
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:assumption-excavator <directory>`
18
+
19
+ **Examples:**
20
+ - `/agents:assumption-excavator udl/adl/v3/code-validator.agent.yaml`
21
+ - `/agents:assumption-excavator agents/my-agent.md`
22
+ - `/agents:assumption-excavator docs/architecture.md`
23
+ - `/agents:assumption-excavator specs/api-spec.md`
24
+
25
+ **Target Directory:** {{args}}
26
+
27
+
28
+ ---
29
+
30
+ ## Pre-Flight
31
+
32
+ ```bash
33
+ echo "Running assumption excavation 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 Assumption Excavator agent on the validated target directory:
61
+
62
+ **Agent:** assumption-excavator-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
+ Assumption profile EXAMINED — proceed with awareness
85
+
86
+ ```bash
87
+ exit 0
88
+ ```
89
+
90
+ ### On Failure
91
+
92
+ Assumption profile UNEXAMINED — critical buried assumptions remain
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` | `assumption-excavator` | 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/assumption-excavator.command.yaml`
154
+ **Agent:** `agents/assumption-excavator-agent.md`
155
+ '''