This Claude Code plugin addresses the challenge of translating vague ideas into precise, validated specifications before AI-generated code is written. Targeting engineers and power users, it aims to eliminate rework by ensuring human clarity and ontological understanding, thereby fixing the input bottleneck in AI development.

How It Works

Ouroboros employs a specification-first approach, leveraging Socratic questioning and ontological analysis to uncover hidden assumptions. Its core architecture follows a "Double Diamond" process: Wonder → Ontology → Design → Evaluation. This iterative "evolutionary loop" refines specifications by feeding evaluation outputs back as inputs, aiming for clarity (Ambiguity ≤ 0.2) and stability (Ontology Similarity ≥ 0.95) before code generation.

Quick Start & Requirements

• Install: claude plugin marketplace add Q00/ouroboros followed by claude plugin install ouroboros@ouroboros.
• Setup: Run ooo setup within a Claude Code session.
• Prerequisites: Requires a Claude Code environment and Python 3.14+.

Highlighted Details

• Evolutionary Loop: Iteratively refines specifications across generations until convergence is met.
• Ambiguity Scoring: Quantifies clarity across Goal, Constraint, Success Criteria, and Context dimensions to gate spec generation.
• Ontology Convergence: Halts evolution when schema similarity between generations reaches ≥ 0.95.
• PAL Router: Implements 3-tier LLM cost optimization (1x, 10x, 30x) with auto-escalation/downgrade.
• Nine Minds: Utilizes nine specialized AI agents (e.g., Socratic Interviewer, Ontologist, Contrarian) for diverse thinking modes.
• Drift Detection: Monitors changes in Goal, Constraint, and Ontology with a threshold of ≤ 0.3.

Maintenance & Community

The repository links to GitHub Issues and Discussions for community interaction. No specific community channels like Discord or Slack are mentioned.

Licensing & Compatibility

Licensed under the MIT License, permitting broad use, including commercial applications, subject to the license's terms.

Limitations & Caveats

This tool functions exclusively as a Claude Code plugin and cannot be run independently. The evolutionary loop has a hard cap of 30 generations. While it supports brownfield exploration, complex legacy systems may require thorough validation.