137 lines
5.8 KiB
YAML
137 lines
5.8 KiB
YAML
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
|