ORCH-075 — ORCH-52b: стандарт документов (docs/_standards + docs/_templates + ADR-naming) #91

admin · 2026-06-09T13:17:12+03:00

admin commented

2026-06-09 13:17:12 +03:00

ORCH-075 — ORCH-52b: стандарт документов (docs/_standards + docs/_templates + ADR-naming)

Docs-only (слой 1 эпика ORCH-52). STAGE_TRANSITIONS / QG_CHECKS / check_* / src/stage_engine.py / схема БД — не трогаются (AC-6).

Что сделано

docs/_standards/PIPELINE_DOCS.md — манифест «стадия → агент → документ → категория → гейт/механизм → frontmatter machine-key», сверенный с src/stages.py (STAGE_TRANSITIONS) и src/qg/checks.py (_parse_*). Манифест документирует поведение гейтов (источник истины — код, ADR-001 §D2); различает machine-verdict доки (12/13/14/15/17) и информационные (00/08/10/16); под-гейты ребра deploy-staging→deploy отмечены как врезки в advance_stage. Раздел ADR-naming.
docs/_templates/* — 15 копируемых скелетов; машинные доки несут точный frontmatter-ключ из ground-truth (verdict/result/deploy_status/staging_status/security_status/post_deploy_status).
Точки-ссылки: CLAUDE.md, docs/architecture/README.md; запись в CHANGELOG.md (## [Unreleased], тип docs).
Тесты: tests/test_orch_52b_docs_standard.py (TC-01…TC-20). Полный pytest tests/ — 1177 passed.

Соответствие AC

AC-1 (манифест покрывает весь набор), AC-2 (шаблоны + frontmatter + секции), AC-3 (ADR-naming), AC-4 (согласованность с эталонами/кодом), AC-5 (ссылки+CHANGELOG), AC-6 (код гейтов не изменён), AC-7 (machine-verdict vs информационные) — выполнены.

ADR: docs/work-items/ORCH-075/06-adr/ADR-001-pipeline-docs-standard.md, сквозной docs/architecture/adr/adr-0019-pipeline-docs-standard.md.

Refs: ORCH-075

🤖 Generated with Claude Code

## ORCH-075 — ORCH-52b: стандарт документов (docs/_standards + docs/_templates + ADR-naming) **Docs-only** (слой 1 эпика ORCH-52). `STAGE_TRANSITIONS` / `QG_CHECKS` / `check_*` / `src/stage_engine.py` / схема БД — **не трогаются** (AC-6). ### Что сделано - **`docs/_standards/PIPELINE_DOCS.md`** — манифест «стадия → агент → документ → категория → гейт/механизм → frontmatter machine-key», сверенный с `src/stages.py` (`STAGE_TRANSITIONS`) и `src/qg/checks.py` (`_parse_*`). Манифест документирует поведение гейтов (источник истины — код, ADR-001 §D2); различает machine-verdict доки (`12/13/14/15/17`) и информационные (`00/08/10/16`); под-гейты ребра `deploy-staging→deploy` отмечены как врезки в `advance_stage`. Раздел ADR-naming. - **`docs/_templates/*`** — 15 копируемых скелетов; машинные доки несут точный frontmatter-ключ из ground-truth (`verdict`/`result`/`deploy_status`/`staging_status`/`security_status`/`post_deploy_status`). - Точки-ссылки: `CLAUDE.md`, `docs/architecture/README.md`; запись в `CHANGELOG.md` (`## [Unreleased]`, тип `docs`). - Тесты: `tests/test_orch_52b_docs_standard.py` (TC-01…TC-20). Полный `pytest tests/` — **1177 passed**. ### Соответствие AC AC-1 (манифест покрывает весь набор), AC-2 (шаблоны + frontmatter + секции), AC-3 (ADR-naming), AC-4 (согласованность с эталонами/кодом), AC-5 (ссылки+CHANGELOG), AC-6 (код гейтов не изменён), AC-7 (machine-verdict vs информационные) — выполнены. ADR: `docs/work-items/ORCH-075/06-adr/ADR-001-pipeline-docs-standard.md`, сквозной `docs/architecture/adr/adr-0019-pipeline-docs-standard.md`. Refs: ORCH-075 🤖 Generated with [Claude Code](https://claude.com/claude-code)

admin added 6 commits 2026-06-09 13:25:41 +03:00

docs: init ORCH-075 business request 18e98945dd

analyst(ET): auto-commit from analyst run_id=447 6511ddadbb

architect(ET): auto-commit from architect run_id=448 3251c8c4ed

docs(standards): pipeline docs standard — manifest + templates + ADR-naming 5e60543232

Создан golden source структуры номерных документов work item (ORCH-52b, слой 1
эпика ORCH-52). Docs-only: STAGE_TRANSITIONS / QG_CHECKS / check_* / схема БД не
трогаются (AC-6).

- docs/_standards/PIPELINE_DOCS.md — манифест «стадия→агент→документ→категория→
  гейт→frontmatter machine-key» (сверен с src/stages.py и src/qg/checks.py) +
  раздел ADR-naming. Манифест документирует поведение гейтов, источник истины
  остаётся код (ADR-001 §D2); честно различает machine-verdict (12/13/14/15/17)
  и информационные (00/08/10/16) доки; под-гейты ребра deploy-staging→deploy
  отмечены как врезки в advance_stage.
- docs/_templates/* — 15 копируемых скелетов; машинные доки несут точный
  frontmatter-ключ из _parse_* (verdict/result/deploy_status/staging_status/
  security_status/post_deploy_status).
- Точки-ссылки: CLAUDE.md, docs/architecture/README.md; запись CHANGELOG.
- tests/test_orch_52b_docs_standard.py — TC-01..TC-20 структурные проверки;
  полный pytest tests/ зелёный (1177 passed).

Refs: ORCH-075

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

reviewer(ET): auto-commit from reviewer run_id=450 138092e040

tester(ET): auto-commit from tester run_id=451

CI / test (push) Successful in 36s

Details

CI / test (pull_request) Successful in 32s

Details

119b8f2bec

admin force-pushed feature/ORCH-075-orch-52b-docs-templates-adr-na from 9dc620ca9b to 119b8f2bec

2026-06-09 13:25:41 +03:00

Compare

admin merged commit 03c6f2a145 into main

2026-06-09 13:31:18 +03:00

admin referenced this issue from a commit

2026-06-09 13:31:19 +03:00

Merge pull request 'ORCH-075 — ORCH-52b: стандарт документов (docs/_standards + docs/_templates + ADR-naming)' (#91) from feature/ORCH-075-orch-52b-docs-templates-adr-na into main

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: admin/orchestrator#91