Q00/ouroboros

ouroboros-help

Full reference guide for Ouroboros commands and agents

idk

Calibrate interview explanations from the user's stated understanding

interview

Use when the user wants to build or change something but the request is vague or open-ended: 'help me figure out what to build', 'I'm not sure what it should do', 'add X' with no details, or no clear definition of done. Runs a short Socratic interview that…

setup

Guided onboarding wizard for Ouroboros setup

threat-model

Build a threat model for a target codebase. Three modes: "interview" walks an application owner through the four-question framework and produces a threat model from their answers; "bootstrap" derives a threat model from the code plus past vulnerabilities…

triage

Triage a batch of raw security findings. Verify each is real, collapse duplicates, re-rank by derived exploitability, and tag with an owner. Takes a directory or file of scanner output and writes TRIAGE.json + TRIAGE.md sorted by what actually needs…

vuln-scan

Static source-code vulnerability scan. Reads a target directory (and THREAT_MODEL.md if present), spawns parallel review subagents per focus area, and writes VULN-FINDINGS.json + .md for /triage to consume. Read-only — no building, running, or network. For…

update

Check for updates and upgrade Ouroboros to the latest version

brownfield

Scan and manage brownfield repository/worktree defaults for interviews

evaluate

Use when the user wants proof that finished work meets its acceptance criteria, not just that tests pass: 'verify it is actually done', 'check it against the spec', 'evaluate the run'. Runs mechanical checks, a semantic review per criterion, and multi-model…

qa

General-purpose QA verdict for any artifact type

seed

Use when goal, constraints, and success criteria are already settled and the user wants them frozen into a formal spec an agent can execute and verify: 'turn this into a spec', 'write it up as a Seed', or right after an interview. Returns an immutable Seed…

cancel

Cancel stuck or orphaned executions

auto

Use when the work spans several files or replaces a framework, language, auth, storage, or API layer (rewrites and migrations included), and the user wants it to end up working and tested. Asks only what is missing, writes a spec with acceptance criteria,…

ralph

MCP-owned Ralph loop around background evolve_step jobs

ouroboros-run

Use when an Ouroboros Seed (a spec file with a goal and acceptance criteria, such as *.seed.yaml) already exists and the user wants it executed: 'run the seed', 'execute this spec', 'ooo run'. Executes it and verifies every acceptance criterion. Not for raw…

ouroboros-config

Open or drive the Ouroboros settings GUI (browser, TUI, or conversational fallback)

publish

Publish Seed specification as GitHub Issues for team-based project management

resume-session

List in-flight Ouroboros sessions and show the commands needed to re-attach after MCP disconnect

ouroboros-status

Check session status and measure goal drift

evolve

Start or monitor an evolutionary development loop

unstuck

Use when the user is stuck or going in circles: the same fix failed twice or more, 'nothing works', 'I've tried everything', or a consequential choice with no clear winner that is hard to undo or splits the team (which database, which architecture). Brings…

pm

Use when the user wants product requirements rather than code: 'write a PRD', 'product requirements', 'spec this feature for the team', 'ooo pm'. Runs a PM-focused interview with automatic question classification and produces a PRD/PM document. Not for…

tutorial

Interactive tutorial teaching Ouroboros hands-on

welcome

First-touch experience for new Ouroboros users

ooo

Start Ouroboros onboarding. Use when the user sends bare `ooo`, asks to start Ouroboros, or is using Ouroboros for the first time.