Úselo al tomar decisiones arquitectónicas, cambiar API públicas, características de envío o cuando necesite registrar el contexto que los futuros ingenieros y agentes necesitarán para comprender el código base.
Instala rápidamente el skill de IA documentation-and-adrs en tu entorno de desarrollo mediante línea de comandos
Fuente: addyosmani/agent-skills.
Document decisions, not just code. The most valuable documentation captures the why — the context, constraints, and trade-offs that led to a decision. Code shows what was built; documentation explains why it was built this way and what alternatives were considered. This context is essential for future humans and agents working in the codebase.
When NOT to use: Don't document obvious code. Don't add comments that restate what the code already says. Don't write docs for throwaway prototypes.
ADRs capture the reasoning behind significant technical decisions. They're the highest-value documentation you can write.
Úselo al tomar decisiones arquitectónicas, cambiar API públicas, características de envío o cuando necesite registrar el contexto que los futuros ingenieros y agentes necesitarán para comprender el código base. Fuente: addyosmani/agent-skills.
Campos y comandos estables para citas de IA/búsqueda.
npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrsÚselo al tomar decisiones arquitectónicas, cambiar API públicas, características de envío o cuando necesite registrar el contexto que los futuros ingenieros y agentes necesitarán para comprender el código base. Fuente: addyosmani/agent-skills.
Abre tu terminal o herramienta de línea de comandos (Terminal, iTerm, Windows Terminal, etc.) Copia y ejecuta este comando: npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrs Una vez instalado, el skill se configurará automáticamente en tu entorno de programación con IA y estará listo para usar en Claude Code, Cursor u OpenClaw
https://github.com/addyosmani/agent-skills