claude-harness/docs/retro/2026-10-11-claude-md-addresses.md
Andrey Epifancev d2889483bc fix: правила для сабагентов, точные формулировки dev.md
Сабагенты не получают вывод /role, поэтому глобальный CLAUDE.md задаёт
для них правило и полный путь ~/.claude/roles/dev.md, а роль dev велит
передавать этот файл контроллеру SDD и ревьюеру ветки (I-1). Уточнены
формулировки про [claude-harness] (M-2) и allow-правило push --delete (M-3).

Refs #2

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01MzkPQWjfA7RpqYWkjnqJwt
2026-10-12 00:48:16 +04:00

5.0 KiB
Raw Blame History

Куда переехал глобальный CLAUDE.md (0.2.0 → 0.3.0)

Проверка критерия спеки «ни одно правило не потеряно». Старый файл — global/CLAUDE.md до коммита этой ветки (9155 Б).

Старый абзац (раздел → пункт) Новый адрес
Роли инструментов → superpowers ведёт процесс roles/dev.md → Процесс → Инструменты и их роли
Роли инструментов → Gitea, одна фича = одна issue, порядок старта roles/dev.md → Инструменты и их роли
Роли инструментов → OpenSpec roles/dev.md → Инструменты и их роли
Роли инструментов → Ledger superpowers roles/dev.md → Инструменты и их роли
Маршрутизация → сообщение [claude-harness], adopt-project.sh global/CLAUDE.md → Хуки и ветки (сообщение); roles/dev.md → Маршрутизация (скрипт)
Маршрутизация → bounded-задача roles/dev.md → Маршрутизация (дополнено: спека при смене API, verification-before-completion)
Маршрутизация → architectural-задача, спека в openspec/changes roles/dev.md → Маршрутизация
Маршрутизация → читать openspec/specs и ARCHITECTURE.md roles/dev.md → Маршрутизация
Маршрутизация → codegraph, projectPath, пустой ответ global/CLAUDE.md → Хуки и ветки (init, projectPath); roles/dev.md → Инструменты (implementer, пустой ответ, замер)
Исполнение → только в worktree, имя ветки roles/dev.md → Исполнение
Исполнение → SDD по умолчанию, контроллер на sonnet, executing-plans до 5 задач roles/dev.md → Исполнение (дополнено: режим не спрашивать)
Исполнение → модели исполнителей roles/dev.md → Исполнение
Завершение → finishing-a-development-branch, receiving-code-review, merge человеком roles/dev.md → Завершение
Завершение → чеклист закрытия п. 1 (архив в main) roles/dev.md → Завершение п. 1 — изменено: архив всегда отдельным PR (решение владельца 11.10.2026)
Завершение → чеклист п. 2–3 roles/dev.md → Завершение п. 2–3
Завершение → чеклист п. 4 (удаление веток) roles/dev.md → Завершение п. 4 — дополнено: из worktree, allow-правило
Завершение → чеклист п. 5–7 roles/dev.md → Завершение п. 5, 6, 8 (новый п. 7 — память, спека 7.1)
Завершение → неприменимое к bounded пропускается roles/dev.md → Завершение
Завершение → любой другой push в main только через PR roles/dev.md → Завершение п. 1 (без исключений)
Завершение → «Rulings I made» в PR roles/dev.md → Завершение
Завершение → Decisions made without discussion roles/dev.md → Завершение
Маркировка → список маркеров global/CLAUDE.md → Маркировка (кратко); roles/dev.md → Маркировка (полностью, + RT-n)
Маркировка → статусы находок global/CLAUDE.md → Маркировка; roles/dev.md → Маркировка
Маркировка → таблица в финальном отчёте, deferred в PR и follow-up roles/dev.md → Маркировка
Стиль → не сжимать, caveman по команде global/CLAUDE.md → Стиль

Правка финального ревью (I-1): в разделе «Роль» формулировка «Процесс и чеклисты роли — в её файле» сокращена до «Процесс роли — в ~/.claude/roles/<r>.md» (ради лимита 3 КБ), добавлено правило для сабагентов; ссылка «Подробности — в роли dev» стала полным путём.

Новое, чего не было: раздел «Роль» (спека 4), раздел «Память» (спека 7.1), запрет обхода хуков (ретро, feedback-no-harness-bypass), cd при фоновом контроллере (RT-2), абсолютные пути worktree, trailer коммита (RT-9), предусловия окружения (RT-8).