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 reach for AGENTS.md or CLAUDE.md as agent memory. It works until the founder needs to see what changed, who edited what, and whether it was verified — none of which a flat file shows.

The RAAV layer

RAAV starts where AGENTS.md stops. Memory is table stakes — a flat AGENTS.md is also memory. RAAV's difference is the founder-agent loop is visible: swimlanes to watch, a review queue to review, an audit trail to supervise.

The honest comparison: a file vs a visible loop

This is not RAAV against memory — RAAV keeps your AGENTS.md. It is a flat file against a visible collaboration loop. The wedge is not storage; it is review, watch, and supervise.

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.

That is exactly the gap RAAV fills with review, watch, and supervise.

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

The three pillars a file cannot provide

Review: proposals and memory candidates gate durable truth. Watch: swimlanes and claims show active work. Supervise: the audit trail records what shipped and passed.

Give your agent a memory it can operate through — and give yourself the surfaces to review, watch, and supervise it.

  • Pillar A: memory you can review
  • Pillar B: work you can watch
  • Pillar C: agents you can supervise

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 generates the AGENTS.md and adds the review, watch, and supervise surfaces on top.

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.

RAAV is local-first and zero-LLM by default. It is not a coding agent — it makes your rules file into reviewable memory.

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
Zero-LLM by default; RAAV is not a coding agent
Local tier is free; hosted Solo and Team plans are on the waitlist, not for sale yet

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.
Swimlanes to watch, audit trail to supervise.

FAQ

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

Is RAAV just an AGENTS.md generator?

No. It generates and syncs your AGENTS.md, but the wedge is visibility: a review queue to review changes, swimlanes to watch work, and an audit trail to supervise agents — none of which a flat file provides.

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. RAAV is the memory and audit layer around coding agents. It is zero-LLM by default.

What does it cost?

The local tier is free. Hosted Solo and Team plans are on the waitlist and not for sale yet.