/ouroboros:ouroboros-help
Full reference guide for Ouroboros power users.
Usage
ooo help
/ouroboros:ouroboros-help
What Is Ouroboros?
Ouroboros is a requirement crystallization engine for AI workflows. It transforms vague ideas into validated specifications through:
- Socratic Interview - Exposes hidden assumptions
- Seed Generation - Creates immutable specifications
- PAL Routing - Auto-escalates/descends model complexity
- Lateral Thinking - 5 personas to break stagnation
- 3-Stage Evaluation - Mechanical > Semantic > Consensus
All Commands
Core Commands
| Command |
Purpose |
Mode |
ooo |
Welcome + quick start |
Plugin |
ooo interview |
Socratic requirement clarification |
Plugin |
ooo seed |
Generate validated seed spec |
Plugin |
ooo run |
Execute seed workflow |
MCP |
ooo evaluate |
3-stage verification |
MCP |
ooo unstuck |
5 lateral thinking personas |
Plugin |
ooo status |
Session status + drift check |
MCP |
ooo resume-session |
List in-flight sessions and re-attach commands |
CLI |
ooo setup |
Installation wizard |
Plugin |
ooo config |
Settings GUI — per-stage agents & models (browser here, TUI in a terminal) |
CLI |
ooo welcome |
First-touch welcome guide |
Plugin |
ooo tutorial |
Interactive hands-on learning |
Plugin |
ooo help |
This reference guide |
Plugin |
ooo pm |
PM-focused interview + PRD generation |
MCP |
ooo qa |
General-purpose QA verdict for any artifact |
Plugin |
ooo cancel |
Cancel stuck or orphaned executions |
CLI |
ooo update |
Check for updates + upgrade to latest |
Plugin |
ooo brownfield |
Scan and manage brownfield repo defaults |
MCP |
ooo publish |
Publish Seed as GitHub Issues for teams |
Plugin |
Evolutionary Loop
| Command |
Purpose |
Mode |
ooo evolve |
Start/monitor evolutionary development loop |
MCP |
ooo ralph |
Client-driven loop until verified (uses background evolve_step jobs) |
Plugin + MCP |
Plugin = Works immediately after ooo setup.
MCP = Requires ooo setup (Python >= 3.12 auto-detected). Run setup once to unlock all features.
Natural Language Triggers
| Phrase |
Triggers |
| "interview me", "clarify requirements", "socratic interview" |
ooo interview |
| "crystallize", "generate seed", "create seed", "freeze requirements" |
ooo seed |
| "ouroboros run", "execute seed", "run seed", "run workflow" |
ooo run |
| "evaluate this", "3-stage check", "verify execution" |
ooo evaluate |
| "think sideways", "i'm stuck", "break through", "lateral thinking" |
ooo unstuck |
| "am I drifting?", "drift check", "session status" |
ooo status |
Utility Triggers
| Phrase |
Triggers |
| "write prd", "pm interview", "product requirements", "create prd" |
ooo pm |
| "qa check", "quality check" |
ooo qa |
| "cancel execution", "stop job", "kill stuck", "abort execution" |
ooo cancel |
| "in-flight sessions", "mcp disconnected", "lost Ouroboros execution" |
ooo resume-session |
| "update ouroboros", "upgrade ouroboros" |
ooo update |
| "open settings", "change model", "change agent", "configure backend" |
ooo config |
| "brownfield defaults", "brownfield scan" |
ooo brownfield |
| "publish to github", "create issues from seed", "seed to issues" |
ooo publish |
Loop Triggers
| Phrase |
Triggers |
| "ralph", "don't stop", "must complete", "until it works", "keep going" |
ooo ralph |
| "evolve", "evolutionary loop", "iterate until converged" |
ooo evolve |
Available Skills
Core Skills
| Skill |
Purpose |
Mode |
/ouroboros:welcome |
First-touch welcome experience |
Plugin |
/ouroboros:interview |
Socratic requirement clarification |
Plugin |
/ouroboros:seed |
Generate validated seed spec |
Plugin |
/ouroboros:ouroboros-run |
Execute seed workflow |
MCP |
/ouroboros:evaluate |
3-stage verification |
MCP |
/ouroboros:unstuck |
5 lateral thinking personas |
Plugin |
/ouroboros:ouroboros-status |
Session status + drift check |
MCP |
/ouroboros:resume-session |
List in-flight sessions and re-attach commands |
CLI |
/ouroboros:setup |
Installation wizard |
Plugin |
/ouroboros:tutorial |
Interactive hands-on learning |
Plugin |
/ouroboros:ouroboros-config |
Settings GUI |
Plugin |
/ouroboros:ouroboros-help |
This guide |
Plugin |
/ouroboros:pm |
PM-focused interview + PRD generation |
MCP |
/ouroboros:qa |
General-purpose QA verdict for any artifact |
Plugin |
/ouroboros:cancel |
Cancel stuck or orphaned executions |
CLI |
/ouroboros:update |
Check for updates + upgrade to latest |
Plugin |
/ouroboros:brownfield |
Scan and manage brownfield repo defaults |
MCP |
/ouroboros:publish |
Publish Seed as GitHub Issues for teams |
Plugin |
Loop Skills
| Skill |
Purpose |
Best For |
/ouroboros:ralph |
Client-driven loop over background evolve_step jobs |
"Don't stop", must complete |
/ouroboros:evolve |
Evolutionary ontology refinement |
Spec iteration until convergence |
Available Agents
| Agent |
Purpose |
ouroboros:socratic-interviewer |
Exposes hidden assumptions through questioning |
ouroboros:ontologist |
Finds root problems vs symptoms |
ouroboros:seed-architect |
Crystallizes requirements into seed specs |
ouroboros:evaluator |
Three-stage verification |
ouroboros:contrarian |
"Are we solving the wrong problem?" |
ouroboros:hacker |
"Make it work first, elegance later" |
ouroboros:simplifier |
"Cut scope to absolute minimum" |
ouroboros:researcher |
"Stop coding, start investigating" |
ouroboros:architect |
"Question the foundation, redesign if needed" |
Setup
After installing Ouroboros, run ooo setup once to register the MCP server.
This connects your runtime backend to the Ouroboros Python core and unlocks all features.
ooo setup # One-time setup (~1 minute)
RFC #1392 State Breadcrumb Footer
Your final response MUST end with exactly one breadcrumb footer line:
◆ <current state> → next: <recommended action>
Derive <current state> from live session state via ouroboros_session_status when that MCP projection is available; otherwise derive it from this skill's actual outcome. Never use a linear Step N of M footer because Ouroboros is an evolutionary loop. When the next action is genuinely a choice, list 2-3 honest options in the next: clause. The breadcrumb line must be the last line of the response.
1---
2name: ouroboros-help
3description: "Full reference guide for Ouroboros commands and agents"
4metadata:
5 source: https://skillmd.com/skills/q00/ouroboros-help
6---
7
8# /ouroboros:ouroboros-help
9
10Full reference guide for Ouroboros power users.
11
12## Usage
13
14```
15ooo help
16/ouroboros:ouroboros-help
17```
18
19## What Is Ouroboros?
20
21Ouroboros is a **requirement crystallization engine** for AI workflows. It transforms vague ideas into validated specifications through:
22
231. **Socratic Interview** - Exposes hidden assumptions
242. **Seed Generation** - Creates immutable specifications
253. **PAL Routing** - Auto-escalates/descends model complexity
264. **Lateral Thinking** - 5 personas to break stagnation
275. **3-Stage Evaluation** - Mechanical > Semantic > Consensus
28
29## All Commands
30
31### Core Commands
32
33| Command | Purpose | Mode |
34|---------|---------|------|
35| `ooo` | Welcome + quick start | Plugin |
36| `ooo interview` | Socratic requirement clarification | Plugin |
37| `ooo seed` | Generate validated seed spec | Plugin |
38| `ooo run` | Execute seed workflow | MCP |
39| `ooo evaluate` | 3-stage verification | MCP |
40| `ooo unstuck` | 5 lateral thinking personas | Plugin |
41| `ooo status` | Session status + drift check | MCP |
42| `ooo resume-session` | List in-flight sessions and re-attach commands | CLI |
43| `ooo setup` | Installation wizard | Plugin |
44| `ooo config` | Settings GUI — per-stage agents & models (browser here, TUI in a terminal) | CLI |
45| `ooo welcome` | First-touch welcome guide | Plugin |
46| `ooo tutorial` | Interactive hands-on learning | Plugin |
47| `ooo help` | This reference guide | Plugin |
48| `ooo pm` | PM-focused interview + PRD generation | MCP |
49| `ooo qa` | General-purpose QA verdict for any artifact | Plugin |
50| `ooo cancel` | Cancel stuck or orphaned executions | CLI |
51| `ooo update` | Check for updates + upgrade to latest | Plugin |
52| `ooo brownfield` | Scan and manage brownfield repo defaults | MCP |
53| `ooo publish` | Publish Seed as GitHub Issues for teams | Plugin |
54
55### Evolutionary Loop
56
57| Command | Purpose | Mode |
58|---------|---------|------|
59| `ooo evolve` | Start/monitor evolutionary development loop | MCP |
60| `ooo ralph` | Client-driven loop until verified (uses background evolve_step jobs) | Plugin + MCP |
61
62**Plugin** = Works immediately after `ooo setup`.
63**MCP** = Requires `ooo setup` (Python >= 3.12 auto-detected). Run setup once to unlock all features.
64
65## Natural Language Triggers
66
67| Phrase | Triggers |
68|--------|----------|
69| "interview me", "clarify requirements", "socratic interview" | `ooo interview` |
70| "crystallize", "generate seed", "create seed", "freeze requirements" | `ooo seed` |
71| "ouroboros run", "execute seed", "run seed", "run workflow" | `ooo run` |
72| "evaluate this", "3-stage check", "verify execution" | `ooo evaluate` |
73| "think sideways", "i'm stuck", "break through", "lateral thinking" | `ooo unstuck` |
74| "am I drifting?", "drift check", "session status" | `ooo status` |
75
76### Utility Triggers
77
78| Phrase | Triggers |
79|--------|----------|
80| "write prd", "pm interview", "product requirements", "create prd" | `ooo pm` |
81| "qa check", "quality check" | `ooo qa` |
82| "cancel execution", "stop job", "kill stuck", "abort execution" | `ooo cancel` |
83| "in-flight sessions", "mcp disconnected", "lost Ouroboros execution" | `ooo resume-session` |
84| "update ouroboros", "upgrade ouroboros" | `ooo update` |
85| "open settings", "change model", "change agent", "configure backend" | `ooo config` |
86| "brownfield defaults", "brownfield scan" | `ooo brownfield` |
87| "publish to github", "create issues from seed", "seed to issues" | `ooo publish` |
88
89### Loop Triggers
90
91| Phrase | Triggers |
92|--------|----------|
93| "ralph", "don't stop", "must complete", "until it works", "keep going" | `ooo ralph` |
94| "evolve", "evolutionary loop", "iterate until converged" | `ooo evolve` |
95
96## Available Skills
97
98### Core Skills
99
100| Skill | Purpose | Mode |
101|-------|---------|------|
102| `/ouroboros:welcome` | First-touch welcome experience | Plugin |
103| `/ouroboros:interview` | Socratic requirement clarification | Plugin |
104| `/ouroboros:seed` | Generate validated seed spec | Plugin |
105| `/ouroboros:ouroboros-run` | Execute seed workflow | MCP |
106| `/ouroboros:evaluate` | 3-stage verification | MCP |
107| `/ouroboros:unstuck` | 5 lateral thinking personas | Plugin |
108| `/ouroboros:ouroboros-status` | Session status + drift check | MCP |
109| `/ouroboros:resume-session` | List in-flight sessions and re-attach commands | CLI |
110| `/ouroboros:setup` | Installation wizard | Plugin |
111| `/ouroboros:tutorial` | Interactive hands-on learning | Plugin |
112| `/ouroboros:ouroboros-config` | Settings GUI | Plugin |
113| `/ouroboros:ouroboros-help` | This guide | Plugin |
114| `/ouroboros:pm` | PM-focused interview + PRD generation | MCP |
115| `/ouroboros:qa` | General-purpose QA verdict for any artifact | Plugin |
116| `/ouroboros:cancel` | Cancel stuck or orphaned executions | CLI |
117| `/ouroboros:update` | Check for updates + upgrade to latest | Plugin |
118| `/ouroboros:brownfield` | Scan and manage brownfield repo defaults | MCP |
119| `/ouroboros:publish` | Publish Seed as GitHub Issues for teams | Plugin |
120
121### Loop Skills
122
123| Skill | Purpose | Best For |
124|-------|---------|----------|
125| `/ouroboros:ralph` | Client-driven loop over background evolve_step jobs | "Don't stop", must complete |
126| `/ouroboros:evolve` | Evolutionary ontology refinement | Spec iteration until convergence |
127
128## Available Agents
129
130| Agent | Purpose |
131|-------|---------|
132| `ouroboros:socratic-interviewer` | Exposes hidden assumptions through questioning |
133| `ouroboros:ontologist` | Finds root problems vs symptoms |
134| `ouroboros:seed-architect` | Crystallizes requirements into seed specs |
135| `ouroboros:evaluator` | Three-stage verification |
136| `ouroboros:contrarian` | "Are we solving the wrong problem?" |
137| `ouroboros:hacker` | "Make it work first, elegance later" |
138| `ouroboros:simplifier` | "Cut scope to absolute minimum" |
139| `ouroboros:researcher` | "Stop coding, start investigating" |
140| `ouroboros:architect` | "Question the foundation, redesign if needed" |
141
142## Setup
143
144After installing Ouroboros, run `ooo setup` once to register the MCP server.
145This connects your runtime backend to the Ouroboros Python core and unlocks all features.
146
147```
148ooo setup # One-time setup (~1 minute)
149```
150
151## RFC #1392 State Breadcrumb Footer
152
153Your final response MUST end with exactly one breadcrumb footer line:
154
155```
156◆ <current state> → next: <recommended action>
157```
158
159Derive `<current state>` from live session state via `ouroboros_session_status` when that MCP projection is available; otherwise derive it from this skill's actual outcome. Never use a linear `Step N of M` footer because Ouroboros is an evolutionary loop. When the next action is genuinely a choice, list 2-3 honest options in the `next:` clause. The breadcrumb line must be the last line of the response.