ouroboros

v0.51.0

Turn vague ideas into validated specifications and verified software.

CodexClaude Code18 skills1 MCP serverstdio

by Q00MIT5.4kupdated 2 hours ago

Source

$ git clone https://github.com/Q00/ouroboros

Clone the source, then follow the repository's marketplace instructions for your runtime. The repository root is the plugin root.

Layout

ouroboros/

├── .codex-plugin/plugin.json
├── .claude-plugin/plugin.json
├── skills/auto/SKILL.md
├── skills/brownfield/SKILL.md
├── skills/cancel/SKILL.md
├── skills/evaluate/SKILL.md
├── skills/evolve/SKILL.md
├── skills/interview/SKILL.md
├── skills/ooo/SKILL.md
├── skills/pm/SKILL.md
├── skills/publish/SKILL.md
├── skills/qa/SKILL.md
├── skills/ralph/SKILL.md
├── skills/resume-session/SKILL.md
├── skills/seed/SKILL.md
├── skills/setup/SKILL.md
├── skills/tutorial/SKILL.md
├── skills/unstuck/SKILL.md
├── skills/update/SKILL.md
├── skills/welcome/SKILL.md
└── .mcp.json

Skills18

autoskills/auto/SKILL.md

Automatically converge from goal to A-grade Seed and execute it

brownfieldskills/brownfield/SKILL.md

Scan and manage brownfield repository/worktree defaults for interviews

cancelskills/cancel/SKILL.md

Cancel stuck or orphaned executions

evaluateskills/evaluate/SKILL.md

Evaluate execution with three-stage verification pipeline

evolveskills/evolve/SKILL.md

Start or monitor an evolutionary development loop

interviewskills/interview/SKILL.md

Socratic interview to crystallize vague requirements

oooskills/ooo/SKILL.md

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

pmskills/pm/SKILL.md

Generate a PM through guided PM-focused interview with automatic question classification. Use when the user says 'ooo pm', 'prd', 'product requirements', or wants to create a PRD/PM document.

publishskills/publish/SKILL.md

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

qaskills/qa/SKILL.md

General-purpose QA verdict for any artifact type

ralphskills/ralph/SKILL.md

MCP-owned Ralph loop around background evolve_step jobs

resume-sessionskills/resume-session/SKILL.md

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

seedskills/seed/SKILL.md

Generate validated Seed specifications from interview results

setupskills/setup/SKILL.md

Guided onboarding wizard for Ouroboros setup

tutorialskills/tutorial/SKILL.md

Interactive tutorial teaching Ouroboros hands-on

unstuckskills/unstuck/SKILL.md

Break through stagnation with lateral thinking personas — single or multi-persona debate

updateskills/update/SKILL.md

Check for updates and upgrade Ouroboros to the latest version

welcomeskills/welcome/SKILL.md

First-touch experience for new Ouroboros users

MCP servers1

ouroborosstdio

command: uvx
args: --from ouroboros-ai[mcp] ouroboros mcp serve --runtime codex --llm-backend codex

Manifests2

.codex-plugin/plugin.json

{
  "name": "ouroboros",
  "version": "0.51.0",
  "description": "Turn vague ideas into validated specifications and verified software.",
  "author": {
    "name": "Q00",
    "email": "jqyu.lee@gmail.com",
    "url": "https://github.com/Q00"
  },
  "homepage": "https://github.com/Q00/ouroboros",
  "repository": "https://github.com/Q00/ouroboros",
  "license": "MIT",
  "keywords": [
    "workflow",
    "requirements",
    "socratic",
    "interview",
    "evaluation"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.codex.json",
  "interface": {
    "displayName": "Ouroboros",
    "shortDescription": "Turn ideas into verified software.",
    "longDescription": "Clarify requirements, create a validated specification, execute it, and verify the result.",
    "developerName": "Q00",
    "category": "Development",
    "capabilities": [
      "Interactive",
      "Write"
    ],
    "websiteURL": "https://github.com/Q00/ouroboros",
    "defaultPrompt": [
      "Help me turn this product idea into a clear build plan.",
      "Start an Ouroboros interview for my new project.",
      "Open Ouroboros model settings."
    ]
  }
}

.claude-plugin/plugin.json

{
  "name": "ouroboros",
  "version": "0.51.0",
  "description": "Self-improving AI workflow system. Crystallize requirements before execution with Socratic interview, ambiguity scoring, and 3-stage evaluation.",
  "author": {
    "name": "Q00",
    "email": "jqyu.lee@gmail.com"
  },
  "repository": "https://github.com/Q00/ouroboros",
  "homepage": "https://github.com/Q00/ouroboros",
  "license": "MIT",
  "keywords": [
    "workflow",
    "requirements",
    "socratic",
    "interview",
    "seed",
    "evaluation",
    "self-improving",
    "drift-detection"
  ],
  "skills": "./skills/",
  "mcpServers": "./.mcp.json"
}