cerebro: Instructions file for Claude Code

CLAUDE.md

cerebro CLAUDE.md is an instructions file for Claude Code from jhonmosquerav/cerebro. It costs 4,060 tokens per session, scanned A, a copy of cerebro AGENTS.md, MIT.

Repository instructions for CEREBRO, a documentation system built from Markdown and JSONL files. They describe how an agent should navigate its knowledge, preserve source files, and record approved changes.

In plain words
What is it for?
Use them when an agent starts a CEREBRO session, searches its stored knowledge, or proposes and records documentation changes.
Why use it?
They keep documentation changes traceable, repeatable, and limited to approved updates instead of uncontrolled edits.

Instructions file for Claude Code

Written for Claude Code: PreCompact hook event. Also seen: reads .claude/ paths; mentions Claude Code; mentions AGENTS.md.

This is jhonmosquerav/cerebro's own configuration. It tells Claude Code how to work on cerebro itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything cerebro configures →

Reuse

Borrowing it

Nothing to install: this file belongs to jhonmosquerav/cerebro. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/jhonmosquerav/cerebro/main/CLAUDE.md
Clone the repo
git clone --depth 1 https://github.com/jhonmosquerav/cerebro

Made for: Claude Code.

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 cerebro CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/jhonmosquerav/cerebro/claude-md/github.svg)](https://agentmods.dev/instructions/jhonmosquerav/cerebro/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/jhonmosquerav/cerebro/claude-md"><img src="https://agentmods.dev/badge/instructions/jhonmosquerav/cerebro/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for cerebro CLAUDE.md

Your own site · 80×15
<a href="https://agentmods.dev/instructions/jhonmosquerav/cerebro/claude-md"><img src="https://agentmods.dev/badge/instructions/jhonmosquerav/cerebro/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 4,060 This file is loaded in full into every session.
When invoked 4,060 The same file — it is already loaded in full.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin 100% copy Near-identical to another mod 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.1 $0.04060 $0.04060
Opus 5.5 $0.01624 $0.01624
Sonnet 5.5 $0.00812 $0.00812
Haiku 4.5 $0.00406 $0.00406

Measured 11d ago against content hash 674fcc5f83eb, method: parsed. Prices are Anthropic first-party input rates as of 2026-10-07, from the pricing page.

Security

Grade A, and why

cerebro CLAUDE.md scanned grade A with 0 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 11d 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.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

Origin

This is a copy

100% identical to cerebro AGENTS.md — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

CLAUDE.md · 141 lines

How it starts

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

CEREBRO — manual operativo del agente

Eres el arquitecto y guardián de CEREBRO: un sistema de documentación agéntico, mutagénico y reproducible, construido 100% sobre markdown + JSONL en esta carpeta. Sin RAG, sin vectores, sin servidores. Cualquier empresa puede clonar esta carpeta, correr ONBOARD y operar su conocimiento.

Al arrancar cualquier sesión: lee primero index.md, luego la parte reciente de log.md, y este índice de genes activos. Nunca cargues la wiki entera. Si existe genome/perfil.md, respétalo: una operación cuya capacidad esté apagada no se ejecuta ([[gen-perfiles]]); dilo y propone activarla por manifiesto.

Principios inviolables

  1. raw/ es inmutable: nunca edites ni borres una fuente; solo lees de ahí.
  2. Idempotencia: reejecutar una operación no debe duplicar páginas ni romper enlaces.
  3. Presupuesto de contexto: navega primero y SIEMPRE desde index.md por relaciones; si la navegación se agota, usa el fallback léxico sancionado de [[gen-query]] (busca contenido y abre solo candidatos). Nunca leas la wiki entera.
  4. Mutación con compuerta (modo híbrido): toda reescritura del genoma se PROPONE, espera mi aprobación explícita y solo entonces se aplica y se registra en genome/events.jsonl.
  5. Auditabilidad: toda mutación deja una línea en genome/events.jsonl (append-only, nunca se reescribe).
  6. Todo enlace es [[wiki-link]] y todo archivo de wiki/ lleva frontmatter YAML (Obsidian-friendly: Bases/Dataview).
  7. Antes de borrar o sobrescribir algo que no creaste tú, detente y pregúntame.

Operaciones (gatillos)

Verbo Gatillo Qué hace Capacidad
ONBOARD primera vez / cambio de empresa Aplica el manifiesto onboard/company.yaml (determinista, reproducible) → siembra perfil + genes del sector. init --profile [--blueprint] deja el manifiesto semilla; la entrevista solo lo completa. Blueprints catalogados con versión y min_cerebro (blueprints): uno que exija más CEREBRO del instalado se rechaza sin escribir. núcleo
INGEST <X> "ingiere / digiere esto" Clasifica, crea/actualiza página con frontmatter, extrae conceptos, enlaza, actualiza index + log. núcleo
BULK INGEST "procesa todo raw/" Corre INGEST sobre cada archivo de raw/; reporta y actualiza index. núcleo
QUERY <X> "busca / qué sabemos de" Navega desde index.md por relaciones (hubs incluidos); si el grafo no alcanza, fallback léxico sancionado y declarado ([[gen-query]]). Responde citando páginas-fuente. núcleo
CHECKPOINT "checkpoint" / el agente lo propone ante contexto largo o cierre de sesión sin hooks Implementación manual portable del loop de memoria: vuelca lo valioso no persistido a wiki/working/, actualiza el episódico de la sesión, refresca anclas si nacieron páginas y deja línea en log.md. Idempotente por clave de sesión (re-ejecutar actualiza, no duplica). Regla: [[gen-checkpoint]]. memoria
LINT mantenimiento Detecta huérfanos, contradicciones, vencidos (blando por decay_rate; duro por valido_hasta/vigencia), verbos y campos fuera de esquema, enlaces sugeridos (LNK-03, preventivo); propone y aplica tras OK. núcleo
CONSOLIDATE mantenimiento Promueve conocimiento confirmado de tier (working→semantic), fusiona duplicados, baja confidence de lo no reforzado — con los umbrales numéricos de [[gen-ciclo-de-vida]]; parte secciones del índice que superen hub_umbral en páginas-hub ([[gen-jerarquizacion-indice]]). ciclo_de_vida
EVOLVE patrón repetido detectado PROPONE mutación de genoma (nuevo/editar/deprecar gen). Aplica solo con OK + línea en events.jsonl. evolucion
AUDIT "auto-audítate / audita el cerebro" Audita la base y PROPONE ≤3 mejoras de mayor impacto (contradicciones, vacíos, reglas obsoletas/redundantes), reproducible, con maker≠auditor y gate. Estado en audit/runs/. auditoria
GRAPH "visualiza / analiza el grafo" Deriva señales estructurales de forma mecánica y sin dependencias (graph: componentes, grado, hubs, huérfanas, puentes, camino; graph --canvas lo escribe como JSON Canvas nativo con allowlist fail-closed), y opcionalmente corre una lente externa para lo semántico sobre copia staging no-confidencial de wiki/; deriva señales (hubs, comunidades, caminos, islas) y las PROPONE a CONSOLIDATE/QUERY/LINT/EVOLVE. Salida derivada en dashboards/graph/*.canvas y graphify-out/ (no versionada). Regla: [[gen-graph-lens]]. grafo
XRAY "mide la deriva" / mantenimiento Compara grafo declarado vs evidencia (local u --inferred). Tres buckets + score de deriva → PROPONE a LINT/CONSOLIDATE/EVOLVE. Corridas en audit/xray/. Regla: [[gen-xray]]. auditoria

Read the full file on GitHub · 141 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. 11d ago Changed · +1 lines · +64 tokens per session 674fcc5f83eb
  2. 13d ago Changed · +3 lines · +123 tokens per session c8dfdca00cb9
  3. 16d ago Changed · +21 lines · +621 tokens per session 0047076c2c39
  4. 1mo ago Changed · +171 tokens per session ded7eba41921
  5. 2mo ago First seen · 116 lines · 3,081 tokens per session scan A 23602e17eb06

Subscribe to this mod's changes

cerebro CLAUDE.md is an instructions file published in the GitHub repository jhonmosquerav/cerebro (5 stars, last pushed 4d ago), licensed MIT. It adds 4,060 tokens to every session, about $0.0162 per session on Opus 5.5. A static security scan graded it A with 0 findings. It is 100% identical to cerebro AGENTS.md, differing in 0 lines, and is treated as a copy.

Related

cerebro CLAUDE.md compared with instructions from other repositories

cerebro CLAUDE.md next to 6 instructions from other repositories
ModTypeStarsLast pushLicenceScanTokensWorks with
cerebro CLAUDE.mdjhonmosquerav/cerebroInstructions file54d agoMITA4,060Claude Code
vscode buildNext.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA9,719GitHub Copilot
next.js AGENTS.mdvercel/next.jsInstructions file143kyesterdayMITA7,461Codex, OpenCode
langchain AGENTS.mdlangchain-ai/langchainInstructions file149kyesterdayMITA4,680Codex, OpenCode
vscode oss-third-party-notices.instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA5,516GitHub Copilot
vscode copilot-instructions.mdmicrosoft/vscodeInstructions file195kyesterdayMITA3,093GitHub Copilot
deepseek-harness AGENTS.mddeepseek-ai/deepseek-harnessInstructions file274k2d agoMITA4,313Codex, OpenCode