agents-md-roast
ban10yuu/agents-md-roast
Audita AGENTS.md localmente para evitar regras vagas em agents
Ver no GitHubRevisor local e rigoroso de arquivos AGENTS.md e CLAUDE.md que identifica regras vagas, verificações faltantes e instruções inseguras antes que treinem mal seu coding agent. Executa sem API key, sem telemetria, inteiramente local.
Instalação
npx convez-ai ban10yuu/agents-md-roast1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.
Métricas
Casos de uso
- Validar AGENTS.md antes de usar com Claude Code ou Cursor
- Detectar instruções inseguras ou ambíguas em definições de agents
- Garantir qualidade de prompt engineering em repositórios de coding agents
Veredito

Ferramenta narrow e bem focada que resolve um problema real: validação local de AGENTS.md sem overhead. Excelente para quem trabalha com coding agents e quer auditoria rápida antes de entrar em produção.
README
A tradução para o português deste README ainda está na fila.
agents-md-roast
A tiny, mean AGENTS.md reviewer that catches vague rules, missing verification, and unsafe instructions.
npm exec --yes --package github:ban10yuu/agents-md-roast#main -- agents-md-roast AGENTS.md
No API key. No telemetry. Runs locally.
Why this exists
AI coding-agent repos are filling up with broad frameworks and magic prompts. This project goes the other way: one narrow local check, one memorable failure mode, and output a human can inspect.
What makes it different
- It does not call an LLM.
- It does not ask for an API key.
- It focuses on one agent-era mistake instead of becoming another framework.
- It is small enough to read before trusting it.
Install
Run from GitHub:
npm exec --yes --package github:ban10yuu/agents-md-roast#main -- agents-md-roast --help
Or clone locally:
git clone https://github.com/ban10yuu/agents-md-roast.git
cd agents-md-roast
npm install
npm run check
Usage
agents-md-roast --help
agents-md-roast AGENTS.md
Example
This repository includes fixtures and tests that show the command output. Run:
npm run check
Design principles
- Local-first.
- No hidden network calls.
- Small enough to audit.
- Useful to Claude Code, Codex, Cursor, OpenCode, Gemini CLI, and other coding agents.
Repository topics
agentscodexclaude-codeagents-mdlinttypescriptlocal-first
Status
Alpha. Single-maintainer. Issues and pull requests are welcome.
License
MIT