review-loop CLAUDE.md

review-loop CLAUDE.md is an instructions file for coding agents from NYTC69/review-loop. It costs 3,205 tokens per session, scanned C, original, Apache-2.0.

Repository instructions and development notes for a review-loop project. They document a known problem where its review agents can be started without access to tools such as reading files or running shell commands.

In plain words
What is it for?
Use them when adding or invoking review-loop agents, debugging their tool access, changing the plugin, or checking repository-specific development requirements.
Why use it?
They prevent misleading review results caused by agents that cannot inspect the code they are supposed to review. They also record rules about preserving the README and updating the plugin cache and version.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/nytc69/review-loop/claude-md
Clone the repo
git clone --depth 1 https://github.com/NYTC69/review-loop

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for review-loop CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/nytc69/review-loop/claude-md.svg)](https://agentmods.dev/instructions/nytc69/review-loop/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/nytc69/review-loop/claude-md"><img src="https://agentmods.dev/badge/instructions/nytc69/review-loop/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 3,205 This file is loaded in full into every session.
When invoked 3,205 The same file — it is already loaded in full.
Security scan C 2 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.03205 $0.03205
Opus 5 $0.01603 $0.01603
Sonnet 5 $0.00641 $0.00641
Haiku 4.5 $0.00320 $0.00320

Measured 4d ago against content hash 2cbced0b256e, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade C, and why

review-loop CLAUDE.md scanned grade C with 2 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Strips warnings and disclaimersmediumAnti-refusal

Omitting safety caveats hides risk from the user and is a common jailbreak preamble.

review-loop is designed for a broad audience — not every user will have the same tools installed. Any integration with external tools (MemPalace, Graphify, etc.) **must be strictly optional**: if the tool is unavailable,

Reads agent configuration directoriesmediumAgent snooping

.claude/, .codex/, .gemini/ hold keys, settings and other credentials a mod has no legitimate need for.

`~/.codex/config.toml`.
CLAUDE.md · 231 lines

How it starts

The opening of the file, as written. The whole thing — 231 lines — stays where its author put it; the contents beside it link to each section on GitHub.

review-loop — Development Notes

Known Pitfalls

Plugin agent type sandbox bug (CRITICAL)

ALL plugin-defined agent types have their tools silently blocked by Claude Code sandbox. This applies to both tools: all AND tools: read-only. Agents invoked via subagent_type: review-loop:<name> get zero tool access — they cannot Read, Grep, or Bash. The result is tool_uses: 0 and completely hallucinated output.

Fix: Always use subagent_type: general-purpose and inline the agent's .md body in the prompt. For read-only agents, add "Report only, do not modify files" to the prompt.

History: First discovered with Executor (tools: all) in commit 8506809. We incorrectly concluded tools: read-only was safe. This wrong assumption was recorded in memory and carried forward through 4+ commits (including a code-simplifier recurrence on 2026-04-06) until rust-reviewer was caught hallucinating (issue #3). The root cause is Claude Code's sandbox, not the tools: declaration.

Rule: When adding ANY new agent invocation, always use subagent_type: general-purpose with inlined body. Never use subagent_type: review-loop:<name>.

README.md must stay intact (lint SSOT dependency)

run-skill-lint's guide:readme_marks_* and shared-schema:* assertions treat several phrases inside README.md as the single source of truth (SSOT). Trimming or rewriting README content these assertions reach makes lint FAIL (5 cases observed during compass adopt Round 1). The compass-adopt migration handled this by double-storing the migrated blocks: ARCHITECTURE.md / CLAUDE.md / DESIGN.md gained ## Migrated — README.md:<lines> blocks, but the README body was reverted to its full 370-line form so existing lint needles still resolve.

Rule: do not trim or restructure README.md without first updating both the guide skill and the lint contract to point their needles at the new SSOT (e.g. the migrated blocks in CLAUDE.md). The ## Migrated — blocks are intentional duplication, not a cleanup target.

Read the full file on GitHub · 231 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 231 lines · 3,205 tokens per session scan C 2cbced0b256e

Subscribe to this mod's changes

review-loop CLAUDE.md is an instructions file published in the GitHub repository NYTC69/review-loop (3 stars, last pushed 3mo ago), licensed Apache-2.0. It adds 3,205 tokens to every session, about $0.0160 per session on Opus 5. A static security scan graded it C with 2 findings (strips warnings and disclaimers, reads agent configuration directories). No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.