Skip to content

Ouroboros

Plugin ID: clawql-harness (Ouroboros harness)
Packages: packages/clawql-harness — createOuroborosHarnessPlugin / makeHarnessLayer; library packages/clawql-ouroboros

Specification-first evolutionary loops with optional Postgres lineage storage. In clawql-mcp, tools always register through the harness — CLAWQL_ENABLE_OUROBOROS is deprecated as a registration gate.

MCP tools

Tool Purpose
clawql_think Structured planning / reflection helper
ouroboros_create_seed_from_document Create a Seed from an input document
ouroboros_run_evolutionary_loop Run Wonder/Reflect → Executor/Evaluator cycles
ouroboros_get_lineage_status Inspect lineage and convergence state
ouroboros_measure_drift 3-component drift vs root Seed (#557)

Registration and lineage

Env / Helm Default Effect
(always on) — makeHarnessLayer(createOuroborosHarnessPlugin) registers the tools above
CLAWQL_ENABLE_OUROBOROS (deprecated) No longer gates MCP registration; ignore for tool load
CLAWQL_OUROBOROS_DATABASE_URL or CLAWQL_OUROBOROS_DB_* unset = in-memory Durable Postgres events (clawql_ouroboros_events)
CLAWQL_ENABLE_LANGFUSE_EVAL=1 off Langfuse eval → ouroboros_propose_seed_revision_from_eval

Do not teach clawql-ouroboros/mcp-hooks as the clawql-mcp registration path (OK for embedding the library in your own MCP host).

Learn more