documentation-and-adrs: como usar no seu projeto

Registre como o projeto funciona e por que uma decisão técnica foi tomada. ADR é um registro curto da decisão, contexto, alternativas e consequências.

Categoria: Documentação & Escrita · Repositório: addyosmani/agent-skills

Antes de começar

Abra o projeto no seu agente de programação e tenha uma tarefa delimitada. Leia o SKILL.md da fonte e confira dependências, scripts e acessos pedidos. Uma skill fornece instruções; o agente e suas ferramentas executam o trabalho.

Como instalar

Com Node.js e npm disponíveis, execute no terminal do projeto:

npx skills add addyosmani/agent-skills --skill documentation-and-adrs

Confira a skill e o agente na seleção do instalador. Se o nome não aparecer, consulte a fonte abaixo para verificar a organização atual do repositório. Passo a passo no Codex · Passo a passo no Cursor.

Exemplo de pedido

Adapte este exemplo ao seu projeto. É uma sugestão de uso, não um resultado de teste realizado pela TopSkills.

Crie um ADR sobre usar PostgreSQL no sistema de reservas. Compare duas alternativas com as restrições do projeto e explicite o que ainda é hipótese.

Como avaliar e quais são os limites

Peça a alguém da equipe que siga a documentação. Um documento útil precisa refletir o código atual e ser atualizado quando a decisão mudar.

Fonte e manutenção

Consultar a skill e suas instruções na fonte ↗. Referência consultada em 4 de setembro de 2026. O conteúdo e a instalação podem mudar com novas versões.

Continue nesta categoria

• github-issue-creator — Transforma anotações soltas, prints ou mensagens de erro em tarefas bem descritas no GitHub.
• prd-generator — Conversa com você e escreve um documento claro do que o produto precisa ter (um "PRD"), pronto pra equipe seguir.