work_item: ORCH-075
title: "ORCH-52b — стандарт документов (docs/_standards + docs/_templates + ADR-naming)"
scope: "docs-only: проверяется НАЛИЧИЕ и СТРУКТУРА новых файлов-стандартов/шаблонов; код гейтов не трогается"
framework: pytest
notes: >
  Изменение документационное. Тесты — лёгкие структурные проверки (existence + наличие
  обязательных секций/frontmatter-ключей), новый файл tests/test_orch_52b_docs_standard.py.
  Тесты НЕ меняют QG_CHECKS/STAGE_TRANSITIONS и не вводят новый гейт (это ORCH-52c). Полный
  регресс tests/ должен остаться зелёным (отсутствие регресса от docs-изменения).

tests:
  - id: TC-01
    type: integration
    description: "docs/_standards/PIPELINE_DOCS.md существует и непустой"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-02
    type: integration
    description: "Манифест PIPELINE_DOCS.md упоминает все номерные доки набора: 00,01,02,03,04,06,07,08,10,12,13,14,15,16,17"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-03
    type: integration
    description: "Манифест указывает владельца-агента для каждого дока (analyst/architect/reviewer/tester/deployer/система упомянуты)"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-04
    type: integration
    description: "Манифест содержит категории required / when-applicable / optional"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-05
    type: integration
    description: "Каталог docs/_templates/ существует и содержит шаблоны для всех required/when-applicable доков"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-06
    type: integration
    description: "Шаблон 12-review содержит frontmatter-ключ verdict:"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-07
    type: integration
    description: "Шаблон 13-test-report содержит frontmatter-ключ result:"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-08
    type: integration
    description: "Шаблон 14-deploy-log содержит frontmatter-ключ deploy_status:"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-09
    type: integration
    description: "Шаблон 15-staging-log содержит frontmatter-ключ staging_status:"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-10
    type: integration
    description: "Шаблон 17-security-report содержит frontmatter-ключ security_status:"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-11
    type: integration
    description: "Шаблон 16-post-deploy-log содержит frontmatter-ключ post_deploy_status:"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-12
    type: integration
    description: "Шаблон 01-brd содержит обязательные секции: Бизнес-контекст, Объём, Бизнес-требования, NFR"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-13
    type: integration
    description: "Шаблон 02-trz содержит обязательные секции: Задействованные модули, Изменения API, Изменения схемы БД, QG checks"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-14
    type: integration
    description: "Шаблон 03-acceptance-criteria содержит блок AC-N с метками PASS и FAIL"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-15
    type: integration
    description: "Шаблон 04-test-plan.yaml — валидный YAML с ключами work_item и tests (список с id/type/description/module/expected)"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-16
    type: integration
    description: "Раздел ADR-naming присутствует и фиксирует формат ADR-NNN-<slug>.md с нумерацией с 001 и kebab-slug"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-17
    type: integration
    description: "ADR-naming в стандарте совпадает с реальными ADR в репо (напр. существует docs/work-items/ORCH-088/06-adr/ADR-001-*.md)"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-18
    type: integration
    description: "CLAUDE.md содержит ссылку на docs/_standards/PIPELINE_DOCS.md"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-19
    type: integration
    description: "docs/architecture/README.md содержит ссылку на стандарт документов"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-20
    type: integration
    description: "CHANGELOG.md содержит запись об ORCH-52b/ORCH-075 в разделе Unreleased"
    module: tests/test_orch_52b_docs_standard.py
    expected: PASS

  - id: TC-21
    type: integration
    description: "Регресс: полный прогон pytest tests/ зелёный (docs-изменение не ломает существующие тесты)"
    module: tests/
    expected: PASS
