docs: add .scratch/ workflow and sub-agent delegation policies

- Зачем:
  - зафиксировать правила работы с .scratch/ (рабочая зона) и делегирования субагентов.
- Что:
  - описано, что .scratch/ коммитится, но не попадает в master.
  - добавлена процедура слияния фиче-ветки (git rm .scratch + --no-ff).
  - описаны принципы делегирования объёмной и механической работы субагентам.
- Проверка:
  - cat AGENTS.md
This commit is contained in:
ddadmin committed 2026-07-20 04:27:56 -04:00
1 parent e048d79d46
commit f2d303c233
1 file changed
+19
+19
View File
@@ -84,3 +84,22 @@ This repository contains personal dotfiles and configurations for a highly produ
### Handoffs
Записки для продолжения работы в новой сессии — `.scratch/handoffs/YYYYMMDD-HHMM-<slug>.md` (одноразовые, коммитятся, уборка best-effort; скилл `/handoff` пишет сюда).
### `.scratch/` — рабочая зона; в master не переносится
Весь `.scratch/` — заметки по ходу дела: handoffs, PRD фич, нарезка задач. Коммитится (не в `.gitignore`), чтобы версионировать и передавать между сессиями, но в master ей делать нечего — это процесс, а не продукт.
Долговечное знание держим **вне** `.scratch/` (в `docs/`, `CONTEXT.md`). Прежде чем сливать фиче-ветку, убедись, что долговечная часть уже вынесена туда.
Слияние фиче-ветки в master:
1. Последним коммитом ветки — `git rm -r .scratch` (`chore: убрать рабочие заметки перед слиянием в master`).
2. `git merge --no-ff` в master.
`--no-ff` тянет все коммиты ветки в историю master, поэтому удалённый `.scratch/` остаётся достижим из merge-коммита и достаётся из истории в любой момент. Ничего не теряется — тег или архив не нужны.
## Субагенты и экономия контекста
Объёмную и механическую работу делегируем субагентам (Sonnet или аналогичная, в зависимости от сложности задачи), чтобы не засорять контекст основной сессии: проверки (реперы/линт/валидация), пакетные и файловые операции, отладка и прочее. Субагент сам читает «шумный» ввод-вывод и возвращает только результат.
- Мелочь делегировать не стоит — кроме случая, когда она даёт объёмный вывод: пусть субагент прочитает его у себя и вернёт выжимку.