@uluops/setup 0.2.0 → 0.6.0

package/assets/commands/agents/aristotle-forecaster.md

@@ -1,114 +0,0 @@
----
-name: aristotle-forecaster
-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.
----
-
-# Aristotle Forecaster
-Performs Aristotelian potentiality-to-actuality projection on any artifact — code, specs, plans, architectures, or documents. Cognitive lens agent from the Cognitive Lens Library.
-
-## Arguments
-
-**Usage:** `/agents:aristotle-forecaster <target>`
-
-**Examples:**
-- `/agents:aristotle-forecaster uluops-registry-api/`
-- `/agents:aristotle-forecaster udl/adl/v3/code-validator.agent.yaml`
-- `/agents:aristotle-forecaster docs/specs/cognitive-lens-library-spec.md`
-- `/agents:aristotle-forecaster packages/cli/`
-
-**Target:** $ARGUMENTS
-
----
-
-## Pre-Flight
-
-Verify the target exists:
-
-```bash
-[ -e "$ARGUMENTS" ] && echo "✓ $ARGUMENTS exists" || echo "Target file or directory does not exist"
-```
-
----
-
-## Agent Invocation
-
-Run the Aristotle Forecaster agent on the target:
-
-**Agent:** aristotle-forecaster-agent.md
-**Model:** Opus
-**Target:** $ARGUMENTS
-
-The agent performs Aristotelian potentiality-to-actuality projection across 5 categories (100 points total):
-
-| Category | Points | Focus |
-|----------|--------|-------|
-| Potentiality Identification | 25 | Latent capabilities, structural grounding, potentiality vs possibility |
-| Actualization Pathways | 25 | Pathway specificity, natural ordering, form alignment |
-| Impediment Analysis | 20 | Structural impediments (not resource constraints), actionable specificity |
-| Teleological Trajectory | 15 | Movement toward/away from telos, potentiality-telos connection |
-| Temporal Precision | 15 | Actualization stages, current position on trajectory |
-
-## Auto-Fail Conditions
-
-| ID | Condition | Severity |
-|----|-----------|----------|
-| AF-001 | Feature requests presented as potentiality analysis | Critical |
-| AF-002 | Impediments listed as resource constraints rather than structural barriers | Critical |
-| AF-003 | No connection between potentialities and artifact's telos | Critical |
-
----
-
-## Decision Thresholds
-
-| Score | Decision | Meaning |
-|-------|----------|---------|
-| **>=75** | HIGH_CONFIDENCE | Trajectory is clear, potentialities well-mapped, impediments specific |
-| **50-74** | MODERATE_CONFIDENCE | Trajectory partially clear, some potentialities uncertain |
-| **<50** | LOW_CONFIDENCE | Trajectory unclear, insufficient structural evidence for projection |
-
-**Note:** This is an advisory decision. HIGH_CONFIDENCE means the artifact's trajectory is well-understood — not that the trajectory is desirable.
-
----
-
-## PERSIST TO TRACKER (Required)
-
-> **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user.
-
-**1. Get token metrics from buffer:**
-```bash
-agent-metrics buffer list --since 5m -f tracker
-```
-
-**2. Save to tracker (DO THIS FIRST):**
-
-mcp__uluops-tracker__save_features_list
-
-**3. Verify saved:** Compare `json.summary.total_issues` with saved count.
-
-**4. THEN present summary to user.**
-
-### Field Mappings
-
-**From JSON OUTPUT to Tracker:**
-| Source | Tracker Field | Notes |
-|--------|---------------|-------|
-| `json.result.score` | `validators[].score` | Total score |
-| `json.result.decision` | `validators[].status` | HIGH_CONFIDENCE/MODERATE_CONFIDENCE/LOW_CONFIDENCE |
-| `buffer.model` | `validators[].model` | From agent-metrics buffer |
-| `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
-| `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
-| `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
-| `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
-| `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
-| `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
-
-**Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
-
----
-
-## Source
-
-**ADL Schema:** `udl/definition-languages/adl-schema-v1.10.0.json`
-**ADL Source:** `udl/adl/v3/aristotle-forecaster.agent.yaml`
-**Agent:** `agents/v3/aristotle-forecaster-agent.md`
-**Spec:** `docs/specs/cognitive-lens-library-spec.md`

package/assets/commands/agents/aristotle-validator.md

@@ -1,114 +0,0 @@
----
-name: aristotle-validator
-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.
----
-
-# Aristotle Validator
-Performs Aristotelian teleological alignment validation on any artifact — code, specs, plans, architectures, or documents. Cognitive lens agent from the Cognitive Lens Library.
-
-## Arguments
-
-**Usage:** `/agents:aristotle-validator <target>`
-
-**Examples:**
-- `/agents:aristotle-validator uluops-registry-api/`
-- `/agents:aristotle-validator udl/adl/v3/code-validator.agent.yaml`
-- `/agents:aristotle-validator docs/specs/cognitive-lens-library-spec.md`
-- `/agents:aristotle-validator packages/cli/`
-
-**Target:** $ARGUMENTS
-
----
-
-## Pre-Flight
-
-Verify the target exists:
-
-```bash
-[ -e "$ARGUMENTS" ] && echo "✓ $ARGUMENTS exists" || echo "Target file or directory does not exist"
-```
-
----
-
-## Agent Invocation
-
-Run the Aristotle Validator agent on the target:
-
-**Agent:** aristotle-validator-agent.md
-**Model:** Opus
-**Target:** $ARGUMENTS
-
-The agent performs Aristotelian teleological alignment across 5 categories (100 points total):
-
-| Category | Points | Focus |
-|----------|--------|-------|
-| Teleological Coherence | 25 | Telos identified, means-end chain traced, misalignment surfaced |
-| Categorical Correctness | 25 | Category errors detected, natural function assessed |
-| Essential/Accidental Distinction | 20 | Essential properties preserved, accidentals not treated as essential |
-| Four-Cause Completeness | 15 | Causal grounding, efficient/final causes distinguished |
-| Potentiality Assessment | 15 | Actualization trajectory, impediments identified |
-
-## Auto-Fail Conditions
-
-| ID | Condition | Severity |
-|----|-----------|----------|
-| AF-001 | No genuine teleological alignment assessment performed | Critical |
-| AF-002 | Telos assumed rather than identified and defended | Critical |
-| AF-003 | Technical quality evaluation substituted for teleological alignment | Critical |
-| AF-004 | No category error detection performed | Critical |
-
----
-
-## Decision Thresholds
-
-| Score | Decision | Meaning |
-|-------|----------|---------|
-| **>=70** | ALIGNED | Artifact's components are coherently ordered toward an identifiable telos |
-| **<70** | MISALIGNED | Components serve unclear or contradictory purposes, or analysis is incomplete |
-
-**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.
-
----
-
-## PERSIST TO TRACKER (Required)
-
-> **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user.
-
-**1. Get token metrics from buffer:**
-```bash
-agent-metrics buffer list --since 5m -f tracker
-```
-
-**2. Save to tracker (DO THIS FIRST):**
-
-mcp__uluops-tracker__save_features_list
-
-**3. Verify saved:** Compare `json.summary.total_issues` with saved count.
-
-**4. THEN present summary to user.**
-
-### Field Mappings
-
-**From JSON OUTPUT to Tracker:**
-| Source | Tracker Field | Notes |
-|--------|---------------|-------|
-| `json.result.score` | `validators[].score` | Total score |
-| `json.result.decision` | `validators[].status` | ALIGNED/MISALIGNED |
-| `buffer.model` | `validators[].model` | From agent-metrics buffer |
-| `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
-| `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
-| `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
-| `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
-| `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
-| `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
-
-**Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
-
----
-
-## Source
-
-**ADL Schema:** `udl/definition-languages/adl-schema-v1.10.0.json`
-**ADL Source:** `udl/adl/v3/aristotle-validator.agent.yaml`
-**Agent:** `agents/v3/aristotle-validator-agent.md`
-**Spec:** `docs/specs/cognitive-lens-library-spec.md`

package/assets/commands/agents/prompt-validate.md

@@ -1,135 +0,0 @@
----
-name: prompt-validate
-description: Validates AI agent prompts for quality and consistency before deployment. Run before adding new agents to the project.
----
-
-# Prompt Validator
-Validates AI agent prompts for quality and consistency before deployment. Run before adding new agents to the project.
-
-## Arguments
-
-**Usage:** `/agents:prompt-validate <directory>`
-
-**Examples:**
-- `/agents:prompt-validate agents/my-agent.md`
-- `/agents:prompt-validate vdl/my-validator.yaml`
-
-**Target Directory:** $ARGUMENTS
-
----
-
-## Pre-Flight
-
-```bash
-echo "Running prompt validation on $ARGUMENTS..."
-echo "=========================================="
-```
-
-Verify the target directory exists:
-
-```bash
-test -d "$ARGUMENTS" && echo "✓ Directory exists: $ARGUMENTS" || echo "ERROR: Directory '$ARGUMENTS' not found"
-```
-
-Enter and confirm location:
-
-```bash
-cd "$ARGUMENTS" && pwd
-```
-
-Check file exists:
-
-```bash
-[ -f "$ARGUMENTS" ] && echo "✓ $ARGUMENTS found" || echo "Target file does not exist"
-```
-
-
----
-
-## Agent Invocation
-
-Run the Prompt Validator agent on the validated target directory:
-
-**Agent:** prompt-engineer-agent.md
-**Model:** Sonnet
-**Target:** $ARGUMENTS
-
-The agent performs code quality validation across 5 categories (100 points total):
-
-| Category | Points | Focus |
-|----------|--------|-------|
-| Clarity & Specificity | 25 | Mission is unambiguous, success criteria explicit, output format clear |
-| Structure & Organization | 20 | Logical flow, consistent formatting, and information hierarchy |
-| Completeness | 25 | Edge cases, fallbacks, error handling, examples, and constraints |
-| Effectiveness | 20 | Scoring is actionable, criteria measurable, output usable |
-| Consistency | 10 | Adherence to project conventions and terminology |
-
----
-
-## Auto-Fail Conditions
-
-Critical issues that trigger immediate FAIL regardless of score:
-
-| ID | Condition |
-|----|-----------|
-| **AF-001** | Undefined or vague mission statement |
-| **AF-002** | No output format specification |
-| **AF-003** | Conflicting instructions in different sections |
-| **AF-004** | Subjective-only decision criteria |
-| **AF-005** | Missing error/edge case handling |
-| **AF-006** | Scoring points that cannot be objectively verified |
-
----
-
-## Decision Thresholds
-
-| Score | Decision | Meaning |
-|-------|----------|---------|
-| **>=75** | ✅ PASS | Validation passed, proceed to next phase |
-| **<75** | ❌ FAIL | Validation failed, fix issues before proceeding |
-
-**Note:** Any critical issue triggers FAIL regardless of score.
-
----
-
-
-## PERSIST TO TRACKER (Required)
-
-> **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
-**1. Get token metrics from buffer:**
-```bash
-agent-metrics buffer list --since 5m -f tracker
-```
-
-**2. Save to tracker (DO THIS FIRST):**
-
-mcp__uluops-tracker__save_features_list
-
-**3. Verify saved:** Compare `json.summary.total_issues` with saved count.
-
-**4. THEN present summary to user.**
-
-### Field Mappings
-
-**From JSON OUTPUT to Tracker:**
-| Source | Tracker Field | Notes |
-|--------|---------------|-------|
-| `json.result.score` | `validators[].score` | Total score |
-| `json.result.decision` | `validators[].status` | PASS/FAIL |
-| `buffer.model` | `validators[].model` | From agent-metrics buffer |
-| `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
-| `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
-| `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
-| `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
-| `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
-| `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
-
-**Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
-
----
-
-## Source
-
-**CDL Schema:** `udl/definition-languages/cdl-schema-v1.1.0.json`
-**CDL Source:** `/home/alexs/uluops/uluops-agent-workflows/udl/cdl/v1/prompt-validate.command.yaml`
-**Agent:** `agents/prompt-engineer-agent.md`

package/assets/commands/agents/workflow-synthesis.md

@@ -1,101 +0,0 @@
----
-name: workflow-synthesis
-description: Synthesizes cross-cutting insights from multiple upstream agent outputs. Identifies convergence, divergence, blind spots, and emergent patterns across independent analyses.
----
-
-# Workflow Synthesis
-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.
-
-## Arguments
-
-**Usage:** `/agents:workflow-synthesis <directory>`
-
-**Examples:**
-- `/agents:workflow-synthesis .`
-- `/agents:workflow-synthesis src/`
-
-**Target Directory:** $ARGUMENTS
-
----
-
-## Pre-Flight
-
-```bash
-echo "Running workflow synthesis on $ARGUMENTS..."
-echo "============================================"
-```
-
-Verify the target directory exists:
-
-```bash
-test -d "$ARGUMENTS" && echo "✓ Directory exists: $ARGUMENTS" || echo "ERROR: Directory '$ARGUMENTS' not found"
-```
-
-Enter and confirm location:
-
-```bash
-cd "$ARGUMENTS" && pwd
-```
-
----
-
-## Agent Invocation
-
-Run the Workflow Synthesis agent on the validated target directory:
-
-**Agent:** workflow-synthesis-agent.md
-**Model:** Opus
-**Target:** $ARGUMENTS
-
-The agent synthesizes cross-cutting insights from multiple upstream analyses.
-
----
-
-## Decision Thresholds
-
-| Score | Decision | Meaning |
-|-------|----------|---------|
-| **INTEGRATED** | Analyses converge on consistent picture | |
-| **FRAGMENTED** | Significant divergence or blind spots found | |
-
----
-
-
-## PERSIST TO TRACKER (Required)
-
-> **IMPORTANT:** Save to tracker IMMEDIATELY after agent completes, BEFORE presenting the summary to the user. The workflow is not complete until results are persisted.
-**1. Get token metrics from buffer:**
-```bash
-agent-metrics buffer list --since 5m -f tracker
-```
-
-**2. Save to tracker (DO THIS FIRST):**
-
-mcp__uluops-tracker__save_features_list
-
-**3. Verify saved:** Compare `json.summary.total_issues` with saved count.
-
-**4. THEN present summary to user.**
-
-### Field Mappings
-
-**From JSON OUTPUT to Tracker:**
-| Source | Tracker Field | Notes |
-|--------|---------------|-------|
-| `json.result.score` | `validators[].score` | Total score |
-| `json.result.decision` | `validators[].status` | INTEGRATED/FRAGMENTED |
-| `buffer.model` | `validators[].model` | From agent-metrics buffer |
-| `buffer.tokens.input_tokens` | `input_tokens` | Raw input tokens |
-| `buffer.tokens.output_tokens` | `output_tokens` | Output tokens |
-| `buffer.tokens.cache_creation_tokens` | `cache_creation_tokens` | Cache creation |
-| `buffer.tokens.cache_read_tokens` | `cache_read_tokens` | Cache reads |
-| `buffer.tokens.total_effective_tokens` | `total_effective_tokens` | Effective total |
-| `json.categories[].findings[].issues[]` | `recommendations[]` | Flatten nested structure |
-
-**Note:** `json` = agent's JSON OUTPUT, `buffer` = `agent-metrics buffer list -f tracker`
-
----
-
-## Source
-
-**Agent:** `agents/workflow-synthesis-agent.md`