Run a Validation

Agent(subagent_type: "code-validator", prompt: "Validate ./src")

# Individual agents
/agents:code-validate ./src
/agents:type-safety ./src
/agents:public-interface ./src
/agents:security ./src

# Multi-agent pipelines (gated phases)
/pipelines:ship ./src
/pipelines:post-implementation ./src

AGENT REPORT

Files Reviewed:
- src/api/users.ts
- src/services/auth.ts
- src/utils/errors.ts

━━━━━━━━━━━━━━━━━━━━━━━━━━
VALIDATION RESULTS
━━━━━━━━━━━━━━━━━━━━━━━━━━

Score: 78/100

Async Safety:          25/30
Error Propagation:     22/25
Input Validation:      18/25
Error Messages:        13/20

━━━━━━━━━━━━━━━━━━━━━━━━━━
ISSUES FOUND
━━━━━━━━━━━━━━━━━━━━━━━━━━

CRITICAL (Must Fix):
- Empty catch block swallows database error: src/api/users.ts:45 [PRA-EFF/H]
  Empty catch block silently discards connection failures

WARNINGS (Should Fix):
- Missing null check on .find() result: src/services/auth.ts:23 [SEM-COM/M]
  user.role accessed without verifying user exists
- Error message not actionable: src/utils/errors.ts:78 [STR-OMI/M]
  "Invalid input" — should specify which field and expected format

━━━━━━━━━━━━━━━━━━━━━━━━━━
DECISION
━━━━━━━━━━━━━━━━━━━━━━━━━━

PASS — Score 78 meets threshold (≥70)
1 critical issue should be addressed before shipping

save_run({
  project: "my-project",
  workflow_type: "post-implementation",
  agents: [
    { name: "code-validator", score: 85, decision: "PASS" },
    { name: "test-architect", score: 72, decision: "APPROVED" }
  ],
  recommendations: [
    {
      agent: "code-validator",
      title: "Missing error boundary in React component",
      priority: "suggested",
      severity: "medium",
      failure_code: "SEM-COM/M",
      file_path: "src/components/Dashboard.tsx",
      line_number: 15
    }
  ]
})

get_project_summary({ project: "my-project" })

# Run a single agent (defaults to Claude Sonnet)
ulu exec agent code-validator -t ./src --project my-project

# Run a workflow (multiple agents, gated phases)
ulu exec workflow ship ./src --project my-project

# Use a different model provider
ulu exec agent code-validator -t ./src --project my-project --model gpt-5
ulu exec agent code-validator -t ./src --project my-project --model gemini-3

import { UluOpsClient } from '@uluops/core';

const client = new UluOpsClient({
  apiKey: process.env.ULUOPS_API_KEY,
  defaultProject: 'my-project',
});

const result = await client.runAgent('code-validator', './src', {
  model: 'sonnet',
});

console.log(result.score);           // 85
console.log(result.decision);        // "PASS"
console.log(result.recommendations); // [{ title, priority, failure_code, ... }]

import { OpsClient } from '@uluops/ops-sdk';

const client = new OpsClient({ apiKey: process.env.ULUOPS_API_KEY });

const result = await client.runs.save({
  project: 'my-project',
  workflowType: 'post-implementation',
  agents: [
    { name: 'code-validator', score: 85, decision: 'PASS' },
    { name: 'test-architect', score: 72, decision: 'APPROVED' },
  ],
  recommendations: [
    {
      agent: 'code-validator',
      title: 'Missing error boundary in React component',
      priority: 'suggested',
      severity: 'medium',
      failureCode: 'SEM-COM/M',
      filePath: 'src/components/Dashboard.tsx',
      lineNumber: 15,
    },
  ],
});

// Check if all gates passed
if (result.run.allGatesPassed) {
  console.log('All agents passed — safe to deploy');
} else {
  console.log(`${result.correlation.newIssues} new issues found`);
  process.exit(1);
}

# .github/workflows/validate.yml
- name: Run validation
  run: npx tsx scripts/validate.ts
  env:
    ULUOPS_API_KEY: ${{ secrets.ULUOPS_API_KEY }}
    ANTHROPIC_API_KEY: ${{ secrets.ANTHROPIC_API_KEY }}