VictorVVedtion

Ouro Loop — AI skill for Claude Code

AI community

Give AI coding agents (Claude Code, Cursor, Aider, Codex) a structured autonomous loop with guardrails — boundaries, 5 verification gates, 3-layer self-reflection, and autonomous remediation.

How to install Ouro Loop

This entry records only its repository, not the path inside it, so there is no exact command to give. Open VictorVVedtion/ouro-loop and copy the folder into ~/.claude/skills/, or the file into ~/.claude/agents/.

What Ouro Loop does

Give AI coding agents (Claude Code, Cursor, Aider, Codex) a structured autonomous loop with guardrails — boundaries, 5 verification gates, 3-layer self-reflection, and autonomous remediation. pip install ouro-loop. Zero dependencies.

Alternatives in AI

Orkas — Open-source multi-agent AI desktop client — build and command your AI agent team through conversation 1.5k ★
Ralphex — Extended Ralph loop for autonomous AI-driven plan execution 1.1k ★
Ralph Claude Code — Autonomous AI development loop for Claude Code with intelligent exit detection 1k ★

README

Ouro Loop

![Ouro Loop — Autonomous AI Agent Development Framework](assets/banner.png)

**"To grant an entity absolute autonomy, you must first bind it with absolute constraints."**

[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](https://opensource.org/licenses/MIT) [![PyPI version](https://img.shields.io/pypi/v/ouro-loop.svg)](https://pypi.org/project/ouro-loop/) [![Python >=3.10](https://img.shields.io/badge/python->=3.10-blue.svg)](https://www.python.org/downloads/) [![CI](https://github.com/VictorVVedtion/ouro-loop/actions/workflows/test.yml/badge.svg)](https://github.com/VictorVVedtion/ouro-loop/actions/workflows/test.yml) [![Tests: 499](https://img.shields.io/badge/tests-507_passed-brightgreen.svg)]() [![Status: Experimental](https://img.shields.io/badge/status-experimental-orange.svg)]()

What is Ouro Loop?

**Ouro Loop** is an open-source framework that gives AI coding agents (Claude Code, Cursor, Aider, Codex) a structured autonomous loop with runtime-enforced guardrails. It implements **bounded autonomy** — the developer defines absolute constraints (DANGER ZONES, NEVER DO rules, IRON LAWS) using the BOUND system, then the agent loops autonomously through Build → Verify → Self-Fix cycles. When verification fails, the agent doesn't ask for help — it consults its remediation playbook, reverts, tries a different approach, and reports what it did. Constraints are enforced at the runtime level through Claude Code Hooks (exit 2 hard-block), not by relying on the agent's "good behavior." Inspired by Karpathy's [autoresearch](https://github.com/karpathy/autoresearch), extended from ML to general software engineering. Zero dependencies, pure Python 3.10+.


What it does	Let AI agents code overnight without breaking things
How it works	Define boundaries (BOUND) → AI loops: Build → Verify → Self-Fix
What you get	`program.md` (method) + `framework.py` (runtime) + `sentinel.py` (24/7 review) + 5 ho