RAAV vs AGENTS.md / CLAUDE.md

AGENTS.md is memory. RAAV is memory you can review.

A flat AGENTS.md or CLAUDE.md is also memory. RAAV keeps that file and adds the wedge: a review queue to review, swimlanes to watch, and an audit trail to supervise.

What RAAV gives agents

  • Keep the AGENTS.md your agents already read
  • Add a review queue so changes are not silent
  • Add swimlanes so parallel work is watchable
  • Add an audit trail so agent work is supervisable

The problem

Teams use AGENTS.md or CLAUDE.md as agent memory. A flat file cannot show the founder what changed, who edited it, or whether the result was verified.

The RAAV layer

AGENTS.md remains the stable rulebook. RAAV handles the volatile state around it: current priorities, claims, branches, proposed decisions, verification, and history. The two solve different problems and work well together.

The honest comparison: a file vs a visible loop

RAAV keeps AGENTS.md for stable instructions. It adds the changing project record that a flat file cannot maintain reliably.

What a flat file does well

An AGENTS.md or CLAUDE.md is simple, version-controlled, and readable by every agent. It carries conventions, setup, and operating rules with zero infrastructure.

RAAV does not replace that. It generates and syncs the file so your agents keep reading it.

  • Simple and version-controlled
  • Readable by every agent
  • Great for conventions and setup

Where a flat file runs out

A file cannot separate confirmed facts from assumptions, show which agent is editing which files, or record whether the last fix passed verification. It changes silently and the founder never sees the diff.

RAAV fills that gap with proposals, ownership claims, and recorded submits.

  • No confirmed-vs-inferred distinction
  • No visibility into active ownership
  • No verification or audit record

The three pillars a file cannot provide

Proposals hold unsettled product changes. Claims show active ownership. Submits retain the evidence from finished work.

RAAV adds the moving record around the file: proposed changes, active ownership, and completed-run evidence.

  • Proposed product changes wait for review
  • Claims show active work and ownership
  • Submits record verification and remaining risk

How the agent loop works

RAAV does not replace your coding agent. It gives the agent a durable operating system for product truth, task ownership, and proof.

Keep

RAAV generates and syncs your AGENTS.md and CLAUDE.md.

Review

Changes route through a founder review queue.

Watch

Swimlanes and claims make parallel work visible.

Supervise

The audit trail records verification and risk.

Keep the file, add the loop

Ask your agent to install RAAV. It keeps AGENTS.md for instructions and creates the project record around it.

Paste this into your coding agent
Install RAAV in this repo. Generate and sync our AGENTS.md and CLAUDE.md, then add a review queue, swimlanes, and audit trail on top of the rules file.

The existing rules file stays readable by every agent; RAAV adds the project state it should not carry.

Why this is different

Most tools either write code or track human tickets. RAAV sits between the founder and the coding agents as shared product memory, coordination, and audit.

Keeps and syncs your AGENTS.md and CLAUDE.md
Rules and task state are stored directly, not rewritten by a hidden model
The Trial is €10/week; hosted signup is being opened gradually after founder review

AGENTS.md vs RAAV

Storage
A flat file of rules and conventions.
The same file, generated and synced by RAAV.
Review
Changes are silent; no founder sign-off.
Changes route through a review queue.
Watch and supervise
No ownership visibility, no verification record.
Active lanes show ownership; submitted checks show what finished.

FAQ

This page answers the honest question: if AGENTS.md is already memory, why RAAV?

Is RAAV just an AGENTS.md generator?

No. RAAV generates and syncs AGENTS.md, then keeps proposed changes, active ownership, and completed-run evidence in separate live records.

Do I lose my existing AGENTS.md?

No. RAAV keeps your project-specific content and syncs the operating rules across agent files.

Is RAAV a coding agent?

No. AGENTS.md tells a coding agent how to behave; RAAV keeps that file and the project state around the agent current.

What does it cost?

The Trial is €10/week. Solo and Team increase project limits, history, and collaboration. The public checkout button stays disabled until testing is complete.

RAAV vs AGENTS.md / CLAUDE.md | RAAV