@uluops/setup 0.4.0 → 0.6.3

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 (213) hide show
  1. package/LICENSE +21 -0
  2. package/README.md +75 -60
  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 +49 -416
  152. package/dist/commands/helpers.d.ts +73 -0
  153. package/dist/commands/helpers.js +311 -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 +17 -8
  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 +15 -7
  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/auth.d.ts +6 -0
  189. package/dist/steps/auth.js +19 -2
  190. package/dist/steps/cli.d.ts +53 -0
  191. package/dist/steps/cli.js +90 -0
  192. package/dist/steps/commands.d.ts +1 -1
  193. package/dist/steps/commands.js +20 -71
  194. package/dist/steps/detect.js +4 -0
  195. package/dist/steps/mcp.js +7 -15
  196. package/dist/steps/metrics.d.ts +12 -0
  197. package/dist/steps/metrics.js +52 -22
  198. package/dist/steps/shell.js +11 -1
  199. package/dist/steps/signup.d.ts +2 -2
  200. package/dist/steps/signup.js +9 -12
  201. package/dist/steps/verify.js +47 -8
  202. package/package.json +12 -11
  203. package/assets/agents/docs-validator-agent.md +0 -490
  204. package/assets/agents/release-readiness-agent.md +0 -482
  205. package/assets/commands/agents/aristotle-analyst.md +0 -116
  206. package/assets/commands/agents/aristotle-explorer.md +0 -93
  207. package/assets/commands/agents/aristotle-forecaster.md +0 -115
  208. package/assets/commands/agents/aristotle-validator.md +0 -115
  209. package/assets/commands/agents/prompt-validate.md +0 -136
  210. package/assets/commands/agents/workflow-synthesis.md +0 -102
  211. package/assets/commands/workflows/post-implementation.md +0 -577
  212. package/assets/commands/workflows/pre-implementation.md +0 -670
  213. /package/assets/{agents → claude-code/agents}/anxiety-reader-agent.md +0 -0
@@ -1,115 +0,0 @@
1
- ---
2
- name: aristotle-forecaster
3
- description: Performs Aristotelian potentiality-to-actuality projection on any artifact. Maps trajectory from current state to full actualization, identifies impediments to telos realization. Decision: HIGH_CONFIDENCE/MODERATE_CONFIDENCE/LOW_CONFIDENCE.
4
- model: opus
5
- ---
6
-
7
- # Aristotle Forecaster
8
- Performs Aristotelian potentiality-to-actuality projection on any artifact — code, specs, plans, architectures, or documents. Cognitive lens agent from the Cognitive Lens Library.
9
-
10
- ## Arguments
11
-
12
- **Usage:** `/agents:aristotle-forecaster <target>`
13
-
14
- **Examples:**
15
- - `/agents:aristotle-forecaster uluops-registry-api/`
16
- - `/agents:aristotle-forecaster udl/adl/v3/code-validator.agent.yaml`
17
- - `/agents:aristotle-forecaster docs/specs/cognitive-lens-library-spec.md`
18
- - `/agents:aristotle-forecaster packages/cli/`
19
-
20
- **Target:** $ARGUMENTS
21
-
22
- ---
23
-
24
- ## Pre-Flight
25
-
26
- Verify the target exists:
27
-
28
- ```bash
29
- [ -e "$ARGUMENTS" ] && echo "✓ $ARGUMENTS exists" || echo "Target file or directory does not exist"
30
- ```
31
-
32
- ---
33
-
34
- ## Agent Invocation
35
-
36
- Run the Aristotle Forecaster agent on the target:
37
-
38
- **Agent:** aristotle-forecaster-agent.md
39
- **Model:** Opus
40
- **Target:** $ARGUMENTS
41
-
42
- The agent performs Aristotelian potentiality-to-actuality projection across 5 categories (100 points total):
43
-
44
- | Category | Points | Focus |
45
- |----------|--------|-------|
46
- | Potentiality Identification | 25 | Latent capabilities, structural grounding, potentiality vs possibility |
47
- | Actualization Pathways | 25 | Pathway specificity, natural ordering, form alignment |
48
- | Impediment Analysis | 20 | Structural impediments (not resource constraints), actionable specificity |
49
- | Teleological Trajectory | 15 | Movement toward/away from telos, potentiality-telos connection |
50
- | Temporal Precision | 15 | Actualization stages, current position on trajectory |
51
-
52
- ## Auto-Fail Conditions
53
-
54
- | ID | Condition | Severity |
55
- |----|-----------|----------|
56
- | AF-001 | Feature requests presented as potentiality analysis | Critical |
57
- | AF-002 | Impediments listed as resource constraints rather than structural barriers | Critical |
58
- | AF-003 | No connection between potentialities and artifact's telos | Critical |
59
-
60
- ---
61
-
62
- ## Decision Thresholds
63
-
64
- | Score | Decision | Meaning |
65
- |-------|----------|---------|
66
- | **>=75** | HIGH_CONFIDENCE | Trajectory is clear, potentialities well-mapped, impediments specific |
67
- | **50-74** | MODERATE_CONFIDENCE | Trajectory partially clear, some potentialities uncertain |
68
- | **<50** | LOW_CONFIDENCE | Trajectory unclear, insufficient structural evidence for projection |
69
-
70
- **Note:** This is an advisory decision. HIGH_CONFIDENCE means the artifact's trajectory is well-understood — not that the trajectory is desirable.
71
-
72
- ---
73
-
74
- ## PERSIST TO TRACKER (Required)
75
-
76
- > **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user.
77
-
78
- **1. Get token metrics from buffer:**
79
- ```bash
80
- agent-metrics buffer list --since 5m -f tracker
81
- ```
82
-
83
- **2. Save to tracker (DO THIS FIRST):**
84
-
85
- mcp__uluops-tracker__save_features_list
86
-
87
- **3. Verify saved:** Compare `json.summary.total_issues` with saved count.
88
-
89
- **4. THEN present summary to user.**
90
-
91
- ### Field Mappings
92
-
93
- **From JSON OUTPUT to Tracker:**
94
- | Source | Tracker Field | Notes |
95
- |--------|---------------|-------|
96
- | `json.result.score` | `validators[].score` | Total score |
97
- | `json.result.decision` | `validators[].status` | HIGH_CONFIDENCE/MODERATE_CONFIDENCE/LOW_CONFIDENCE |
98
- | `buffer.model` | `validators[].model` | From agent-metrics buffer |
99
- | `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
100
- | `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
101
- | `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
102
- | `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
103
- | `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
104
- | `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
105
-
106
- **Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
107
-
108
- ---
109
-
110
- ## Source
111
-
112
- **ADL Schema:** `udl/definition-languages/adl-schema-v1.10.0.json`
113
- **ADL Source:** `udl/adl/v3/aristotle-forecaster.agent.yaml`
114
- **Agent:** `agents/v3/aristotle-forecaster-agent.md`
115
- **Spec:** `docs/specs/cognitive-lens-library-spec.md`
@@ -1,115 +0,0 @@
1
- ---
2
- name: aristotle-validator
3
- description: Performs Aristotelian teleological alignment validation on any artifact. Checks whether means are properly ordered toward ends, whether components fulfill their natural function, and whether category errors exist. Decision: ALIGNED/MISALIGNED.
4
- model: opus
5
- ---
6
-
7
- # Aristotle Validator
8
- Performs Aristotelian teleological alignment validation on any artifact — code, specs, plans, architectures, or documents. Cognitive lens agent from the Cognitive Lens Library.
9
-
10
- ## Arguments
11
-
12
- **Usage:** `/agents:aristotle-validator <target>`
13
-
14
- **Examples:**
15
- - `/agents:aristotle-validator uluops-registry-api/`
16
- - `/agents:aristotle-validator udl/adl/v3/code-validator.agent.yaml`
17
- - `/agents:aristotle-validator docs/specs/cognitive-lens-library-spec.md`
18
- - `/agents:aristotle-validator packages/cli/`
19
-
20
- **Target:** $ARGUMENTS
21
-
22
- ---
23
-
24
- ## Pre-Flight
25
-
26
- Verify the target exists:
27
-
28
- ```bash
29
- [ -e "$ARGUMENTS" ] && echo "✓ $ARGUMENTS exists" || echo "Target file or directory does not exist"
30
- ```
31
-
32
- ---
33
-
34
- ## Agent Invocation
35
-
36
- Run the Aristotle Validator agent on the target:
37
-
38
- **Agent:** aristotle-validator-agent.md
39
- **Model:** Opus
40
- **Target:** $ARGUMENTS
41
-
42
- The agent performs Aristotelian teleological alignment across 5 categories (100 points total):
43
-
44
- | Category | Points | Focus |
45
- |----------|--------|-------|
46
- | Teleological Coherence | 25 | Telos identified, means-end chain traced, misalignment surfaced |
47
- | Categorical Correctness | 25 | Category errors detected, natural function assessed |
48
- | Essential/Accidental Distinction | 20 | Essential properties preserved, accidentals not treated as essential |
49
- | Four-Cause Completeness | 15 | Causal grounding, efficient/final causes distinguished |
50
- | Potentiality Assessment | 15 | Actualization trajectory, impediments identified |
51
-
52
- ## Auto-Fail Conditions
53
-
54
- | ID | Condition | Severity |
55
- |----|-----------|----------|
56
- | AF-001 | No genuine teleological alignment assessment performed | Critical |
57
- | AF-002 | Telos assumed rather than identified and defended | Critical |
58
- | AF-003 | Technical quality evaluation substituted for teleological alignment | Critical |
59
- | AF-004 | No category error detection performed | Critical |
60
-
61
- ---
62
-
63
- ## Decision Thresholds
64
-
65
- | Score | Decision | Meaning |
66
- |-------|----------|---------|
67
- | **>=70** | ALIGNED | Artifact's components are coherently ordered toward an identifiable telos |
68
- | **<70** | MISALIGNED | Components serve unclear or contradictory purposes, or analysis is incomplete |
69
-
70
- **Note:** This is an advisory decision, not a deployment gate. ALIGNED means the artifact's parts serve a coherent purpose — not that the artifact is correct or desirable.
71
-
72
- ---
73
-
74
- ## PERSIST TO TRACKER (Required)
75
-
76
- > **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user.
77
-
78
- **1. Get token metrics from buffer:**
79
- ```bash
80
- agent-metrics buffer list --since 5m -f tracker
81
- ```
82
-
83
- **2. Save to tracker (DO THIS FIRST):**
84
-
85
- mcp__uluops-tracker__save_features_list
86
-
87
- **3. Verify saved:** Compare `json.summary.total_issues` with saved count.
88
-
89
- **4. THEN present summary to user.**
90
-
91
- ### Field Mappings
92
-
93
- **From JSON OUTPUT to Tracker:**
94
- | Source | Tracker Field | Notes |
95
- |--------|---------------|-------|
96
- | `json.result.score` | `validators[].score` | Total score |
97
- | `json.result.decision` | `validators[].status` | ALIGNED/MISALIGNED |
98
- | `buffer.model` | `validators[].model` | From agent-metrics buffer |
99
- | `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
100
- | `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
101
- | `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
102
- | `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
103
- | `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
104
- | `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
105
-
106
- **Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
107
-
108
- ---
109
-
110
- ## Source
111
-
112
- **ADL Schema:** `udl/definition-languages/adl-schema-v1.10.0.json`
113
- **ADL Source:** `udl/adl/v3/aristotle-validator.agent.yaml`
114
- **Agent:** `agents/v3/aristotle-validator-agent.md`
115
- **Spec:** `docs/specs/cognitive-lens-library-spec.md`
@@ -1,136 +0,0 @@
1
- ---
2
- name: prompt-validate
3
- description: Validates AI agent prompts for quality and consistency before deployment. Run before adding new agents to the project.
4
- model: opus
5
- ---
6
-
7
- # Prompt Validator
8
- Validates AI agent prompts for quality and consistency before deployment. Run before adding new agents to the project.
9
-
10
- ## Arguments
11
-
12
- **Usage:** `/agents:prompt-validate <directory>`
13
-
14
- **Examples:**
15
- - `/agents:prompt-validate agents/my-agent.md`
16
- - `/agents:prompt-validate vdl/my-validator.yaml`
17
-
18
- **Target Directory:** $ARGUMENTS
19
-
20
- ---
21
-
22
- ## Pre-Flight
23
-
24
- ```bash
25
- echo "Running prompt validation on $ARGUMENTS..."
26
- echo "=========================================="
27
- ```
28
-
29
- Verify the target directory exists:
30
-
31
- ```bash
32
- test -d "$ARGUMENTS" && echo "✓ Directory exists: $ARGUMENTS" || echo "ERROR: Directory '$ARGUMENTS' not found"
33
- ```
34
-
35
- Enter and confirm location:
36
-
37
- ```bash
38
- cd "$ARGUMENTS" && pwd
39
- ```
40
-
41
- Check file exists:
42
-
43
- ```bash
44
- [ -f "$ARGUMENTS" ] && echo "✓ $ARGUMENTS found" || echo "Target file does not exist"
45
- ```
46
-
47
-
48
- ---
49
-
50
- ## Agent Invocation
51
-
52
- Run the Prompt Validator agent on the validated target directory:
53
-
54
- **Agent:** prompt-engineer-agent.md
55
- **Model:** Sonnet
56
- **Target:** $ARGUMENTS
57
-
58
- The agent performs code quality validation across 5 categories (100 points total):
59
-
60
- | Category | Points | Focus |
61
- |----------|--------|-------|
62
- | Clarity & Specificity | 25 | Mission is unambiguous, success criteria explicit, output format clear |
63
- | Structure & Organization | 20 | Logical flow, consistent formatting, and information hierarchy |
64
- | Completeness | 25 | Edge cases, fallbacks, error handling, examples, and constraints |
65
- | Effectiveness | 20 | Scoring is actionable, criteria measurable, output usable |
66
- | Consistency | 10 | Adherence to project conventions and terminology |
67
-
68
- ---
69
-
70
- ## Auto-Fail Conditions
71
-
72
- Critical issues that trigger immediate FAIL regardless of score:
73
-
74
- | ID | Condition |
75
- |----|-----------|
76
- | **AF-001** | Undefined or vague mission statement |
77
- | **AF-002** | No output format specification |
78
- | **AF-003** | Conflicting instructions in different sections |
79
- | **AF-004** | Subjective-only decision criteria |
80
- | **AF-005** | Missing error/edge case handling |
81
- | **AF-006** | Scoring points that cannot be objectively verified |
82
-
83
- ---
84
-
85
- ## Decision Thresholds
86
-
87
- | Score | Decision | Meaning |
88
- |-------|----------|---------|
89
- | **>=75** | ✅ PASS | Validation passed, proceed to next phase |
90
- | **<75** | ❌ FAIL | Validation failed, fix issues before proceeding |
91
-
92
- **Note:** Any critical issue triggers FAIL regardless of score.
93
-
94
- ---
95
-
96
-
97
- ## PERSIST TO TRACKER (Required)
98
-
99
- > **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
100
- **1. Get token metrics from buffer:**
101
- ```bash
102
- agent-metrics buffer list --since 5m -f tracker
103
- ```
104
-
105
- **2. Save to tracker (DO THIS FIRST):**
106
-
107
- mcp__uluops-tracker__save_features_list
108
-
109
- **3. Verify saved:** Compare `json.summary.total_issues` with saved count.
110
-
111
- **4. THEN present summary to user.**
112
-
113
- ### Field Mappings
114
-
115
- **From JSON OUTPUT to Tracker:**
116
- | Source | Tracker Field | Notes |
117
- |--------|---------------|-------|
118
- | `json.result.score` | `validators[].score` | Total score |
119
- | `json.result.decision` | `validators[].status` | PASS/FAIL |
120
- | `buffer.model` | `validators[].model` | From agent-metrics buffer |
121
- | `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
122
- | `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
123
- | `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
124
- | `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
125
- | `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
126
- | `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
127
-
128
- **Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
129
-
130
- ---
131
-
132
- ## Source
133
-
134
- **CDL Schema:** `udl/definition-languages/cdl-schema-v1.1.0.json`
135
- **CDL Source:** `/home/alexs/uluops/uluops-agent-workflows/udl/cdl/v1/prompt-validate.command.yaml`
136
- **Agent:** `agents/prompt-engineer-agent.md`
@@ -1,102 +0,0 @@
1
- ---
2
- name: workflow-synthesis
3
- description: Synthesizes cross-cutting insights from multiple upstream agent outputs. Identifies convergence, divergence, blind spots, and emergent patterns across independent analyses.
4
- model: opus
5
- ---
6
-
7
- # Workflow Synthesis
8
- Synthesizes cross-cutting insights from multiple upstream agent outputs in any workflow. Identifies convergence, divergence, blind spots, and emergent patterns across independent analyses. Produces meta-insights absent from any individual output.
9
-
10
- ## Arguments
11
-
12
- **Usage:** `/agents:workflow-synthesis <directory>`
13
-
14
- **Examples:**
15
- - `/agents:workflow-synthesis .`
16
- - `/agents:workflow-synthesis src/`
17
-
18
- **Target Directory:** $ARGUMENTS
19
-
20
- ---
21
-
22
- ## Pre-Flight
23
-
24
- ```bash
25
- echo "Running workflow synthesis on $ARGUMENTS..."
26
- echo "============================================"
27
- ```
28
-
29
- Verify the target directory exists:
30
-
31
- ```bash
32
- test -d "$ARGUMENTS" && echo "✓ Directory exists: $ARGUMENTS" || echo "ERROR: Directory '$ARGUMENTS' not found"
33
- ```
34
-
35
- Enter and confirm location:
36
-
37
- ```bash
38
- cd "$ARGUMENTS" && pwd
39
- ```
40
-
41
- ---
42
-
43
- ## Agent Invocation
44
-
45
- Run the Workflow Synthesis agent on the validated target directory:
46
-
47
- **Agent:** workflow-synthesis-agent.md
48
- **Model:** Opus
49
- **Target:** $ARGUMENTS
50
-
51
- The agent synthesizes cross-cutting insights from multiple upstream analyses.
52
-
53
- ---
54
-
55
- ## Decision Thresholds
56
-
57
- | Score | Decision | Meaning |
58
- |-------|----------|---------|
59
- | **INTEGRATED** | Analyses converge on consistent picture | |
60
- | **FRAGMENTED** | Significant divergence or blind spots found | |
61
-
62
- ---
63
-
64
-
65
- ## PERSIST TO TRACKER (Required)
66
-
67
- > **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
68
- **1. Get token metrics from buffer:**
69
- ```bash
70
- agent-metrics buffer list --since 5m -f tracker
71
- ```
72
-
73
- **2. Save to tracker (DO THIS FIRST):**
74
-
75
- mcp__uluops-tracker__save_features_list
76
-
77
- **3. Verify saved:** Compare `json.summary.total_issues` with saved count.
78
-
79
- **4. THEN present summary to user.**
80
-
81
- ### Field Mappings
82
-
83
- **From JSON OUTPUT to Tracker:**
84
- | Source | Tracker Field | Notes |
85
- |--------|---------------|-------|
86
- | `json.result.score` | `validators[].score` | Total score |
87
- | `json.result.decision` | `validators[].status` | INTEGRATED/FRAGMENTED |
88
- | `buffer.model` | `validators[].model` | From agent-metrics buffer |
89
- | `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
90
- | `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
91
- | `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
92
- | `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
93
- | `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
94
- | `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
95
-
96
- **Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
97
-
98
- ---
99
-
100
- ## Source
101
-
102
- **Agent:** `agents/workflow-synthesis-agent.md`