Borrowing it
Nothing to install: this file belongs to antonbabenko/deliberation. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/antonbabenko/deliberation/master/AGENTS.mdgit clone --depth 1 https://github.com/antonbabenko/deliberationWrote 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.
[](https://agentmods.dev/instructions/antonbabenko/deliberation/agents-md)<a href="https://agentmods.dev/instructions/antonbabenko/deliberation/agents-md"><img src="https://agentmods.dev/badge/instructions/antonbabenko/deliberation/agents-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.
<a href="https://agentmods.dev/instructions/antonbabenko/deliberation/agents-md"><img src="https://agentmods.dev/badge/instructions/antonbabenko/deliberation/agents-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.01341 | $0.01341 |
| Opus 5.5 | $0.00536 | $0.00536 |
| Sonnet 5.5 | $0.00268 | $0.00268 |
| Haiku 4.5 | $0.00134 | $0.00134 |
Grade A, and why
deliberation AGENTS.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 18d 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.
How it starts
The opening of the file, as written. The whole thing — 93 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AGENTS.md
Instructions for any coding agent (Claude Code, Codex, Cursor, Gemini, Kiro, OpenCode, ...) working on this repository. For how to USE deliberation as an MCP server, read docs/tool-guide.md instead.
What this repo is
deliberation gives a host agent GPT (Codex CLI), Gemini 3 (Antigravity CLI agy), Grok
(xAI API) and OpenRouter models as expert reviewers over MCP. It ships as a Claude Code
plugin, as native plugins/skills for other hosts, and as one standalone MCP server
(@antonbabenko/deliberation-mcp). Seven expert personas live in prompts/. Every provider
is advisory except Gemini, which can also implement (workspace-write).
Plain Node (18+; CI runs 20), no runtime dependencies, no build step for development. core/ is
host-neutral and strict-typed (checkJs); server/mcp/ is the MCP server over it;
server/{gemini,grok,openrouter}/ are the provider bridges; server/dashboard/ is the
local read-only dashboard.
Commands
npm run check # typecheck + every test suite; must pass before any PR
npm run test:contracts # hermetic multi-host contract suite
npm run sync # regenerate every generated file (personas, host files, command fallbacks)
npm run sync:check # fail if any generated file is stale (CI runs the same check)
node server/mcp/index.js # run the MCP server from this checkout (any host)
claude --plugin-dir . # Claude Code: load the plugin from this checkout
Some bridge tests listen on 127.0.0.1 and npm run sync writes .mcp.json files; an
agent sandbox may block both, so rerun outside it when you see EPERM.
Rules for every change
Docs ship in the same PR. A tool, config key, flag, default, persisted shape, or any user-visible behavior is not done until every surface it touches is current:
README.md- feature list and config summariesTECHNICAL.md- deep reference: config tables, shapes, threat-model notesSETUP.md- user config walkthrough and examplesdocs/tool-guide.md- host-neutral tool and behavior surfacedocs/dev/architecture.mdanddocs/dev/design-decisions.md- when structure changes or you make a choice a future reader would questionconfig/config.schema.jsonANDconfig/config.default.json- every new key needs both (state any threat model in the schema description); thevalidatecheck fails on driftcommands/and skill prose, when the behavior they describe changed
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.
- 18d ago Changed · -135 lines · -2,323 tokens per session scan C → A 61e47582cc4b
- 19d ago Changed · +29 lines · +375 tokens per session ef1f3c35d4bd
- 20d ago Changed · +10 lines · +66 tokens per session ed07d212f9b4
- 23d ago Changed · +14 lines · +334 tokens per session 7385ca59a460
- 1mo ago Changed · +5 lines · +108 tokens per session 8161e0d88c68
- 1mo ago Changed · +8 lines · +106 tokens per session 99f28f94c1b3
- 1mo ago Changed · +4 lines · +93 tokens per session d1597cb72beb
- 1mo ago Changed · +3 lines · +64 tokens per session a97e45cfb340
- 1mo ago Changed · +5 lines · +118 tokens per session d244eb6d7688
- 1mo ago First seen · 150 lines · 2,400 tokens per session scan C 5bc0a8bbbf33
deliberation AGENTS.md is an instructions file published in the GitHub repository antonbabenko/deliberation (178 stars, last pushed 12d ago), licensed MIT. It adds 1,341 tokens to every session, about $0.0054 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
next.js AGENTS.md
AGENTS.md instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, cache eligibility and rollout and applying the notice (cutover).
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode copilot-instructions.md
Copilot instructions for microsoft/vscode, covering vs code copilot instructions, project overview, root folders, core architecture (src/ folder) and built-in extensions (extensions/ folder).
deno copilot-instructions.md
Copilot instructions for denoland/deno, covering deno development guide for github copilot, network access, high level overview, key directories and key files to understand first.