Используйте при принятии архитектурных решений, изменении общедоступных API, выпуске функций или когда вам нужно записать контекст, который понадобится будущим инженерам и агентам для понимания базы кода.
Быстро установите AI-навык documentation-and-adrs в вашу среду разработки через командную строку
Источник: 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.
Используйте при принятии архитектурных решений, изменении общедоступных API, выпуске функций или когда вам нужно записать контекст, который понадобится будущим инженерам и агентам для понимания базы кода. Источник: addyosmani/agent-skills.
Стабильные поля и команды для ссылок в AI/поиске.
npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrsИспользуйте при принятии архитектурных решений, изменении общедоступных API, выпуске функций или когда вам нужно записать контекст, который понадобится будущим инженерам и агентам для понимания базы кода. Источник: addyosmani/agent-skills.
Откройте терминал или инструмент командной строки (Terminal, iTerm, Windows Terminal и т.д.) Скопируйте и выполните эту команду: npx skills add https://github.com/addyosmani/agent-skills --skill documentation-and-adrs После установки навык будет автоматически настроен в вашей AI-среде разработки и готов к использованию в Claude Code, Cursor или OpenClaw
https://github.com/addyosmani/agent-skills