adr-skill

ADRs created with this skill are executable specifications for coding agents. A human approves the decision; an agent implements it. The ADR must contain everything the agent needs to write correct code without asking follow-up questions.

When in doubt: if a future agent working in this codebase would benefit from knowing why this choice was made, write the ADR.

If you are an agent coding in a repo and you encounter any of these situations, stop and propose an ADR before continuing:

Создавайте и обслуживайте записи решений по архитектуре (ADR), оптимизированные для рабочих процессов агентного кодирования. Используйте, когда вам нужно предложить, написать, обновить, принять/отклонить, отменить или заменить ADR; загрузите папку и индекс adr; перед внесением изменений ознакомьтесь с существующими ADR; или обеспечить соблюдение конвенций ДОПОГ. Этот навык использует сократовские вопросы, чтобы уловить намерения перед составлением проекта, и проверяет результаты по контрольному списку готовности агента. Источник: joelhooks/joelclaw.