Home / cq27-dev / rag-rat · AGENTS.md · GitHub

AGENTS.md agentsA

AGENTS.md is agent-read markdown (agents) from cq27-dev/rag-rat.

Indexed from public GitHub and served as immutable, content-addressed versions. Install it pinned to an exact SHA-256 with the mdr CLI, and every file is verified against the hash recorded here before it reaches your agent. The deterministic audit below grades the latest version, and the same file always earns the same grade.

What the file says

# AGENTS.md

Guidance for coding agents working in the `rag-rat` repository.
(`CLAUDE.md` is a symlink to this file.)

## Prefer the rag-rat MCP for code browsing

This repo ships `rag-rat` — a local repo-intelligence index and MCP server — and it is indexed by
its own server (dogfooded). **Heavily prefer the `rag-rat` MCP tools over raw `grep`/`cat`/file
reads when browsing or understanding code.** One MCP call returns more context, faster, than a
shell sweep, and it surfaces *drive-by repo memories* (source-anchored invariants, decisions,
risks) attached to the code you're touching — context you would otherwise never see.

Reach for these first:

- **`semantic_search`** — "where is this concept implemented?" Returns current source chunks with
  inline graph (callers/callees), git, and GitHub papertrail, all validated against current source.
- **`symbol_lookup`** — exact/fuzzy symbol resolution (Rust/TS/Kotlin/C/C++/Python/Swift/Go), with
  any bound memories attached.
- **`impact_surface`** — the coding preflight before editing a symbol: graph callers/callees,
  tests, git history, papertrail, and **repo memories** crossing the call path. Run it before
…

Read the whole file at its exact version.

How to install

Latest version
mdr add cq27-dev/rag-rat/AGENTS.md@git:20260923.5873be4
Exact content
mdr add cq27-dev/rag-rat/AGENTS.md@sha256:577f633ce68046c0

Pin to a label to follow the author's releases, or to a sha256 to freeze the exact bytes forever. Either way the resolved hash is written to mdr.lock, and mdr install reproduces it on any machine.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_7pxjyfwzzx3h72tj.svg)](https://markdownregistry.com/a/art_7pxjyfwzzx3h72tj)

1 badge views in 30 days

Versions

versioncommittedcommitsizeaudit
git:20260923.5873be4 latest2026-09-23 5873be4 12,436 BA view · diff
git:20260923.d7898ea2026-09-23 d7898ea 12,247 BA view · diff
git:20260806.f87a5a12026-08-06 f87a5a1 12,216 BA view · diff
git:20260806.bb71dac2026-08-06 bb71dac 11,568 BA view · diff
git:20260730.be80f5a2026-07-30 be80f5a 10,097 BA view · diff
git:20260730.296ed102026-07-30 296ed10 9,521 BA view · diff
git:20260728.ea6e9da2026-07-28 ea6e9da 9,512 BA view

Audit of the latest version

A  14 of 14 checks passed. Deterministic, no model, same answer every run.
  • pass: Size between 200 bytes and 200 KB (12436 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

cq27-dev/rag-rat · 20 stars · license MIT · pushed 2026-09-23 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_7pxjyfwzzx3h72tj
GET https://markdownregistry.com/api/v1/resolve?ref=cq27-dev/rag-rat/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/577f633ce68046c0947689485dc8151ba04738135f435056aa090987e59a6f57

Your agent does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

More from cq27-dev/rag-rat

configure-rag-rat-dream skill
cq27-dev/rag-rat · .agents/skills/configure-rag-rat-dream/SKILL.md · Use to enable and operate rag-rat's optional AI memory-maintenance passes — the `dream --verify` / `--compact` model…
git:20260711.a2328dc · audit A · 20 stars
dream-review skill
cq27-dev/rag-rat · .agents/skills/dream-review/SKILL.md · Use when asked to review, triage, or resolve rag-rat "dream" findings — the memory-maintenance worklist the `dream`…
git:20260923.d7898ea · audit A · 20 stars
init-rag-rat skill
cq27-dev/rag-rat · .agents/skills/init-rag-rat/SKILL.md · Use to set up rag-rat in a repository that is not indexed yet — when the rag-rat MCP server is DORMANT (its tools…
git:20260923.7774461 · audit A · 20 stars
rust-modern-style skill
cq27-dev/rag-rat · .agents/skills/rust-modern-style/SKILL.md · Apply rag-rat's Rust style when writing or reviewing Rust: current stable idioms, module-qualified free functions and…
git:20260728.7d950c9 · audit A · 20 stars
using-rag-rat skill
cq27-dev/rag-rat · .agents/skills/using-rag-rat/SKILL.md · Use when working in a repository indexed by rag-rat (a `rag-rat.toml` at the root and a rag-rat MCP server available)…
git:20260923.d7898ea · audit A · 20 stars
CLAUDE.md claude
cq27-dev/rag-rat · CLAUDE.md
git:20260609.b6c71a8 · audit B · 20 stars
configure-rag-rat-dream skill
cq27-dev/rag-rat · plugin/skills/configure-rag-rat-dream/SKILL.md · Use to enable and operate rag-rat's optional AI memory-maintenance passes — the `dream --verify` / `--compact` model…
git:20260711.a2328dc · audit A · 20 stars
dream-review skill
cq27-dev/rag-rat · plugin/skills/dream-review/SKILL.md · Use when asked to review, triage, or resolve rag-rat "dream" findings — the memory-maintenance worklist the `dream`…
git:20260923.d7898ea · audit A · 20 stars
init-rag-rat skill
cq27-dev/rag-rat · plugin/skills/init-rag-rat/SKILL.md · Use to set up rag-rat in a repository that is not indexed yet — when the rag-rat MCP server is DORMANT (its tools…
git:20260923.7774461 · audit A · 20 stars
using-rag-rat skill
cq27-dev/rag-rat · plugin/skills/using-rag-rat/SKILL.md · Use when working in a repository indexed by rag-rat (a `rag-rat.toml` at the root and a rag-rat MCP server available)…
git:20260923.d7898ea · audit A · 20 stars

Every file in cq27-dev/rag-rat

Other files named AGENTS.md

AGENTS.md agents
obra/superpowers · AGENTS.md
git:20260919.5bf4e78 · audit A · 291,204 stars
AGENTS.md agents
affaan-m/ecc · AGENTS.md
git:20260919.91ba9b4 · audit A · 266,832 stars
AGENTS.md agents
firecrawl/firecrawl · AGENTS.md
git:20260613.d9a35c0 · audit A · 184,144 stars
AGENTS.md agents
dietrichgebert/ponytail · AGENTS.md
git:20260710.b6c0448 · audit A · 144,862 stars
AGENTS.md agents
garrytan/gstack · AGENTS.md
git:20260914.4a3c6a8 · audit A · 134,082 stars
AGENTS.md agents
graphify-labs/graphify · AGENTS.md
git:20260414.7ec92ec · audit A · 121,202 stars
AGENTS.md agents
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 107,708 stars
AGENTS.md agents
addyosmani/agent-skills · AGENTS.md
git:20260709.b665c5c · audit A · 98,554 stars

Browse by kind, by grade A, or by owner.