luizssantiago92

Retornatus — AI skill for Claude Code

AI community

Repo-native governance for AI coding agents (Cursor, Claude Code, Codex).

How to install Retornatus

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

What Retornatus does

Repo-native governance for AI coding agents (Cursor, Claude Code, Codex). Agree on the finish line in writing, execute under that contract, and close only when evidence proves the goal. Intent, progress and lessons live in .retornatus/ in git, not in chat history.

Alternatives in AI

Open Multi Agent — TypeScript multi-agent orchestration engine — one runTeam() call from goal to result 5.8k ★
Sentrux — Real-time architectural sensor that helps AI agents close the feedback loop, enabling recursive self-improveme 2.9k ★
Academic Humanizer — Strip AI-writing tells from papers and grant proposals (NSF/NIH), while keeping scholarly voice and tying clai 1.1k ★

README

Retornatus

Ember — Retornatus mascot

Keep AI coding agents honest — with goals, memory, and proof.
Govern the work. Bound the agent. Verify the outcome.

Website → · Docs · Quick start · PyPI

[![Website](https://img.shields.io/badge/website-live-14b8a6?style=flat)](https://luizssantiago92.github.io/retornatus/) [![PyPI version](https://img.shields.io/pypi/v/retornatus.svg)](https://pypi.org/project/retornatus/) [![Python 3.11+](https://img.shields.io/badge/python-3.11%2B-blue.svg)](https://www.python.org/downloads/) [![CI](https://github.com/luizssantiago92/retornatus/actions/workflows/ci.yml/badge.svg)](https://github.com/luizssantiago92/retornatus/actions/workflows/ci.yml) [![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

**Repo-native governance harness** for AI coding agents (Cursor, Claude Code, Codex, and similar).

Agents are fast — and optimistic. They ship code, summarize what they *think* they did, and move on. Retornatus installs a **repeatable contract** into your repo: agree on the finish line in writing, execute under that agreement, and close only when **evidence** supports the goal. Intent, progress, and lessons live under **`.retornatus/` in git**, not in a chat scrollback.

Your coding agent still **writes the code**. Retornatus **governs the loop and keeps the record**.