@uluops/setup 0.2.0

package/assets/commands/agents/validate.md

@@ -0,0 +1,134 @@
+---
+name: validate
+description: Validates code quality, standards compliance, and test coverage. Use after each implementation phase.
+---
+
+# Code Validator
+Validates code quality, standards compliance, and test coverage. Use after each implementation phase.
+
+## Arguments
+
+**Usage:** `/agents:validate <directory>`
+
+**Examples:**
+- `/agents:validate ./services/auth-service`
+- `/agents:validate ./packages/api`
+- `/agents:validate .`
+
+**Target Directory:** $ARGUMENTS
+
+---
+
+## Pre-Flight
+
+```bash
+echo "Running code 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 path exists:
+
+```bash
+[ -e "$ARGUMENTS" ] && echo "✓ $ARGUMENTS exists" || echo "Target directory does not exist"
+```
+
+
+---
+
+## Agent Invocation
+
+Run the Code Validator agent on the validated target directory:
+
+**Agent:** code-validator-agent.md
+**Model:** Sonnet
+**Target:** $ARGUMENTS
+
+The agent performs code quality validation across 4 categories (100 points total):
+
+| Category | Points | Focus |
+|----------|--------|-------|
+| Code Quality | 30 | Function design, naming, duplication, error handling, complexity |
+| Standards Compliance | 25 | Style guide adherence, formatting, imports, documentation |
+| Testing | 25 | Unit tests, edge cases, behavior verification, test execution |
+| Best Practices | 20 | Security basics, performance, separation of concerns, dependencies |
+
+---
+
+## Auto-Fail Conditions
+
+Critical issues that trigger immediate FAIL regardless of score:
+
+| ID | Condition |
+|----|-----------|
+| **AF-001** | Security vulnerabilities detected |
+| **AF-002** | Missing error handling in critical paths |
+| **AF-003** | Code does not function |
+| **AF-004** | Missing tests for core functionality |
+| **AF-005** | Breaking changes without migration path |
+
+---
+
+## Decision Thresholds
+
+| Score | Decision | Meaning |
+|-------|----------|---------|
+| **>=70** | ✅ PASS | Validation passed, proceed to next phase |
+| **<70** | ❌ 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. Save to tracker (REQUIRED):**
+
+```bash
+agent-metrics buffer list --since 5m -f tracker
+```
+
+mcp__uluops-tracker__save_features_list
+
+**2. Verify saved:** Compare `json.summary.total_issues` with saved count.
+
+**3. 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/validate.command.yaml`
+**Agent:** `agents/code-validator-agent.md`

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

@@ -0,0 +1,101 @@
+---
+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`