writing-for-agents

Referência para escrever qualquer documento que um agent consome — uma skill, um AGENTS.md / CLAUDE.md, um doc alcançado por um pointer. O empacotamento difere; a escrita não: as mesmas alavancas tornam cada um previsível — o agent tomando o mesmo processo toda execução, não produzindo o mesmo output.

Quando o documento que você está escrevendo é uma skill, leia SKILL-MECHANICS.md para frontmatter, escolha de invocação e router skills.

Context pointers

Um context pointer é uma referência mantida no contexto do agent que nomeia algum material fora-de-contexto e codifica a condição para alcançá-lo. A description de uma skill é um; uma linha no AGENTS.md nomeando um doc é o mesmo objeto. A redação do pointer, não o seu alvo, decide quando o agent alcança o material — e com que confiabilidade. Um alvo must-have atrás de um pointer mal redigido é um bug de variância: afie a redação primeiro, e inline o material só se afiar falhar.

Um pointer faz dois trabalhos — dizer o que o material é, e listar os branches que deveriam disparar o alcance dele (um branch é um caso distinto que o documento trata, então execuções diferentes tomam caminhos diferentes por ele). Cada palavra de um pointer sempre-carregado custa a cada turno, então ele merece poda ainda mais dura do que o corpo:

• Front-load da leading word — o pointer é onde ela faz seu trabalho de disparo.
• Um trigger por branch. Sinônimos que renomeiam um único branch são um branch escrito duas vezes; colapse-os e mantenha só branches genuinamente distintos.
• Corte a identidade que o corpo já carrega.

As duas cargas

Todo documento e pointer que você adiciona gasta um de dois orçamentos: