ouroboros
Stop prompting. Start specifying.
Install Ouroboros from PyPI with pip install ouroboros-ai. Run ooo setup in Claude Code to register the MCP server and initialize your project configuration.
How CLAUDE.md Integration Adds Ouroboros Reference Blocks to Your ProjectIntegrate Ouroboros reference blocks into your project with CLAUDE.md setup. Automatically add command, philosophy, and agent details, with backup and uninstall.
How the Q00/ouroboros EventStore Reconstructs Lineage Across Restarts: Event Sourcing Deep DiveDiscover how Q00/ouroboros EventStore reconstructs lineage after restarts. Learn how it replays events and uses deterministic projectors for immutable state.
How Ouroboros Parallel Execution Handles Multiple LLM Models SimultaneouslyLearn how Ouroboros Parallel Execution simultaneously manages multiple LLM models using PAL router and isolated async sessions. Discover efficient LLM orchestration.
How Claude Agent SDK Integration Works in the Ouroboros OrchestratorIntegrate Claude Agent SDK with Ouroboros Orchestrator using ClaudeAgentAdapter. This adapter handles message conversion, retry logic, resume capabilities, and implements the AgentRuntime protocol for seamless execution.
How to Configure Model Tier Selection (1x/10x/30x Cost Factors) in OuroborosLearn how to configure Model Tier selection in Ouroboros. Easily set 1x, 10x, or 30x cost factors by editing config.yaml or programmatically using the Tier enum.
How Ouroboros Performs Hierarchical Acceptance Criteria DecompositionLearn how Ouroboros performs hierarchical acceptance criteria decomposition. Discover its deterministic LLM-augmented pipeline for MECE principles and dependency mapping on Q00/ouroboros.
How the Ouroboros Interview Phase (Big Bang) Conducts Socratic QuestioningDiscover how the Ouroboros Interview Phase uses Socratic questioning to transform ambiguous ideas into precise requirements. Learn how this state-driven engine refines concepts before code generation.
How Ouroboros Defines Configuration Models Using Pydantic v2: Tiers, Credentials, and EconomicsLearn how Ouroboros defines configuration models with Pydantic v2. Explore immutable data models for LLM selection, cost tiers, provider credentials, and economics, ensuring strict validation and hashability.
How Ouroboros Provider Adapters Interface with LiteLLM, Anthropic, and Claude CodeLearn how Ouroboros Provider Adapters unify LiteLLM, Anthropic, and Claude Code for streamlined LLM request handling, retries, and error normalization. Simplify your AI integrations.
How MCP Integration with Claude Code Works for Ouroboros Plugin CommandsDiscover how MCP integration with Claude Code empowers Ouroboros plugin commands. Learn how external agents discover and invoke JSON-RPC tools via the ClaudeCodeAdapter and Max-Plan SDK.
How Double Diamond Decomposition Works in Ouroboros: Discover → Define → Design → DeliverLearn how Ouroboros applies Double Diamond decomposition within its `DoubleDiamond` orchestrator. Discover Define Design Deliver with event-sourced traceability and recursive capabilities.
Have a question about this repo?
These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:
curl -s "https://instagit.com/install.md" 
Maintain an open-source project? Get it listed too →