convez.ai
AgenteAutomaçãoIntermediário
ban10yuu

agents-md-roast

ban10yuu/agents-md-roast

Audita AGENTS.md localmente para evitar regras vagas em agents

Ver no GitHub
InicialPluginScore · de 0 a 100

Revisor 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-roast

1 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

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 5 meses
Versão
v0.1.0
Issues abertas
0
Contribuidores
1

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

  • agents
  • codex
  • claude-code
  • agents-md
  • lint
  • typescript
  • local-first

Status

Alpha. Single-maintainer. Issues and pull requests are welcome.

License

MIT

Ver o original no GitHub

Bom para

Relacionados