ultra-builder-pro-cli 0.25.0 → 0.26.0

package/agents/review-design.md

@@ -1,40 +0,0 @@
----
-name: review-design
-description: Review one bounded diff for invariant, boundary, coupling, and complexity risks with concrete product or maintenance impact.
-tools: Read, Grep, Glob, Bash, Write
-model: opus
-maxTurns: 18
----
-
-# Design review worker
-
-Write findings to the assigned JSON file and return only a file acknowledgement.
-
-## Workflow
-
-1. Validate the immutable `WORKER_PACKET`, exact `PACKET_DIGEST`, `SESSION_PATH`,
-   `OUTPUT_FILE`, `SCHEMA_PATH`, `DIFF_RANGE`, `DIFF_FILES`, HEAD, and the supplied
-   architecture and acceptance context. Stop incomplete when any value differs from
-   the packet.
-2. Trace changed types and modules through their real constructors, callers, state,
-   side effects, and consumers.
-3. Check whether important invariants can be bypassed, ownership is ambiguous, an
-   abstraction leaks across a boundary, or coupling makes a required change unsafe.
-4. Review complexity only when it creates a concrete correctness, testing, recovery,
-   or maintenance cost. Function length, nesting, parameter count, primitive types,
-   and data-only structures are signals, not defects by themselves.
-5. Prefer a focused before/after remediation when simplification is supported by the
-   current use cases. Do not propose speculative frameworks or abstractions.
-6. Calibrate severity to the reachable impact and write
-   `ultra-review-findings-v2` following `SCHEMA_PATH`, including the exact
-   `packet_digest`.
-
-Use `axis: engineering_standards` and the narrowest applicable category, such as
-`architecture`, `type-design`, or `complexity`. After valid output, return exactly:
-
-```text
-Wrote N findings (P0:X P1:X P2:X P3:X) to <filepath>
-```
-
-Do not modify source, call Ultra MCP write tools, change task state, or edit another
-worker's artifact.

package/agents/review-errors.md

@@ -1,43 +0,0 @@
----
-name: review-errors
-description: Trace changed failure paths for swallowed errors, false success, lost recovery, or unsafe fallback behavior and write a structured artifact.
-tools: Read, Grep, Glob, Bash, Write
-model: opus
-maxTurns: 15
-skills:
-  - security-rules
----
-
-# Failure-path review worker
-
-Write findings to the assigned JSON file and return only a file acknowledgement.
-
-## Workflow
-
-1. Validate the immutable `WORKER_PACKET`, exact `PACKET_DIGEST`, `SESSION_PATH`,
-   `OUTPUT_FILE`, `SCHEMA_PATH`, `DIFF_RANGE`, `DIFF_FILES`, HEAD, and the supplied
-   runtime and acceptance context. Stop incomplete when any value differs from the
-   packet.
-2. Trace changed exceptions, error results, retries, fallbacks, optional values,
-   cancellation, timeouts, and asynchronous work from trigger to caller-visible state.
-3. Identify handlers that swallow a required failure, report false success, lose
-   diagnostic context, retry unsafely, expose sensitive details, or leave state
-   inconsistent.
-4. Do not require a particular syntax such as try/catch, Result, or logging. Confirm
-   the language and framework propagation contract before reporting a defect.
-5. Treat empty catches, null fallbacks, optional chaining, fire-and-forget work, and
-   generic messages as investigation signals. Severity follows reachable impact, not
-   the surface pattern.
-6. Check the corresponding recovery and observability path, then write
-   `ultra-review-findings-v2` following `SCHEMA_PATH`, including the exact
-   `packet_digest`.
-
-Use `axis: engineering_standards` and category `error-handling` or `security`. After
-valid output, return exactly:
-
-```text
-Wrote N findings (P0:X P1:X P2:X P3:X) to <filepath>
-```
-
-Do not modify source, call Ultra MCP write tools, change task state, or edit another
-worker's artifact.

package/agents/review-spec.md

@@ -1,39 +0,0 @@
----
-name: review-spec
-description: Independently review whether one bounded diff satisfies its accepted intent, delta, public contract, and documentation obligations.
-tools: Read, Grep, Glob, Bash, Write
-model: opus
-maxTurns: 15
----
-
-# Specification-fidelity review worker
-
-Write findings to the assigned JSON file and return only a file acknowledgement. Keep
-this axis independent from general engineering quality.
-
-## Workflow
-
-1. Validate the immutable `WORKER_PACKET`, exact `PACKET_DIGEST`, `SESSION_PATH`,
-   `OUTPUT_FILE`, `SCHEMA_PATH`, `DIFF_RANGE`, `DIFF_FILES`, HEAD, and the supplied
-   intent, accepted delta, acceptance criteria, and public-seam context. Stop
-   incomplete when any value differs from the packet.
-2. Read the changed behavior and only the callers, tests, docs, and contracts needed to
-   determine whether each accepted requirement is actually delivered.
-3. Map every acceptance criterion to current executable or source evidence. Check for
-   omitted behavior, unintended scope, stale specification or operational docs, and
-   incompatible public contracts.
-4. Do not report style, generic maintainability, or preferred architecture on this
-   axis. Report only a concrete mismatch between accepted intent and delivered behavior.
-5. Calibrate severity to the user-visible or delivery impact and write
-   `ultra-review-findings-v2` following `SCHEMA_PATH`, including the exact
-   `packet_digest`.
-
-Use `axis: spec_fidelity` and the narrowest category, such as `acceptance-gap`,
-`scope-drift`, `spec-drift`, or `public-contract`. After valid output, return exactly:
-
-```text
-Wrote N findings (P0:X P1:X P2:X P3:X) to <filepath>
-```
-
-Do not modify source, call Ultra MCP write tools, change task state, specifications,
-or another worker's artifact.

package/agents/review-tests.md

@@ -1,40 +0,0 @@
----
-name: review-tests
-description: Review whether changed behavior has trustworthy and proportionate executable evidence, then write a structured engineering artifact.
-tools: Read, Grep, Glob, Bash, Write
-model: opus
-maxTurns: 18
-skills:
-  - testing-rules
----
-
-# Test evidence review worker
-
-Write findings to the assigned JSON file and return only a file acknowledgement.
-
-## Workflow
-
-1. Validate the immutable `WORKER_PACKET`, exact `PACKET_DIGEST`, `SESSION_PATH`,
-   `OUTPUT_FILE`, `SCHEMA_PATH`, `DIFF_RANGE`, `DIFF_FILES`, HEAD, and the supplied
-   acceptance context. Stop incomplete when any value differs from the packet.
-2. Map each changed behavior and acceptance claim to an executable test or check.
-3. Follow `testing-rules` to determine what the evidence proves across functional,
-   persistence, protocol, UI, and failure boundaries that matter to this diff.
-4. Inspect test doubles for contract fidelity rather than banning them by name. Flag a
-   double only when it bypasses the behavior under review or diverges from production
-   semantics.
-5. Detect missing error or state-transition coverage, ineffective assertions, hidden
-   skips, flaky assumptions, and tests that never reach the changed code.
-6. Calibrate severity to the escaped product risk and write
-   `ultra-review-findings-v2` following `SCHEMA_PATH`, including the exact
-   `packet_digest`.
-
-Use `axis: engineering_standards` and category `test-quality`. After valid output,
-return exactly:
-
-```text
-Wrote N findings (P0:X P1:X P2:X P3:X) to <filepath>
-```
-
-Do not modify tests or production code, call Ultra MCP write tools, change task state,
-or edit another worker's artifact.

package/agents/tdd-runner.md

@@ -1,38 +0,0 @@
----
-name: tdd-runner
-description: Run the repository's exact test or coverage command, isolate actionable failures, and return concise execution evidence without editing files.
-tools: Bash, Read, Grep, Glob
-model: opus
-maxTurns: 20
-skills:
-  - testing-rules
----
-
-# Test execution specialist
-
-Run tests and analyze their evidence. This assignment is read-only.
-
-## Workflow
-
-1. Resolve the requested scope, checkout, repository guidance, and canonical command
-   from package scripts, CI configuration, or framework files. Ask the parent to
-   resolve ambiguity when different commands prove different contracts.
-   For an Ultra delegation, validate the immutable Worker Packet and echo its exact
-   `packet_digest` in the assigned output.
-2. Run the exact command without weakening flags, skipping failures, or changing test
-   configuration. Capture exit code, duration, pass/fail/skip counts, and coverage only
-   when the runner reports it.
-3. For each failure, identify the first useful error, tight source or test location,
-   whether the failure reproduces, and the most likely boundary that is wrong. Separate
-   product defects, test defects, environment failures, and flaky or nondeterministic
-   evidence.
-4. Evaluate test doubles only when relevant to the failed or requested behavior. Flag
-   one only when it bypasses the contract under test or diverges materially from the
-   production boundary.
-5. Return a concise summary with the exact command, exit code, counts, actionable
-   failures, environment limitations, and residual coverage gaps. Do not paste the full
-   runner transcript unless the parent requests it.
-
-Do not edit tests or production code, call Ultra MCP write tools, change task state, or
-edit projections. Do not claim a green suite when the command did not complete
-successfully.

package/bin/orchestrator.js

@@ -1,383 +0,0 @@
-#!/usr/bin/env node
-
-/**
- * ubp-orchestrator — Phase 5.4 daemon CLI.
- *
- * Subcommands:
- *   execute-plan  resume the current plan through the first unfinished dependency wave.
- *   run     foreground daemon (debug / test).
- *   start   detached background daemon, writes .ultra/.runtime/orchestrator.pid.
- *   stop    reads pidfile, SIGTERM the process, deletes pidfile.
- *   status  prints pidfile + running session summary.
- *
- * Opt-in gate: `start` and `run` require settings.json
- * `orchestrator.auto_dispatch: true` — default off per PLAN Phase 5.4 AC.
- *
- * Dispatch requires both explicit opt-in and an explicit executable command.
- * A daemon may never reserve a session/worktree without a real worker process.
- */
-
-'use strict';
-
-const fs = require('node:fs');
-const path = require('node:path');
-const { spawn } = require('node:child_process');
-const { isSupportedRuntime } = require('../adapters/_shared/runtime-assets.cjs');
-const runtimePaths = require('../mcp-server/lib/runtime-paths.cjs');
-
-const REPO_ROOT = process.env.UBP_REPO_ROOT || process.cwd();
-const RUNTIME_PATHS = runtimePaths.pathsFor(REPO_ROOT);
-const PIDFILE = RUNTIME_PATHS.orchestratorPidPath;
-const LOGFILE = RUNTIME_PATHS.orchestratorLogPath;
-const SETTINGS_FILES = [
-  path.join(REPO_ROOT, 'settings.json'),
-  path.join(REPO_ROOT, '.claude', 'settings.json'),
-];
-
-function readSettings() {
-  for (const f of SETTINGS_FILES) {
-    if (fs.existsSync(f)) {
-      try { return JSON.parse(fs.readFileSync(f, 'utf8')) || {}; }
-      catch { /* fall through */ }
-    }
-  }
-  return {};
-}
-
-function optInAllowed(settings) {
-  return !!(settings && settings.orchestrator && settings.orchestrator.auto_dispatch === true);
-}
-
-function parseRuntimes() {
-  const raw = process.env.UBP_ORCH_RUNTIMES || 'claude,opencode,codex,kimi,grok';
-  const runtimes = [...new Set(raw.split(',').map((s) => s.trim()).filter(Boolean))];
-  const invalid = runtimes.filter((runtime) => !isSupportedRuntime(runtime));
-  if (invalid.length > 0) {
-    throw new Error(`unsupported orchestrator runtime(s): ${invalid.join(', ')}`);
-  }
-  return runtimes;
-}
-
-function commandConfigError(code, message) {
-  const error = new Error(message);
-  error.code = code;
-  return error;
-}
-
-function resolveDispatchCommand(settings, env = process.env) {
-  const configured = settings?.orchestrator || {};
-  const fromEnvironment = typeof env.UBP_ORCH_COMMAND === 'string'
-    && env.UBP_ORCH_COMMAND.trim() !== '';
-  const command = fromEnvironment
-    ? env.UBP_ORCH_COMMAND.trim()
-    : (typeof configured.command === 'string' ? configured.command.trim() : '');
-  if (!command) {
-    throw commandConfigError(
-      'ORCHESTRATOR_COMMAND_REQUIRED',
-      'orchestrator dispatch requires orchestrator.command or UBP_ORCH_COMMAND',
-    );
-  }
-  if (/\s/.test(command) && !fs.existsSync(command)) {
-    throw commandConfigError(
-      'ORCHESTRATOR_COMMAND_INVALID',
-      'orchestrator.command must contain only the executable; put arguments in command_args',
-    );
-  }
-
-  let commandArgs;
-  if (fromEnvironment && env.UBP_ORCH_ARGS_JSON !== undefined) {
-    try {
-      commandArgs = JSON.parse(env.UBP_ORCH_ARGS_JSON);
-    } catch (error) {
-      throw commandConfigError(
-        'ORCHESTRATOR_COMMAND_INVALID',
-        `UBP_ORCH_ARGS_JSON must be a JSON array: ${error.message}`,
-      );
-    }
-  } else {
-    commandArgs = configured.command_args === undefined ? [] : configured.command_args;
-  }
-  if (!Array.isArray(commandArgs) || commandArgs.some((arg) => typeof arg !== 'string')) {
-    throw commandConfigError(
-      'ORCHESTRATOR_COMMAND_INVALID',
-      'orchestrator command arguments must be an array of strings',
-    );
-  }
-  return {
-    command,
-    commandArgs: commandArgs.slice(),
-    source: fromEnvironment ? 'environment' : 'settings',
-  };
-}
-
-function parseExecutePlanArgs(argv = []) {
-  const options = {
-    changeId: null,
-    autoMerge: false,
-    mergeBaseBranch: 'main',
-  };
-  for (let index = 0; index < argv.length; index += 1) {
-    const arg = argv[index];
-    if (arg === '--auto-merge') {
-      options.autoMerge = true;
-      continue;
-    }
-    if (arg === '--change' || arg === '--base-branch') {
-      const value = argv[index + 1];
-      if (!value || value.startsWith('--')) {
-        throw commandConfigError(
-          'ORCHESTRATOR_ARGUMENT_INVALID',
-          `${arg} requires a value`,
-        );
-      }
-      if (arg === '--change') options.changeId = value;
-      else options.mergeBaseBranch = value;
-      index += 1;
-      continue;
-    }
-    throw commandConfigError(
-      'ORCHESTRATOR_ARGUMENT_INVALID',
-      `unknown execute-plan option: ${arg}`,
-    );
-  }
-  return options;
-}
-
-function validateOrchestratorRuntime(rootDir = REPO_ROOT, {
-  forMutation = false,
-} = {}) {
-  return runtimePaths.validateProjectLayout(rootDir, {
-    env: {},
-    forMutation,
-    validateRuntimeTree: true,
-  });
-}
-
-function openNoFollow(file, flags) {
-  const noFollow = fs.constants.O_NOFOLLOW || 0;
-  return fs.openSync(file, flags | noFollow, 0o600);
-}
-
-async function cmdExecutePlan(argv = []) {
-  const settings = readSettings();
-  const dispatch = resolveDispatchCommand(settings);
-  const options = parseExecutePlanArgs(argv);
-  const { initStateDb, closeStateDb } = require('../mcp-server/lib/state-db.cjs');
-  const parallelOrchestrator = require('../orchestrator/parallel-orchestrator.cjs');
-  const { db } = initStateDb(runtimePaths.ensureRuntimeState(REPO_ROOT).stateDbPath);
-  try {
-    const result = await parallelOrchestrator.runPlan({
-      db,
-      repoRoot: REPO_ROOT,
-      changeId: options.changeId,
-      runtimes: parseRuntimes(),
-      command: dispatch.command,
-      commandArgs: dispatch.commandArgs,
-      autoMerge: options.autoMerge,
-      mergeBaseBranch: options.mergeBaseBranch,
-      onError: (error) => process.stderr.write(`orchestrator error: ${error.message}\n`),
-    });
-    process.stdout.write(`${JSON.stringify({
-      ok: true,
-      data: {
-        ...result,
-        auto_merge: options.autoMerge,
-        merge_base_branch: options.mergeBaseBranch,
-      },
-    })}\n`);
-    return result;
-  } finally {
-    closeStateDb(db);
-  }
-}
-
-function cmdRun(opts = {}) {
-  const settings = readSettings();
-  if (!opts.skipOptIn && !optInAllowed(settings)) {
-    process.stderr.write(
-      'orchestrator.auto_dispatch is not enabled in settings.json.\n' +
-      'Set {"orchestrator":{"auto_dispatch":true}} to opt in.\n',
-    );
-    process.exit(2);
-  }
-  const { initStateDb } = require('../mcp-server/lib/state-db.cjs');
-  const { runDaemon } = require('../orchestrator/daemon.cjs');
-  const runtimes = parseRuntimes();
-  const dispatch = resolveDispatchCommand(settings);
-  const { db } = initStateDb(runtimePaths.ensureRuntimeState(REPO_ROOT).stateDbPath);
-  const handle = runDaemon({
-    db,
-    repoRoot: REPO_ROOT,
-    runtimes,
-    command: dispatch.command,
-    commandArgs: dispatch.commandArgs,
-    pollMs: Number(process.env.UBP_ORCH_POLL_MS || 1000),
-    onError: (err) => process.stderr.write(`orchestrator error: ${err.message}\n`),
-  });
-
-  const shutdown = (signal) => {
-    process.stderr.write(`orchestrator received ${signal}, stopping\n`);
-    handle.stop();
-    try { db.close(); } catch (_) { /* ignore */ }
-    process.exit(0);
-  };
-  process.on('SIGTERM', () => shutdown('SIGTERM'));
-  process.on('SIGINT', () => shutdown('SIGINT'));
-  process.stderr.write(
-    `orchestrator running (pollMs=${Number(process.env.UBP_ORCH_POLL_MS || 1000)}, ` +
-    `runtimes=${runtimes.join(',')}, worker=${dispatch.command}, source=${dispatch.source})\n`,
-  );
-  // Keep process alive while the setInterval is unref'd.
-  setInterval(() => {}, 60000);
-}
-
-function cmdStart() {
-  const settings = readSettings();
-  if (!optInAllowed(settings)) {
-    process.stderr.write('orchestrator.auto_dispatch is not enabled; refusing to start.\n');
-    process.exit(2);
-  }
-  resolveDispatchCommand(settings);
-  const layout = validateOrchestratorRuntime(REPO_ROOT, { forMutation: true });
-  const pidfile = layout.orchestratorPidPath;
-  const logfile = layout.orchestratorLogPath;
-  if (fs.existsSync(pidfile)) {
-    const existing = Number(fs.readFileSync(pidfile, 'utf8'));
-    try { process.kill(existing, 0); }
-    catch (_) { fs.unlinkSync(pidfile); }
-    if (fs.existsSync(pidfile)) {
-      process.stderr.write(`orchestrator already running (pid=${existing}).\n`);
-      process.exit(1);
-    }
-  }
-  fs.mkdirSync(layout.orchestratorDir, { recursive: true });
-  const appendFlags = fs.constants.O_APPEND | fs.constants.O_CREAT | fs.constants.O_WRONLY;
-  const out = openNoFollow(logfile, appendFlags);
-  const err = openNoFollow(logfile, appendFlags);
-  const child = spawn(process.execPath, [__filename, 'run'], {
-    detached: true,
-    stdio: ['ignore', out, err],
-    env: { ...process.env, UBP_REPO_ROOT: REPO_ROOT },
-  });
-  child.unref();
-  const pidFd = openNoFollow(
-    pidfile,
-    fs.constants.O_CREAT | fs.constants.O_TRUNC | fs.constants.O_WRONLY,
-  );
-  try { fs.writeFileSync(pidFd, String(child.pid)); }
-  finally { fs.closeSync(pidFd); }
-  process.stdout.write(`orchestrator started (pid=${child.pid}, log=${logfile})\n`);
-}
-
-function cmdStop() {
-  const { orchestratorPidPath: pidfile } = validateOrchestratorRuntime(REPO_ROOT, {
-    forMutation: true,
-  });
-  if (!fs.existsSync(pidfile)) {
-    process.stderr.write('no pidfile found; orchestrator not running.\n');
-    process.exit(1);
-  }
-  const pid = Number(fs.readFileSync(pidfile, 'utf8'));
-  try { process.kill(pid, 'SIGTERM'); }
-  catch (err) {
-    if (err.code === 'ESRCH') {
-      process.stderr.write(`pid ${pid} already dead; cleaning pidfile.\n`);
-      fs.unlinkSync(pidfile);
-      return;
-    }
-    throw err;
-  }
-  // Wait briefly for the process to exit, then clean up.
-  setTimeout(() => {
-    try { process.kill(pid, 0); }
-    catch (_) { /* dead; good */ }
-    if (fs.existsSync(pidfile)) fs.unlinkSync(pidfile);
-    process.stdout.write(`orchestrator stopped (pid=${pid})\n`);
-  }, 200);
-}
-
-function cmdStatus() {
-  const { orchestratorPidPath: pidfile } = validateOrchestratorRuntime(REPO_ROOT);
-  const out = { pidfile, running: false };
-  if (fs.existsSync(pidfile)) {
-    const pid = Number(fs.readFileSync(pidfile, 'utf8'));
-    try { process.kill(pid, 0); out.pid = pid; out.running = true; }
-    catch (_) { out.pid = pid; out.running = false; out.note = 'pidfile stale'; }
-  }
-  // Session summary.
-  try {
-    const Database = require('better-sqlite3');
-    const dbPath = runtimePaths.locateStateDb(REPO_ROOT);
-    if (fs.existsSync(dbPath)) {
-      const db = new Database(dbPath, { readonly: true });
-      const counts = db.prepare(
-        "SELECT status, COUNT(*) AS n FROM sessions GROUP BY status",
-      ).all();
-      out.sessions = {};
-      for (const r of counts) out.sessions[r.status] = r.n;
-      db.close();
-    }
-  } catch (err) {
-    out.session_error = err.message;
-  }
-  process.stdout.write(`${JSON.stringify(out, null, 2)}\n`);
-}
-
-function usage() {
-  process.stderr.write(
-    'usage: ubp-orchestrator <execute-plan|run|start|stop|status>\n' +
-    '\n' +
-    '  execute-plan  resume an accepted Change Plan [--change <id>] [--auto-merge] [--base-branch <name>]\n' +
-    '  run     foreground daemon (requires opt-in)\n' +
-    '  start   detached background daemon (requires opt-in)\n' +
-    '  stop    terminate running daemon\n' +
-    '  status  print pid + session counts\n',
-  );
-}
-
-async function main(argv = process.argv.slice(2)) {
-  const subcommand = argv[0];
-  try {
-    switch (subcommand) {
-      case 'execute-plan': await cmdExecutePlan(argv.slice(1)); break;
-      case 'run':    cmdRun();        break;
-      case 'start':  cmdStart();      break;
-      case 'stop':   cmdStop();       break;
-      case 'status': cmdStatus();     break;
-      case '-h':
-      case '--help':
-      case 'help':
-        usage(); process.exit(0);
-        break;
-      default:
-        usage(); process.exit(1);
-    }
-  } catch (error) {
-    process.stderr.write(
-      `orchestrator configuration error${error.code ? ` [${error.code}]` : ''}: ${error.message}\n`,
-    );
-    process.exit(2);
-  }
-}
-
-if (require.main === module) {
-  main().catch((error) => {
-    process.stderr.write(`orchestrator fatal error: ${error.message}\n`);
-    process.exit(2);
-  });
-}
-
-module.exports = {
-  readSettings,
-  optInAllowed,
-  parseRuntimes,
-  parseExecutePlanArgs,
-  resolveDispatchCommand,
-  validateOrchestratorRuntime,
-  cmdExecutePlan,
-  cmdRun,
-  cmdStart,
-  cmdStop,
-  cmdStatus,
-  main,
-};

package/commands/ultra-change.md

@@ -1,10 +0,0 @@
----
-description: Capture or revise one bounded Change Contract without starting downstream workflows
-argument-hint: "[change-id-or-title] [quick|standard|major|incident]"
-workflow-ref: "@skills/ultra-change/SKILL.md"
----
-
-# Open or resume a change
-
-Read and follow `@skills/ultra-change/SKILL.md`, using `$ARGUMENTS` to identify and classify the change.
-Treat the referenced skill as the only workflow definition.

package/commands/ultra-deliver.md

@@ -1,10 +0,0 @@
----
-description: Converge current evidence and archive local Ultra authority without external release effects
-argument-hint: "[change-id]"
-workflow-ref: "@skills/ultra-deliver/SKILL.md"
----
-
-# Converge and deliver
-
-Read and follow `@skills/ultra-deliver/SKILL.md`, using `$ARGUMENTS` only to select the change.
-Treat the referenced skill as the only workflow definition.

package/commands/ultra-dev.md

@@ -1,10 +0,0 @@
----
-description: Execute one authoritative Ultra task through implementation, verification, and review
-argument-hint: "[task-id]"
-workflow-ref: "@skills/ultra-dev/SKILL.md"
----
-
-# Execute one Ultra task
-
-Read and follow `@skills/ultra-dev/SKILL.md`, using `$ARGUMENTS` as the optional task id.
-Treat the referenced skill as the only workflow definition.

package/commands/ultra-doctor.md

@@ -1,10 +0,0 @@
----
-description: Diagnose Ultra state and installed-plugin health with optional explicit repair
-argument-hint: "[--repair]"
-workflow-ref: "@skills/ultra-doctor/SKILL.md"
----
-
-# Diagnose Ultra health
-
-Read and follow `@skills/ultra-doctor/SKILL.md`; allow repair only when `$ARGUMENTS` explicitly contains `--repair`.
-Treat the referenced skill as the only workflow definition.

package/commands/ultra-init.md

@@ -1,10 +0,0 @@
----
-description: Create or recover Ultra project authority without implicitly starting research
-argument-hint: "[name] [type] [stack] [auto|greenfield|brownfield] [--scope <path>]"
-workflow-ref: "@skills/ultra-init/SKILL.md"
----
-
-# Initialize or adopt an Ultra project
-
-Read and follow `@skills/ultra-init/SKILL.md`, using `$ARGUMENTS` as optional project metadata.
-Treat the referenced skill as the only workflow definition.

package/commands/ultra-plan.md

@@ -1,10 +0,0 @@
----
-description: Persist dependency-valid vertical task contracts from an accepted Change Contract
-argument-hint: "[scope]"
-workflow-ref: "@skills/ultra-plan/SKILL.md"
----
-
-# Plan executable slices
-
-Read and follow `@skills/ultra-plan/SKILL.md`, using `$ARGUMENTS` to select the requested scope.
-Treat the referenced skill as the only workflow definition.

package/commands/ultra-research.md

@@ -1,10 +0,0 @@
----
-description: Build evidence with recommended, owner-selected semantic coverage and adaptive alignment
-argument-hint: "[scope-or-question]"
-workflow-ref: "@skills/ultra-research/SKILL.md"
----
-
-# Research one bounded question or baseline
-
-Read and follow `@skills/ultra-research/SKILL.md`, using `$ARGUMENTS` to bound the research scope.
-Treat the referenced skill as the only workflow definition.

package/commands/ultra-review.md

@@ -1,10 +0,0 @@
----
-description: Review one plan, task diff, or aggregate change on independent specification and engineering axes
-argument-hint: "[plan|task|change] [id]"
-workflow-ref: "@skills/ultra-review/SKILL.md"
----
-
-# Review one bounded Ultra scope
-
-Read and follow `@skills/ultra-review/SKILL.md`, using `$ARGUMENTS` to select the review mode and authority.
-Treat the referenced skill as the only workflow definition.