{"owner":"Q00","repo":"ouroboros","hasSkills":true,"hasMcp":false,"mcpConfig":null,"found":["CLAUDE.md","AGENTS.md"],"skills":{"CLAUDE.md":"# Ouroboros - Development Environment\n\n> This CLAUDE.md is for **local development only**. End users install via:\n> ```\n> claude plugin marketplace add Q00/ouroboros\n> claude plugin install ouroboros@ouroboros\n> ```\n> Once installed as a plugin, skills/hooks/agents work natively without this file.\n\n## ooo Commands (Dev Mode)\n\nWhen the user types any of these commands, read the corresponding SKILL.md file and follow its instructions exactly:\n\n| Input | Action |\n|-------|--------|\n| `ooo` (bare, no subcommand) | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo auto ...` | Read `skills/auto/SKILL.md` and follow it |\n| `ooo interview ...` | Read `skills/interview/SKILL.md` and follow it |\n| `ooo seed` | Read `skills/seed/SKILL.md` and follow it |\n| `ooo run` | Read `skills/run/SKILL.md` and follow it |\n| `ooo evaluate` or `ooo eval` | Read `skills/evaluate/SKILL.md` and follow it |\n| `ooo evolve ...` | Read `skills/evolve/SKILL.md` and follow it |\n| `ooo unstuck` or `ooo stuck` or `ooo lateral` | Read `skills/unstuck/SKILL.md` and follow it |\n| `ooo status` or `ooo drift` | Read `skills/status/SKILL.md` and follow it |\n| `ooo ralph` | Read `skills/ralph/SKILL.md` and follow it |\n| `ooo tutorial` | Read `skills/tutorial/SKILL.md` and follow it |\n| `ooo setup` | Read `skills/setup/SKILL.md` and follow it |\n| `ooo welcome` | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo cancel` | Read `skills/cancel/SKILL.md` and follow it |\n| `ooo config` | Read `skills/config/SKILL.md` and follow it |\n| `ooo qa` or `ooo qa ...` | Read `skills/qa/SKILL.md` and follow it |\n| `ooo help` | Read `skills/help/SKILL.md` and follow it |\n| `ooo update` | Read `skills/update/SKILL.md` and follow it |\n| `ooo pm` or `ooo pm ...` | Read `skills/pm/SKILL.md` and follow it |\n| `ooo brownfield` or `ooo brownfield ...` | Read `skills/brownfield/SKILL.md` and follow it |\n| `ooo publish` or `ooo publish ...` | Read `skills/publish/SKILL.md` and follow it |\n| `ooo resume-session` | Read `skills/resume-session/SKILL.md` and follow it |\n\n**Important**: Do NOT use the Skill tool. Read the file with the Read tool and execute its instructions directly.\n\n## Agents\n\nBundled agents live in `src/ouroboros/agents/`. When a skill references an agent (e.g., `ouroboros:socratic-interviewer`), read its definition from `src/ouroboros/agents/{name}.md` and adopt that role. Use `OUROBOROS_AGENTS_DIR` or `.claude-plugin/agents/` only for explicit custom overrides.\n\n<!-- ooo:START -->\n<!-- ooo:VERSION:0.26.0 -->\n# Ouroboros — Specification-First AI Development\n\n> Before telling AI what to build, define what should be built.\n> As Socrates asked 2,500 years ago — \"What do you truly know?\"\n> Ouroboros turns that question into an evolutionary AI workflow engine.\n\nMost AI coding fails at the input, not the output. Ouroboros fixes this by\n**exposing hidden assumptions before any code is written**.\n\n1. **Socratic Clarity** — Question until ambiguity ≤ 0.2\n2. **Ontological Precision** — Solve the root problem, not symptoms\n3. **Evolutionary Loops** — Each evaluation cycle feeds back into better specs\n\n```\nInterview → Seed → Execute → Evaluate\n    ↑                           ↓\n    └─── Evolutionary Loop ─────┘\n```\n\n## ooo Commands\n\nEach command loads its agent/MCP on-demand. Details in each skill file.\n\n| Command | Loads |\n|---------|-------|\n| `ooo` | — |\n| `ooo auto` | MCP: `ouroboros_auto` |\n| `ooo interview` | `ouroboros:socratic-interviewer` |\n| `ooo seed` | `ouroboros:seed-architect` |\n| `ooo run` | MCP required |\n| `ooo evolve` | MCP: `evolve_step` |\n| `ooo evaluate` | `ouroboros:evaluator` |\n| `ooo qa` | `ouroboros:qa-judge` |\n| `ooo unstuck` | `ouroboros:{persona}` |\n| `ooo status` | MCP: `session_status` |\n| `ooo ralph` | Persistent loop until verified |\n| `ooo tutorial` | Interactive hands-on learning |\n| `ooo setup` | — |\n| `ooo help` | — |\n| `ooo update` | PyPI version check + upgrade |\n| `ooo publish` | `gh` CLI — Seed to GitHub Issues |\n| `ooo resume-session` | Restore previous Claude Code session context |\n\n## Agents\n\nLoaded on-demand — not preloaded.\n\n**Core**: socratic-interviewer, ontologist, seed-architect, evaluator, qa-judge, contrarian\n**Support**: hacker, simplifier, researcher, architect\n<!-- ooo:END -->\n","AGENTS.md":"# Ouroboros - Development Environment\n\n> This AGENTS.md is for **local development only**. End users install via:\n> ```\n> Codex plugin marketplace add Q00/ouroboros\n> Codex plugin add ouroboros@ouroboros\n> ```\n> Once installed as a plugin, skills/hooks/agents work natively without this file.\n\n## ooo Commands (Dev Mode)\n\nWhen the user types any of these commands, read the corresponding SKILL.md file and follow its instructions exactly:\n\n| Input | Action |\n|-------|--------|\n| `ooo` (bare, no subcommand) | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo auto ...` | Read `skills/auto/SKILL.md` and follow it |\n| `ooo interview ...` | Read `skills/interview/SKILL.md` and follow it |\n| `ooo seed` | Read `skills/seed/SKILL.md` and follow it |\n| `ooo run` | Read `skills/run/SKILL.md` and follow it |\n| `ooo evaluate` or `ooo eval` | Read `skills/evaluate/SKILL.md` and follow it |\n| `ooo evolve ...` | Read `skills/evolve/SKILL.md` and follow it |\n| `ooo unstuck` or `ooo stuck` or `ooo lateral` | Read `skills/unstuck/SKILL.md` and follow it |\n| `ooo status` or `ooo drift` | Read `skills/status/SKILL.md` and follow it |\n| `ooo ralph` | Read `skills/ralph/SKILL.md` and follow it |\n| `ooo tutorial` | Read `skills/tutorial/SKILL.md` and follow it |\n| `ooo setup` | Read `skills/setup/SKILL.md` and follow it |\n| `ooo welcome` | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo cancel` | Read `skills/cancel/SKILL.md` and follow it |\n| `ooo qa` or `ooo qa ...` | Read `skills/qa/SKILL.md` and follow it |\n| `ooo help` | Read `skills/help/SKILL.md` and follow it |\n| `ooo update` | Read `skills/update/SKILL.md` and follow it |\n| `ooo pm` or `ooo pm ...` | Read `skills/pm/SKILL.md` and follow it |\n| `ooo brownfield` or `ooo brownfield ...` | Read `skills/brownfield/SKILL.md` and follow it |\n| `ooo publish` or `ooo publish ...` | Read `skills/publish/SKILL.md` and follow it |\n| `ooo resume-session` | Read `skills/resume-session/SKILL.md` and follow it |\n\n**Important**: Do NOT use the Skill tool. Read the file with the Read tool and execute its instructions directly.\n\n## Agents\n\nBundled agents live in `src/ouroboros/agents/`. When a skill references an agent (e.g., `ouroboros:socratic-interviewer`), read its definition from `src/ouroboros/agents/{name}.md` and adopt that role. Use `OUROBOROS_AGENTS_DIR` or `.Codex-plugin/agents/` only for explicit custom overrides.\n\n<!-- ooo:START -->\n<!-- ooo:VERSION:0.26.0 -->\n# Ouroboros — Specification-First AI Development\n\n> Before telling AI what to build, define what should be built.\n> As Socrates asked 2,500 years ago — \"What do you truly know?\"\n> Ouroboros turns that question into an evolutionary AI workflow engine.\n\nMost AI coding fails at the input, not the output. Ouroboros fixes this by\n**exposing hidden assumptions before any code is written**.\n\n1. **Socratic Clarity** — Question until ambiguity ≤ 0.2\n2. **Ontological Precision** — Solve the root problem, not symptoms\n3. **Evolutionary Loops** — Each evaluation cycle feeds back into better specs\n\n```\nInterview → Seed → Execute → Evaluate\n    ↑                           ↓\n    └─── Evolutionary Loop ─────┘\n```\n\n## ooo Commands\n\nEach command loads its agent/MCP on-demand. Details in each skill file.\n\n| Command | Loads |\n|---------|-------|\n| `ooo` | — |\n| `ooo auto` | MCP: `ouroboros_start_auto` |\n| `ooo interview` | `ouroboros:socratic-interviewer` |\n| `ooo seed` | `ouroboros:seed-architect` |\n| `ooo run` | MCP required |\n| `ooo evolve` | MCP: `evolve_step` |\n| `ooo evaluate` | `ouroboros:evaluator` |\n| `ooo qa` | `ouroboros:qa-judge` |\n| `ooo unstuck` | `ouroboros:{persona}` |\n| `ooo status` | MCP: `session_status` |\n| `ooo ralph` | Persistent loop until verified |\n| `ooo tutorial` | Interactive hands-on learning |\n| `ooo setup` | — |\n| `ooo help` | — |\n| `ooo update` | PyPI version check + upgrade |\n| `ooo publish` | `gh` CLI — Seed to GitHub Issues |\n| `ooo resume-session` | Restore previous Codex session context |\n\n## Agents\n\nLoaded on-demand — not preloaded.\n\n**Core**: socratic-interviewer, ontologist, seed-architect, evaluator, qa-judge, contrarian\n**Support**: hacker, simplifier, researcher, architect\n<!-- ooo:END -->\n"},"files":{"CLAUDE.md":"# Ouroboros - Development Environment\n\n> This CLAUDE.md is for **local development only**. End users install via:\n> ```\n> claude plugin marketplace add Q00/ouroboros\n> claude plugin install ouroboros@ouroboros\n> ```\n> Once installed as a plugin, skills/hooks/agents work natively without this file.\n\n## ooo Commands (Dev Mode)\n\nWhen the user types any of these commands, read the corresponding SKILL.md file and follow its instructions exactly:\n\n| Input | Action |\n|-------|--------|\n| `ooo` (bare, no subcommand) | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo auto ...` | Read `skills/auto/SKILL.md` and follow it |\n| `ooo interview ...` | Read `skills/interview/SKILL.md` and follow it |\n| `ooo seed` | Read `skills/seed/SKILL.md` and follow it |\n| `ooo run` | Read `skills/run/SKILL.md` and follow it |\n| `ooo evaluate` or `ooo eval` | Read `skills/evaluate/SKILL.md` and follow it |\n| `ooo evolve ...` | Read `skills/evolve/SKILL.md` and follow it |\n| `ooo unstuck` or `ooo stuck` or `ooo lateral` | Read `skills/unstuck/SKILL.md` and follow it |\n| `ooo status` or `ooo drift` | Read `skills/status/SKILL.md` and follow it |\n| `ooo ralph` | Read `skills/ralph/SKILL.md` and follow it |\n| `ooo tutorial` | Read `skills/tutorial/SKILL.md` and follow it |\n| `ooo setup` | Read `skills/setup/SKILL.md` and follow it |\n| `ooo welcome` | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo cancel` | Read `skills/cancel/SKILL.md` and follow it |\n| `ooo config` | Read `skills/config/SKILL.md` and follow it |\n| `ooo qa` or `ooo qa ...` | Read `skills/qa/SKILL.md` and follow it |\n| `ooo help` | Read `skills/help/SKILL.md` and follow it |\n| `ooo update` | Read `skills/update/SKILL.md` and follow it |\n| `ooo pm` or `ooo pm ...` | Read `skills/pm/SKILL.md` and follow it |\n| `ooo brownfield` or `ooo brownfield ...` | Read `skills/brownfield/SKILL.md` and follow it |\n| `ooo publish` or `ooo publish ...` | Read `skills/publish/SKILL.md` and follow it |\n| `ooo resume-session` | Read `skills/resume-session/SKILL.md` and follow it |\n\n**Important**: Do NOT use the Skill tool. Read the file with the Read tool and execute its instructions directly.\n\n## Agents\n\nBundled agents live in `src/ouroboros/agents/`. When a skill references an agent (e.g., `ouroboros:socratic-interviewer`), read its definition from `src/ouroboros/agents/{name}.md` and adopt that role. Use `OUROBOROS_AGENTS_DIR` or `.claude-plugin/agents/` only for explicit custom overrides.\n\n<!-- ooo:START -->\n<!-- ooo:VERSION:0.26.0 -->\n# Ouroboros — Specification-First AI Development\n\n> Before telling AI what to build, define what should be built.\n> As Socrates asked 2,500 years ago — \"What do you truly know?\"\n> Ouroboros turns that question into an evolutionary AI workflow engine.\n\nMost AI coding fails at the input, not the output. Ouroboros fixes this by\n**exposing hidden assumptions before any code is written**.\n\n1. **Socratic Clarity** — Question until ambiguity ≤ 0.2\n2. **Ontological Precision** — Solve the root problem, not symptoms\n3. **Evolutionary Loops** — Each evaluation cycle feeds back into better specs\n\n```\nInterview → Seed → Execute → Evaluate\n    ↑                           ↓\n    └─── Evolutionary Loop ─────┘\n```\n\n## ooo Commands\n\nEach command loads its agent/MCP on-demand. Details in each skill file.\n\n| Command | Loads |\n|---------|-------|\n| `ooo` | — |\n| `ooo auto` | MCP: `ouroboros_auto` |\n| `ooo interview` | `ouroboros:socratic-interviewer` |\n| `ooo seed` | `ouroboros:seed-architect` |\n| `ooo run` | MCP required |\n| `ooo evolve` | MCP: `evolve_step` |\n| `ooo evaluate` | `ouroboros:evaluator` |\n| `ooo qa` | `ouroboros:qa-judge` |\n| `ooo unstuck` | `ouroboros:{persona}` |\n| `ooo status` | MCP: `session_status` |\n| `ooo ralph` | Persistent loop until verified |\n| `ooo tutorial` | Interactive hands-on learning |\n| `ooo setup` | — |\n| `ooo help` | — |\n| `ooo update` | PyPI version check + upgrade |\n| `ooo publish` | `gh` CLI — Seed to GitHub Issues |\n| `ooo resume-session` | Restore previous Claude Code session context |\n\n## Agents\n\nLoaded on-demand — not preloaded.\n\n**Core**: socratic-interviewer, ontologist, seed-architect, evaluator, qa-judge, contrarian\n**Support**: hacker, simplifier, researcher, architect\n<!-- ooo:END -->\n","AGENTS.md":"# Ouroboros - Development Environment\n\n> This AGENTS.md is for **local development only**. End users install via:\n> ```\n> Codex plugin marketplace add Q00/ouroboros\n> Codex plugin add ouroboros@ouroboros\n> ```\n> Once installed as a plugin, skills/hooks/agents work natively without this file.\n\n## ooo Commands (Dev Mode)\n\nWhen the user types any of these commands, read the corresponding SKILL.md file and follow its instructions exactly:\n\n| Input | Action |\n|-------|--------|\n| `ooo` (bare, no subcommand) | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo auto ...` | Read `skills/auto/SKILL.md` and follow it |\n| `ooo interview ...` | Read `skills/interview/SKILL.md` and follow it |\n| `ooo seed` | Read `skills/seed/SKILL.md` and follow it |\n| `ooo run` | Read `skills/run/SKILL.md` and follow it |\n| `ooo evaluate` or `ooo eval` | Read `skills/evaluate/SKILL.md` and follow it |\n| `ooo evolve ...` | Read `skills/evolve/SKILL.md` and follow it |\n| `ooo unstuck` or `ooo stuck` or `ooo lateral` | Read `skills/unstuck/SKILL.md` and follow it |\n| `ooo status` or `ooo drift` | Read `skills/status/SKILL.md` and follow it |\n| `ooo ralph` | Read `skills/ralph/SKILL.md` and follow it |\n| `ooo tutorial` | Read `skills/tutorial/SKILL.md` and follow it |\n| `ooo setup` | Read `skills/setup/SKILL.md` and follow it |\n| `ooo welcome` | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo cancel` | Read `skills/cancel/SKILL.md` and follow it |\n| `ooo qa` or `ooo qa ...` | Read `skills/qa/SKILL.md` and follow it |\n| `ooo help` | Read `skills/help/SKILL.md` and follow it |\n| `ooo update` | Read `skills/update/SKILL.md` and follow it |\n| `ooo pm` or `ooo pm ...` | Read `skills/pm/SKILL.md` and follow it |\n| `ooo brownfield` or `ooo brownfield ...` | Read `skills/brownfield/SKILL.md` and follow it |\n| `ooo publish` or `ooo publish ...` | Read `skills/publish/SKILL.md` and follow it |\n| `ooo resume-session` | Read `skills/resume-session/SKILL.md` and follow it |\n\n**Important**: Do NOT use the Skill tool. Read the file with the Read tool and execute its instructions directly.\n\n## Agents\n\nBundled agents live in `src/ouroboros/agents/`. When a skill references an agent (e.g., `ouroboros:socratic-interviewer`), read its definition from `src/ouroboros/agents/{name}.md` and adopt that role. Use `OUROBOROS_AGENTS_DIR` or `.Codex-plugin/agents/` only for explicit custom overrides.\n\n<!-- ooo:START -->\n<!-- ooo:VERSION:0.26.0 -->\n# Ouroboros — Specification-First AI Development\n\n> Before telling AI what to build, define what should be built.\n> As Socrates asked 2,500 years ago — \"What do you truly know?\"\n> Ouroboros turns that question into an evolutionary AI workflow engine.\n\nMost AI coding fails at the input, not the output. Ouroboros fixes this by\n**exposing hidden assumptions before any code is written**.\n\n1. **Socratic Clarity** — Question until ambiguity ≤ 0.2\n2. **Ontological Precision** — Solve the root problem, not symptoms\n3. **Evolutionary Loops** — Each evaluation cycle feeds back into better specs\n\n```\nInterview → Seed → Execute → Evaluate\n    ↑                           ↓\n    └─── Evolutionary Loop ─────┘\n```\n\n## ooo Commands\n\nEach command loads its agent/MCP on-demand. Details in each skill file.\n\n| Command | Loads |\n|---------|-------|\n| `ooo` | — |\n| `ooo auto` | MCP: `ouroboros_start_auto` |\n| `ooo interview` | `ouroboros:socratic-interviewer` |\n| `ooo seed` | `ouroboros:seed-architect` |\n| `ooo run` | MCP required |\n| `ooo evolve` | MCP: `evolve_step` |\n| `ooo evaluate` | `ouroboros:evaluator` |\n| `ooo qa` | `ouroboros:qa-judge` |\n| `ooo unstuck` | `ouroboros:{persona}` |\n| `ooo status` | MCP: `session_status` |\n| `ooo ralph` | Persistent loop until verified |\n| `ooo tutorial` | Interactive hands-on learning |\n| `ooo setup` | — |\n| `ooo help` | — |\n| `ooo update` | PyPI version check + upgrade |\n| `ooo publish` | `gh` CLI — Seed to GitHub Issues |\n| `ooo resume-session` | Restore previous Codex session context |\n\n## Agents\n\nLoaded on-demand — not preloaded.\n\n**Core**: socratic-interviewer, ontologist, seed-architect, evaluator, qa-judge, contrarian\n**Support**: hacker, simplifier, researcher, architect\n<!-- ooo:END -->\n"},"items":[{"name":"CLAUDE.md","path":"CLAUDE.md","title":"CLAUDE.md","content":"# Ouroboros - Development Environment\n\n> This CLAUDE.md is for **local development only**. End users install via:\n> ```\n> claude plugin marketplace add Q00/ouroboros\n> claude plugin install ouroboros@ouroboros\n> ```\n> Once installed as a plugin, skills/hooks/agents work natively without this file.\n\n## ooo Commands (Dev Mode)\n\nWhen the user types any of these commands, read the corresponding SKILL.md file and follow its instructions exactly:\n\n| Input | Action |\n|-------|--------|\n| `ooo` (bare, no subcommand) | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo auto ...` | Read `skills/auto/SKILL.md` and follow it |\n| `ooo interview ...` | Read `skills/interview/SKILL.md` and follow it |\n| `ooo seed` | Read `skills/seed/SKILL.md` and follow it |\n| `ooo run` | Read `skills/run/SKILL.md` and follow it |\n| `ooo evaluate` or `ooo eval` | Read `skills/evaluate/SKILL.md` and follow it |\n| `ooo evolve ...` | Read `skills/evolve/SKILL.md` and follow it |\n| `ooo unstuck` or `ooo stuck` or `ooo lateral` | Read `skills/unstuck/SKILL.md` and follow it |\n| `ooo status` or `ooo drift` | Read `skills/status/SKILL.md` and follow it |\n| `ooo ralph` | Read `skills/ralph/SKILL.md` and follow it |\n| `ooo tutorial` | Read `skills/tutorial/SKILL.md` and follow it |\n| `ooo setup` | Read `skills/setup/SKILL.md` and follow it |\n| `ooo welcome` | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo cancel` | Read `skills/cancel/SKILL.md` and follow it |\n| `ooo config` | Read `skills/config/SKILL.md` and follow it |\n| `ooo qa` or `ooo qa ...` | Read `skills/qa/SKILL.md` and follow it |\n| `ooo help` | Read `skills/help/SKILL.md` and follow it |\n| `ooo update` | Read `skills/update/SKILL.md` and follow it |\n| `ooo pm` or `ooo pm ...` | Read `skills/pm/SKILL.md` and follow it |\n| `ooo brownfield` or `ooo brownfield ...` | Read `skills/brownfield/SKILL.md` and follow it |\n| `ooo publish` or `ooo publish ...` | Read `skills/publish/SKILL.md` and follow it |\n| `ooo resume-session` | Read `skills/resume-session/SKILL.md` and follow it |\n\n**Important**: Do NOT use the Skill tool. Read the file with the Read tool and execute its instructions directly.\n\n## Agents\n\nBundled agents live in `src/ouroboros/agents/`. When a skill references an agent (e.g., `ouroboros:socratic-interviewer`), read its definition from `src/ouroboros/agents/{name}.md` and adopt that role. Use `OUROBOROS_AGENTS_DIR` or `.claude-plugin/agents/` only for explicit custom overrides.\n\n<!-- ooo:START -->\n<!-- ooo:VERSION:0.26.0 -->\n# Ouroboros — Specification-First AI Development\n\n> Before telling AI what to build, define what should be built.\n> As Socrates asked 2,500 years ago — \"What do you truly know?\"\n> Ouroboros turns that question into an evolutionary AI workflow engine.\n\nMost AI coding fails at the input, not the output. Ouroboros fixes this by\n**exposing hidden assumptions before any code is written**.\n\n1. **Socratic Clarity** — Question until ambiguity ≤ 0.2\n2. **Ontological Precision** — Solve the root problem, not symptoms\n3. **Evolutionary Loops** — Each evaluation cycle feeds back into better specs\n\n```\nInterview → Seed → Execute → Evaluate\n    ↑                           ↓\n    └─── Evolutionary Loop ─────┘\n```\n\n## ooo Commands\n\nEach command loads its agent/MCP on-demand. Details in each skill file.\n\n| Command | Loads |\n|---------|-------|\n| `ooo` | — |\n| `ooo auto` | MCP: `ouroboros_auto` |\n| `ooo interview` | `ouroboros:socratic-interviewer` |\n| `ooo seed` | `ouroboros:seed-architect` |\n| `ooo run` | MCP required |\n| `ooo evolve` | MCP: `evolve_step` |\n| `ooo evaluate` | `ouroboros:evaluator` |\n| `ooo qa` | `ouroboros:qa-judge` |\n| `ooo unstuck` | `ouroboros:{persona}` |\n| `ooo status` | MCP: `session_status` |\n| `ooo ralph` | Persistent loop until verified |\n| `ooo tutorial` | Interactive hands-on learning |\n| `ooo setup` | — |\n| `ooo help` | — |\n| `ooo update` | PyPI version check + upgrade |\n| `ooo publish` | `gh` CLI — Seed to GitHub Issues |\n| `ooo resume-session` | Restore previous Claude Code session context |\n\n## Agents\n\nLoaded on-demand — not preloaded.\n\n**Core**: socratic-interviewer, ontologist, seed-architect, evaluator, qa-judge, contrarian\n**Support**: hacker, simplifier, researcher, architect\n<!-- ooo:END -->\n","category":"root","tokens":1063},{"name":"AGENTS.md","path":"AGENTS.md","title":"AGENTS.md","content":"# Ouroboros - Development Environment\n\n> This AGENTS.md is for **local development only**. End users install via:\n> ```\n> Codex plugin marketplace add Q00/ouroboros\n> Codex plugin add ouroboros@ouroboros\n> ```\n> Once installed as a plugin, skills/hooks/agents work natively without this file.\n\n## ooo Commands (Dev Mode)\n\nWhen the user types any of these commands, read the corresponding SKILL.md file and follow its instructions exactly:\n\n| Input | Action |\n|-------|--------|\n| `ooo` (bare, no subcommand) | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo auto ...` | Read `skills/auto/SKILL.md` and follow it |\n| `ooo interview ...` | Read `skills/interview/SKILL.md` and follow it |\n| `ooo seed` | Read `skills/seed/SKILL.md` and follow it |\n| `ooo run` | Read `skills/run/SKILL.md` and follow it |\n| `ooo evaluate` or `ooo eval` | Read `skills/evaluate/SKILL.md` and follow it |\n| `ooo evolve ...` | Read `skills/evolve/SKILL.md` and follow it |\n| `ooo unstuck` or `ooo stuck` or `ooo lateral` | Read `skills/unstuck/SKILL.md` and follow it |\n| `ooo status` or `ooo drift` | Read `skills/status/SKILL.md` and follow it |\n| `ooo ralph` | Read `skills/ralph/SKILL.md` and follow it |\n| `ooo tutorial` | Read `skills/tutorial/SKILL.md` and follow it |\n| `ooo setup` | Read `skills/setup/SKILL.md` and follow it |\n| `ooo welcome` | Read `skills/welcome/SKILL.md` and follow it |\n| `ooo cancel` | Read `skills/cancel/SKILL.md` and follow it |\n| `ooo qa` or `ooo qa ...` | Read `skills/qa/SKILL.md` and follow it |\n| `ooo help` | Read `skills/help/SKILL.md` and follow it |\n| `ooo update` | Read `skills/update/SKILL.md` and follow it |\n| `ooo pm` or `ooo pm ...` | Read `skills/pm/SKILL.md` and follow it |\n| `ooo brownfield` or `ooo brownfield ...` | Read `skills/brownfield/SKILL.md` and follow it |\n| `ooo publish` or `ooo publish ...` | Read `skills/publish/SKILL.md` and follow it |\n| `ooo resume-session` | Read `skills/resume-session/SKILL.md` and follow it |\n\n**Important**: Do NOT use the Skill tool. Read the file with the Read tool and execute its instructions directly.\n\n## Agents\n\nBundled agents live in `src/ouroboros/agents/`. When a skill references an agent (e.g., `ouroboros:socratic-interviewer`), read its definition from `src/ouroboros/agents/{name}.md` and adopt that role. Use `OUROBOROS_AGENTS_DIR` or `.Codex-plugin/agents/` only for explicit custom overrides.\n\n<!-- ooo:START -->\n<!-- ooo:VERSION:0.26.0 -->\n# Ouroboros — Specification-First AI Development\n\n> Before telling AI what to build, define what should be built.\n> As Socrates asked 2,500 years ago — \"What do you truly know?\"\n> Ouroboros turns that question into an evolutionary AI workflow engine.\n\nMost AI coding fails at the input, not the output. Ouroboros fixes this by\n**exposing hidden assumptions before any code is written**.\n\n1. **Socratic Clarity** — Question until ambiguity ≤ 0.2\n2. **Ontological Precision** — Solve the root problem, not symptoms\n3. **Evolutionary Loops** — Each evaluation cycle feeds back into better specs\n\n```\nInterview → Seed → Execute → Evaluate\n    ↑                           ↓\n    └─── Evolutionary Loop ─────┘\n```\n\n## ooo Commands\n\nEach command loads its agent/MCP on-demand. Details in each skill file.\n\n| Command | Loads |\n|---------|-------|\n| `ooo` | — |\n| `ooo auto` | MCP: `ouroboros_start_auto` |\n| `ooo interview` | `ouroboros:socratic-interviewer` |\n| `ooo seed` | `ouroboros:seed-architect` |\n| `ooo run` | MCP required |\n| `ooo evolve` | MCP: `evolve_step` |\n| `ooo evaluate` | `ouroboros:evaluator` |\n| `ooo qa` | `ouroboros:qa-judge` |\n| `ooo unstuck` | `ouroboros:{persona}` |\n| `ooo status` | MCP: `session_status` |\n| `ooo ralph` | Persistent loop until verified |\n| `ooo tutorial` | Interactive hands-on learning |\n| `ooo setup` | — |\n| `ooo help` | — |\n| `ooo update` | PyPI version check + upgrade |\n| `ooo publish` | `gh` CLI — Seed to GitHub Issues |\n| `ooo resume-session` | Restore previous Codex session context |\n\n## Agents\n\nLoaded on-demand — not preloaded.\n\n**Core**: socratic-interviewer, ontologist, seed-architect, evaluator, qa-judge, contrarian\n**Support**: hacker, simplifier, researcher, architect\n<!-- ooo:END -->\n","category":"root","tokens":1046}]}