Skip to content

agents-md: checklist e checador para o AGENTS.md de um repositorio (0.1.0) - #25

Merged
4nrry merged 1 commit into
mainfrom
agents-md
Oct 14, 2026
Merged

4nrry merged 1 commit into
mainfrom
agents-md

Conversation

@4nrry

@4nrry 4nrry commented Oct 14, 2026

Copy link
Copy Markdown
Owner

Plugin novo agents-md: escrever, enxugar e auditar o arquivo de instruções de agente de um repositório.

  • Skill com o que entra (comando que existe, como provar que terminou, armadilha que falha em silêncio, contrato com outro repo), o que sai (árvore, lista derivável, história, grito em caixa alta), a forma e onde cada coisa mora quando não cabe.
  • Tabela de limites por ferramenta. Claude Code lê AGENTS.md nativo desde a 2.1.277, só sem CLAUDE.md/CLAUDE.local.md na pasta ou acima; Antigravity não lê CLAUDE.md, não expande @arquivo solto, corta em 24 KB por arquivo e soma 20 mil tokens de regras always-on; Codex junta até 32 KiB da raiz do git até o cwd.
  • Arquivo global. O Claude Code só tem ~/.claude/CLAUDE.md; o Antigravity lê ~/.gemini/config/AGENTS.md. O Claude procura AGENTS.md em todas as pastas acima do cwd, e o Antigravity e o Codex param na raiz do git, então um AGENTS.md comum acima dos repos só chega a eles por ponteiro. Lido no texto embutido do language_server do Antigravity 2.23.1 e na doc de memória do Claude Code (2.1.300).
  • Checador mecânico (scripts/check_agents_md.py, stdlib, --self-test): teto de tamanho, npm run X que não existe, caminho citado que não existe, palavras de grito, CLAUDE.md que esconde o AGENTS.md, GEMINI.md com @arquivo. Sai 1 quando aponta algo.

Origem: a limpeza dos arquivos de instrução de 19 repositórios (até 974 linhas por arquivo; sete invisíveis para o Antigravity por viverem em CLAUDE.md). Verificadores baratos acharam 11 afirmações falsas em 16 rascunhos já revisados.

O que não foi medido: não há run records, então nada aqui alega melhoria com a skill contra sem ela (bench/PROTOCOL.md). O checador dá falso positivo esperado em caminho relativo a outro repo; o README avisa.

just check: 129 verificações sem falha; self-test do checador ok.

🤖 Generated with Claude Code

….1.0)

Skill com o que entra e o que sai do arquivo, os limites de cada ferramenta
(Claude Code, Antigravity, Codex) e um checador stdlib com --self-test que pega
script inexistente, caminho morto, arquivo acima do teto e o CLAUDE.md que
esconde o AGENTS.md do Claude Code.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@4nrry
4nrry merged commit d123d2a into main Oct 14, 2026
1 of 2 checks passed
@4nrry
4nrry deleted the agents-md branch October 14, 2026 23:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant