# ouroboros | Q00 | Knowledge Base | Instagit

Stop prompting. Start specifying.

GitHub Stars: 1.2k

Repository: https://github.com/Q00/ouroboros

---

## Articles

### [How to Install Ouroboros from PyPI and Run `ooo setup` for Initial Configuration](/Q00/ouroboros/install-ouroboros-pypi-run-ooo-setup)

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.

- Tags: getting-started
- Published: 2026-03-14

### [How CLAUDE.md Integration Adds Ouroboros Reference Blocks to Your Project](/Q00/ouroboros/claude-md-integration-add-ouroboros-reference-blocks)

Integrate Ouroboros reference blocks into your project with CLAUDE.md setup. Automatically add command, philosophy, and agent details, with backup and uninstall.

- Tags: how-to-guide
- Published: 2026-03-14

### [How the Q00/ouroboros EventStore Reconstructs Lineage Across Restarts: Event Sourcing Deep Dive](/Q00/ouroboros/ouroboros-eventstore-reconstruct-lineage-restarts)

Discover how Q00/ouroboros EventStore reconstructs lineage after restarts. Learn how it replays events and uses deterministic projectors for immutable state.

- Tags: deep-dive
- Published: 2026-03-14

### [How Ouroboros Parallel Execution Handles Multiple LLM Models Simultaneously](/Q00/ouroboros/ouroboros-parallel-execution-multiple-models)

Learn how Ouroboros Parallel Execution simultaneously manages multiple LLM models using PAL router and isolated async sessions. Discover efficient LLM orchestration.

- Tags: deep-dive
- Published: 2026-03-14

### [How Claude Agent SDK Integration Works in the Ouroboros Orchestrator](/Q00/ouroboros/claude-agent-sdk-integration-ouroboros-orchestrator)

Integrate 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.

- Tags: deep-dive
- Published: 2026-03-14

### [How to Configure Model Tier Selection (1x/10x/30x Cost Factors) in Ouroboros](/Q00/ouroboros/configure-model-tier-selection-ouroboros-cost-factors)

Learn 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.

- Tags: how-to-guide
- Published: 2026-03-14

### [How Ouroboros Performs Hierarchical Acceptance Criteria Decomposition](/Q00/ouroboros/hierarchical-acceptance-criteria-decomposition-ouroboros-execution)

Learn how Ouroboros performs hierarchical acceptance criteria decomposition. Discover its deterministic LLM-augmented pipeline for MECE principles and dependency mapping on Q00/ouroboros.

- Tags: deep-dive
- Published: 2026-03-14

### [How the Ouroboros Interview Phase (Big Bang) Conducts Socratic Questioning](/Q00/ouroboros/ouroboros-interview-phase-socratic-questioning)

Discover 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.

- Tags: how-to-guide
- Published: 2026-03-14

### [How Ouroboros Defines Configuration Models Using Pydantic v2: Tiers, Credentials, and Economics](/Q00/ouroboros/ouroboros-pydantic-v2-configuration-models)

Learn 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.

- Tags: how-to-guide
- Published: 2026-03-14

### [How Ouroboros Provider Adapters Interface with LiteLLM, Anthropic, and Claude Code](/Q00/ouroboros/ouroboros-provider-adapters-llm-interface)

Learn how Ouroboros Provider Adapters unify LiteLLM, Anthropic, and Claude Code for streamlined LLM request handling, retries, and error normalization. Simplify your AI integrations.

- Tags: how-to-guide
- Published: 2026-03-14

### [How MCP Integration with Claude Code Works for Ouroboros Plugin Commands](/Q00/ouroboros/mcp-integration-claude-code-plugin-commands)

Discover 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.

- Tags: how-to-guide
- Published: 2026-03-14

### [How Double Diamond Decomposition Works in Ouroboros: Discover → Define → Design → Deliver](/Q00/ouroboros/double-diamond-decomposition-ouroboros-apply)

Learn how Ouroboros applies Double Diamond decomposition within its `DoubleDiamond` orchestrator. Discover Define Design Deliver with event-sourced traceability and recursive capabilities.

- Tags: deep-dive
- Published: 2026-03-14

### [How Seed Generation in Ouroboros Creates Immutable Specifications from Interview Data](/Q00/ouroboros/seed-generation-immutable-specifications-interview-data)

Learn how Ouroboros seed generation transforms interview data into immutable specifications using LLMs and Pydantic models for robust requirement capture.

- Tags: internals
- Published: 2026-03-14

### [The 5 Lateral Thinking Personas in Ouroboros: Hacker, Contrarian, Simplifier and More](/Q00/ouroboros/ouroboros-lateral-thinking-personas)

Discover the 5 lateral thinking personas in Ouroboros Hacker Researcher Simplifier Architect and Contrarian to overcome execution stagnation and reframe problems effectively.

- Tags: deep-dive
- Published: 2026-03-14

### [How the Ouroboros Brownfield Explorer Scans 15 Config File Types Across 12+ Ecosystems](/Q00/ouroboros/brownfield-explorer-scan-config-file-types-ecosystems)

Discover how Ouroboros Brownfield Explorer scans 15 config file types across 12+ ecosystems to detect projects and aggregate tech stack data for AI interviews.

- Tags: how-to-guide
- Published: 2026-03-14

### [Ouroboros 3-Stage Evaluation Pipeline: Mechanical → Semantic → Multi-Model Consensus Explained](/Q00/ouroboros/ouroboros-3-stage-evaluation-process)

Discover Ouroboros's 3-stage evaluation pipeline: Mechanical, Semantic, and Multi-Model Consensus. Filter defective code efficiently before costly LLM judges.

- Tags: deep-dive
- Published: 2026-03-14

### [How Stagnation Detection in Ouroboros Identifies Spinning, Oscillation, and No-Drift Patterns](/Q00/ouroboros/stagnation-detection-ouroboros-patterns)

Learn how Ouroboros Stagnation Detection analyzes SHA-256 hashes to identify spinning, oscillation, and no-drift execution patterns using a stateless detector and execution history.

- Tags: deep-dive
- Published: 2026-03-14

### [Ontology Convergence in Ouroboros: How the 0.95 Similarity Threshold Works](/Q00/ouroboros/ouroboros-ontology-convergence-similarity-threshold)

Discover Ontology Convergence in Ouroboros and the 0.95 similarity threshold that stops evolutionary development. Learn how this key metric drives progress.

- Tags: deep-dive
- Published: 2026-03-14

### [How the Ralph Persistent Evolutionary Loop Survives Session Boundaries in Ouroboros](/Q00/ouroboros/ralph-persistent-evolutionary-loop-across-sessions-ouroboros)

Discover how Ouroboros' Ralph persistent evolutionary loop survives session boundaries using event sourcing and stateless architecture to reconstruct state from the EventStore.

- Tags: internals
- Published: 2026-03-14

### [How Event Sourcing Works in Q00/ouroboros: BaseEvent and Aggregate Types Explained](/Q00/ouroboros/event-sourcing-ouroboros-baseevent-aggregate-types)

Discover how Event Sourcing works in Q00/ouroboros using BaseEvent and aggregate types. Learn about immutable event recording and deterministic replay with SQLite.

- Tags: deep-dive
- Published: 2026-03-14

### [How Ouroboros Drift Detection Measures Goal, Constraint, and Ontology Drift with 50/30/20 Weights](/Q00/ouroboros/ouroboros-drift-detection-measurement-weights)

Learn how Ouroboros Drift Detection measures goal, constraint, and ontology drift using 50/30/20 weights and a 0.3 threshold for early issue detection.

- Tags: deep-dive
- Published: 2026-03-14

### [Ouroboros Ambiguity Score Calculation and 0.2 Threshold Gate Explained](/Q00/ouroboros/ouroboros-ambiguity-score-calculation-and-threshold-gate)

Understand Ouroboros Ambiguity Score calculation and how the 0.2 threshold gate in Q00/ouroboros prevents seed generation for unclear goals, constraints, or success criteria.

- Tags: deep-dive
- Published: 2026-03-14

### [How Q00/ouroboros PAL Router Tier System Handles Auto-Escalation and Auto-Downgrade](/Q00/ouroboros/how-ouroboros-pal-router-tier-system-handles-auto-escalation-and-downgrade)

Discover how the Q00/ouroboros PAL Router tier system auto-escalates tasks after failures and auto-downgrades them via complexity recalculation. Learn about its robust fault tolerance.

- Tags: internals
- Published: 2026-03-14