auto-sync: 2026-06-05 12:40:01

tasks/orchestrator/reports/dev-2026-06-05-orch9-docs-canon.md

@@ -1,37 +1,130 @@
 # Dev Report: ORCH-9 — Документация орка по канону + промпты агентов + reviewer-gate
 Дата: 2026-06-05
-Статус: IN PROGRESS
+Статус: DONE
 
 ## Задача
 - Привести документацию репо orchestrator к канону enduro-trails
 - Разместить 8 файлов из готового архива /tmp/orch_docs_canon.tgz
 - Реструктурировать docs/ через git mv (история сохраняется)
 - Добавить промпты агентов: analyst, architect, developer, reviewer, tester
+- Дополнить deployer.md ссылками на CLAUDE.md/INFRA.md
 - Прописать reviewer-gate на обновление доки
 
 ## Сделано
-- [ ] Подключение к серверу, проверка архива
-- [ ] Создание ветки docs/ORCH-9-canon
-- [ ] Распаковка архива
-- [ ] ЧАСТЬ A: размещение 8 файлов
-- [ ] ЧАСТЬ A: git mv реструктуризация
-- [ ] ЧАСТЬ A: ARCHITECTURE.md → internals.md
-- [ ] ЧАСТЬ A: обновление README.md
-- [ ] ЧАСТЬ A: проверка ссылок
-- [ ] ЧАСТЬ B: промпты агентов
-- [ ] ЧАСТЬ C: reviewer-gate в reviewer.md
-- [ ] git commit docs
-- [ ] git commit agents
-- [ ] PR создан
+- [x] Подключение к серверу (82.22.50.71), проверка архива
+- [x] Создание ветки docs/ORCH-9-canon из свежего origin/main
+- [x] Распаковка архива /tmp/orch_docs_canon.tgz
+- [x] ЧАСТЬ A: размещение 8 файлов из архива
+- [x] ЧАСТЬ A: git mv реструктуризация (operations/, history/)
+- [x] ЧАСТЬ A: ARCHITECTURE.md → docs/architecture/internals.md (git mv, история сохранена)
+- [x] ЧАСТЬ A: обновление internals.md — добавлен deploy-staging в цепочку стадий
+- [x] ЧАСТЬ A: docs/architecture/README.md — добавлена ссылка на internals.md
+- [x] ЧАСТЬ A: обновление корневого README.md (pipeline, таблица QG, docs/ структура, ссылки)
+- [x] ЧАСТЬ A: проверка ссылок — 0 битых
+- [x] ЧАСТЬ B: создан analyst.md (sonnet)
+- [x] ЧАСТЬ B: создан architect.md (opus)
+- [x] ЧАСТЬ B: создан developer.md (sonnet)
+- [x] ЧАСТЬ B: создан reviewer.md (opus)
+- [x] ЧАСТЬ B: создан tester.md (sonnet)
+- [x] ЧАСТЬ B: дополнен deployer.md (frontmatter + ссылки CLAUDE.md/INFRA.md)
+- [x] ЧАСТЬ C: reviewer-gate в reviewer.md — REQUEST_CHANGES при src/ без доки (P0)
+- [x] git commit: docs(orchestrator): adopt enduro doc canon + CLAUDE.md + ADR (ORCH-9)
+- [x] git push origin docs/ORCH-9-canon
+- [x] PR #32 создан
 
 ## Изменённые файлы
-(заполнится по ходу)
+
+### Новые файлы (из архива)
+- `CLAUDE.md` — паспорт проекта
+- `CHANGELOG.md` — журнал изменений
+- `docs/architecture/README.md` — архитектурный обзор
+- `docs/architecture/adr/README.md` — реестр ADR
+- `docs/architecture/adr/adr-0001-multi-repo-registry.md`
+- `docs/architecture/adr/adr-0002-job-queue.md`
+- `docs/architecture/adr/adr-0003-staging-gate.md`
+- `docs/operations/INFRA.md` — топология, self-hosting риски
+
+### git mv (история сохранена)
+- `docs/ARCHITECTURE.md` → `docs/architecture/internals.md`
+- `docs/DEPLOY_HOOK.md` → `docs/operations/DEPLOY_HOOK.md`
+- `docs/STAGING.md` → `docs/operations/STAGING.md`
+- `docs/STAGING_CHECK.md` → `docs/operations/STAGING_CHECK.md`
+- `docs/SETUP_WEBHOOKS.md` → `docs/operations/SETUP_WEBHOOKS.md`
+- `docs/BUGFIXES_2026-05-21.md` → `docs/history/`
+- `docs/BUGFIXES_2026-06-02.md` → `docs/history/`
+- `docs/BUGFIXES_2026-06-02_ORCH2.md` → `docs/history/`
+- `docs/BUGFIXES_2026-06-03.md` → `docs/history/`
+- `docs/LESSONS_ET006.md` → `docs/history/`
+- `docs/INCIDENT_2026-06-02_webhook_autorun.txt` → `docs/history/`
+- `docs/BACKLOG_PIPELINE.md` → `docs/history/`
+- `docs/ORCH-1_JOB_QUEUE.md` → `docs/history/`
+
+### Обновлённые файлы
+- `README.md` — pipeline с deploy-staging, таблица QG, структура docs/, ссылки на CLAUDE.md
+- `docs/architecture/internals.md` — цепочка стадий добавлен deploy-staging гейт
+- `docs/architecture/README.md` — ссылка на internals.md
+
+### Новые промпты агентов
+- `.openclaw/agents/analyst.md` — sonnet, артефакты 01-04, Write tool обязателен
+- `.openclaw/agents/architect.md` — opus, ADR per-work-item и глобальные, self-hosting риск
+- `.openclaw/agents/developer.md` — sonnet, TDD, документация в том же PR, self-hosting риск
+- `.openclaw/agents/reviewer.md` — opus, reviewer-gate, REQUEST_CHANGES при src/ без доки
+- `.openclaw/agents/tester.md` — sonnet, pytest, smoke API, result: PASS/FAIL frontmatter
+- `.openclaw/agents/deployer.md` — дополнен frontmatter + ссылки CLAUDE.md/INFRA.md
 
 ## Результат
-(заполнится в конце)
+
+### Структура docs/ после реструктуризации
+```
+CHANGELOG.md
+CLAUDE.md
+docs/PRODUCT_VISION.md
+docs/PRODUCT_VISION.pptx
+docs/architecture/README.md
+docs/architecture/adr/README.md
+docs/architecture/adr/adr-0001-multi-repo-registry.md
+docs/architecture/adr/adr-0002-job-queue.md
+docs/architecture/adr/adr-0003-staging-gate.md
+docs/architecture/internals.md
+docs/history/BACKLOG_PIPELINE.md
+docs/history/BUGFIXES_2026-05-21.md
+docs/history/BUGFIXES_2026-06-02.md
+docs/history/BUGFIXES_2026-06-02_ORCH2.md
+docs/history/BUGFIXES_2026-06-03.md
+docs/history/INCIDENT_2026-06-02_webhook_autorun.txt
+docs/history/LESSONS_ET006.md
+docs/history/ORCH-1_JOB_QUEUE.md
+docs/operations/DEPLOY_HOOK.md
+docs/operations/INFRA.md
+docs/operations/SETUP_WEBHOOKS.md
+docs/operations/STAGING.md
+docs/operations/STAGING_CHECK.md
+```
+
+### Проверки
+1. ✅ find docs CLAUDE.md CHANGELOG.md: структура канона на месте
+2. ✅ ls .openclaw/agents/: analyst architect deployer developer reviewer tester
+3. ✅ Битые ссылки: 0
+4. ✅ git log --follow docs/operations/DEPLOY_HOOK.md: история из a6cbacb сохранена
+5. ✅ README pipeline: `created → analysis → ... → deploy-staging → deploy → done`
+6. ✅ reviewer.md содержит 5 упоминаний REQUEST_CHANGES включая P0-правило
+7. ✅ git diff --name-status: только .openclaw/agents/, docs/, README.md, CLAUDE.md, CHANGELOG.md (НЕ src/tests/compose/.env/scripts)
+8. ✅ git log: коммит 7c68d1d после push
+
+### Коммиты
+- `7c68d1d` — `docs(orchestrator): adopt enduro doc canon + CLAUDE.md + ADR (ORCH-9)`
+
+### PR
+- **PR #32** — https://git.mva154.duckdns.org/admin/orchestrator/pulls/32
+- Ветка: `docs/ORCH-9-canon` → `main`
+- Статус: OPEN (не мержить!)
 
 ## Проблемы и решения
-(заполнится по ходу)
+
+1. **Многострочный sed** не работает — использовал Python для точечных замен
+2. **scp через sshpass** не работал (бинарь без нужных libs) — использовал `cat ... | ssh ... 'cat > ...'`
+3. **Случайный git add .** захватил runtime-файлы (.env.bak*, deploy-hook.log) — отстейджил через `git reset HEAD`
+4. **Агенты попали в первый коммит** вместо второго — в итоге один сводный коммит, что допустимо по ТЗ
 
 ## Следующий шаг
-Начало выполнения — подключение к серверу.
+Задача DONE. Ждёт ревью и мержа от Стрим.