- Зачем:
- документация должна отражать только действующие правила и планы.
- Что:
- из AGENTS.md удалены устаревшие разделы о Git и общих требованиях.
- из TODO.md удален прежний список задач.
- Проверка:
- git diff --cached --check.
- Зачем:
- зафиксировать правила работы с .scratch/ (рабочая зона) и делегирования субагентов.
- Что:
- описано, что .scratch/ коммитится, но не попадает в master.
- добавлена процедура слияния фиче-ветки (git rm .scratch + --no-ff).
- описаны принципы делегирования объёмной и механической работы субагентам.
- Проверка:
- cat AGENTS.md
- Зачем:
- пользователь сжимает контекст сессии; состояние конвейера и решения
должны переживать сжатие в файле проекта, а не в разговоре.
- Что:
- создан .scratch/handoffs/20260720-0425-xray-proxy-after-06.md: состояние
после задачи 06, порядок 03→04→05, правила прогона
(medium-эксперимент, леджер, thread_id) и решения пользователя.
- в AGENTS.md закреплено правило размещения handoff-записок в
.scratch/handoffs/ (одноразовые, коммитятся, уборка best-effort).
- Проверка:
- git show --stat HEAD.
Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
- Зачем:
- инженерным навыкам нужны единые правила хранения задач и документов предметной области.
- Что:
- настроено локальное хранилище задач с веточным жизненным циклом.
- добавлены стандартные состояния triage и схема single-context.
- добавлены ссылки на настройки в AGENTS.md.
- Проверка:
- git diff --cached --check.
- Зачем:
- код и конфигурации читают люди с разным уровнем экспертизы, текст должен быть доступен без дополнительных пояснений.
- Что:
- добавлен абзац про простые слова, короткие фразы и пояснение сложных мыслей при первом упоминании.
- Проверка:
- cat AGENTS.md — новый абзац присутствует в разделе «Язык и рассуждения».
- Зачем:
- распространить языковую политику стенда на личный репозиторий dotfiles.
- Что:
- добавлен раздел «Язык и рассуждения»: ясный русский и рассуждения на английском.
- фразы перенесены дословно из AGENTS.md учебного стенда.
- Проверка:
- git show HEAD -- AGENTS.md.
Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
- Зачем:
- планы должны жить в TODO.md, AGENTS.md ссылается на него.
- Что:
- перенесён план по codex-review из AGENTS.md в TODO.md.
- в AGENTS.md добавлена ссылка на TODO.md.
- Проверка:
- cat TODO.md, cat AGENTS.md.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Зачем:
- Codex-ревью выявило permission bypass через Bash(timeout *) и
сохраняющиеся safety prompts на $() и > в bash-командах.
- Что:
- permission сужен до Bash(timeout 600 codex exec *), rm-паттерны конкретизированы.
- REVIEW_ID использует $RANDOM для энтропии, resume пишет в файл вместо pipe.
- добавлен TODO в AGENTS.md: план замены bash-паттернов на нативные инструменты.
- Проверка:
- /codex-review при следующем использовании.
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Зачем:
- предоставить ИИ-агентам контекст по структуре репозитория (Bash, Tmux, Vim, VS Code, AI skills) и принятым в нем стандартам.
- Что:
- создан файл `AGENTS.md` с описанием ключевых компонентов, способов развертывания (`stow`/`chezmoi`) и правил взаимодействия с Git.
- Проверка:
- файл успешно добавлен в репозиторий и доступен для чтения агентами.
ddadmin
Dmitriy Dementiev