admin/wiki
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
Files
bbe903bcc77cf5e01b05fa2c19c0abe720488d5c
wiki/tasks/orchestrator/reports/dev-2026-06-05-orch9-docs-canon.md
Stream dedb8789de auto-sync: 2026-06-05 12:40:01
2026-06-05 12:40:01 +03:00

7.1 KiB
Raw Blame History

Dev Report: ORCH-9 — Документация орка по канону + промпты агентов + reviewer-gate

Дата: 2026-06-05 Статус: 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 на обновление доки

Сделано

  • Подключение к серверу (82.22.50.71), проверка архива
  • Создание ветки docs/ORCH-9-canon из свежего origin/main
  • Распаковка архива /tmp/orch_docs_canon.tgz
  • ЧАСТЬ A: размещение 8 файлов из архива
  • ЧАСТЬ A: git mv реструктуризация (operations/, history/)
  • ЧАСТЬ A: ARCHITECTURE.md → docs/architecture/internals.md (git mv, история сохранена)
  • ЧАСТЬ A: обновление internals.md — добавлен deploy-staging в цепочку стадий
  • ЧАСТЬ A: docs/architecture/README.md — добавлена ссылка на internals.md
  • ЧАСТЬ A: обновление корневого README.md (pipeline, таблица QG, docs/ структура, ссылки)
  • ЧАСТЬ A: проверка ссылок — 0 битых
  • ЧАСТЬ B: создан analyst.md (sonnet)
  • ЧАСТЬ B: создан architect.md (opus)
  • ЧАСТЬ B: создан developer.md (sonnet)
  • ЧАСТЬ B: создан reviewer.md (opus)
  • ЧАСТЬ B: создан tester.md (sonnet)
  • ЧАСТЬ B: дополнен deployer.md (frontmatter + ссылки CLAUDE.md/INFRA.md)
  • ЧАСТЬ C: reviewer-gate в reviewer.md — REQUEST_CHANGES при src/ без доки (P0)
  • git commit: docs(orchestrator): adopt enduro doc canon + CLAUDE.md + ADR (ORCH-9)
  • git push origin docs/ORCH-9-canon
  • 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 — admin/orchestrator#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. Ждёт ревью и мержа от Стрим.

Reference in New Issue View Git Blame Copy Permalink