Examples
The repository ships three examples that step from a small refinement loop to a resumable coding workflow. Each one adds another piece of loop engineering: stronger verification, richer state, and stricter operational controls.
Bounded Document Refinement
Generator, critic, deterministic draft checks, and a hard max of five iterations.
Level 2Evidence-Driven Research
Research questions, source-backed claims, gap tracking, and a final report assembled from a local corpus.
Level 3Resumable Coding Loop
Observer, planner, implementer, sandbox verification, repeated-failure memory, and restart tolerance.
Level 1: Try it
uv run adk-loop run level-1The smallest example shows the shape of the controller clearly: draft, critique, revise, verify, and stop once deterministic and qualitative checks both agree.
Level 2: Try it
uv run adk-loop run level-2This example trades free-form summarization for evidence discipline. Questions become claims, claims carry source IDs, and the final report includes a claim-evidence matrix.
Level 3: Try it
uv run adk-loop run level-3The coding example runs against a fixture repository inside a sandbox. It proves that the same lifecycle can govern tool execution, test evaluation, failure memory, and run resumption.