diff --git a/tasks/orchestrator/reports/dev-2026-06-05-orch9-docs-canon.md b/tasks/orchestrator/reports/dev-2026-06-05-orch9-docs-canon.md index c06f12e..a6206d7 100644 --- a/tasks/orchestrator/reports/dev-2026-06-05-orch9-docs-canon.md +++ b/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. Ждёт ревью и мержа от Стрим.