Q00/ouroboros

Brownfield scans a root directory for existing git repositories and linked worktrees, then manages default repos used as context in interviews. Use it to set, clear, or inspect default repositories for brownfield interview sessions.

Brownfield scans a root directory for existing Git repositories and linked worktrees, then manages default repositories used as context in interviews. Use it before an interview to set or clear the repos that will be available.

Cancel stops stuck or orphaned executions by session ID, cancels all running sessions, or interactively picks from active executions. Use it when an execution needs to be aborted.

Cancel Executions cancels stuck or orphaned Ouroboros executions by session ID, cancels all running sessions, or interactively picks from active executions. Use it when a session is stuck or needs to be stopped.

Evaluate runs a three-stage verification pipeline—mechanical checks, semantic assessment, and optional multi-model consensus—on an execution session or artifact, allowing rejected outcomes to continue through a Ralph convergence chain.

Evolve starts or monitors an evolutionary development loop that iteratively refines ontology and acceptance criteria across generations until convergence. Use it to evolve a coding task through generation, execution, judgment, and gating with the Ouroboros MCP tools.

Ouroboros Auto runs a full-quality automated pipeline that converges a task description into an A-grade Seed and executes it. Use it to start a bounded interview, generation, review, and repair flow that only executes after A-grade.

Ouroboros Auto automatically converges from a goal to an A-grade Seed and executes it. Run it when you want a single task description to go through Socratic interviews, Seed generation, review/repair, and execution without manual intervention.

Ouroboros Config opens or drives the Ouroboros settings interface (browser, TUI, or conversational fallback) so an agent can change per-stage runtime and model selections, global runtime, LLM backend, and install badges for missing CLIs. Use it when the user asks to configure Ouroboros, change models or agents, or fix missing dependencies.

Ouroboros Help is a full reference guide for Ouroboros commands and agents, covering usage, natural language triggers, and setup. Use it to look up commands, skills, agents, and installation instructions for the Ouroboros requirement crystallization engine.

Ouroboros Onboarding starts Ouroboros when the user sends bare 'ooo' or asks to start Ouroboros, reading the welcome skill and following its instructions.

Ouroboros Run executes a Seed specification through the Ouroboros workflow engine, validating goals and constraints before running the orchestrator with progress tracking and convergence evaluation. Use it to run agent workflows defined as Seed YAML files or inline content.

Ouroboros Setup guides users through a six-step onboarding wizard to install and configure the Ouroboros agent development environment. It detects Python, configures the selected runtime backend, and writes the necessary config files for standalone or Copilot CLI use.

Ouroboros Status queries an Ouroboros session's state and measures how far execution has drifted from the original seed goal. Use it when an agent or user wants to check session progress or detect goal drift.

Ouroboros Tutorial walks users through an interactive, learn-by-doing experience that teaches Ouroboros's interview-to-seed workflow. Use it when someone wants to understand how Ouroboros exposes hidden assumptions, generates specifications, and prepares ideas for AI execution.

Ouroboros Welcome guides new Ouroboros users through first-run onboarding, checking Python runtime and Codex configuration before marking the welcome as complete.

Product Manager Interview guides users through a Socratic interview to produce a Product Requirements Document (PRD). Use it when you need to create a PRD or PM document, triggered by commands like 'ooo pm' or 'prd'.

Publish Seed as Issues converts a Seed specification into structured GitHub Issues for team workflows. Use it to publish an Ouroboros seed to a target repository after running ooo seed or ooo pm.

Quality Assessment evaluates any artifact—code, documents, API responses, test output, or custom content—and returns a score with a PASS, REVISE, or FAIL verdict plus actionable suggestions. Use it when you need a fast single-pass quality gate before proceeding or iterating on work.

Ralph runs a background evolve_step loop owned by the Ouroboros MCP tool, continuing until QA passes, convergence, a terminal evolution action, cancellation, or max_generations. Use it for tasks that must keep evolving until they work.

Resume Session lists in-flight Ouroboros sessions directly from the EventStore and shows commands to re-attach after an MCP disconnect. Use it when an Ouroboros execution is lost or interrupted and you need to inspect or resume it.

Seed generates validated Seed specifications from interview results. Use it to crystallize interview sessions into a YAML seed with ambiguity scoring and QA.

Socratic Interview crystallizes vague requirements into clear specifications through a structured Q&A process. Use it when an agent needs to clarify ambiguous project goals before generating code or plans.

Unstuck breaks through stagnation with lateral thinking personas. It supports solo reframing or multi-persona debate as parallel sub-agents, and is used when a user is stuck or needs a problem approached from multiple perspectives.

Update Ouroboros checks for available updates and upgrades Ouroboros without changing the installation's manager, environment, or optional-dependency profile.