Files

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

Создан 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>

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

1.4 KiB

Raw Blame History

02 — ТЗ (TRZ): ORCH-NNN — <название>

Work Item: ORCH-NNN · Repo: · Стадия: analysis

ТЗ описывает конкретные изменения к реализации, выведенные из BRD и фактического кода. Архитектурное обоснование/решения — задача архитектора (06-adr).

1. Сводка изменения

<Что меняется, в одном-двух абзацах.>

2. Задействованные модули / пути

Путь	Действие
`src/<module>.py`	изменить / создать

3. Функциональные требования

FR-1 — <название>

<Поведение, контракт, инварианты. Привязать к BR.>

4. Изменения API

<Новые/изменённые эндпоинты; либо «Нет.».>

5. Изменения схемы БД

<Таблицы/миграции/индексы; либо «Нет.».>

6. Требования к новым/изменённым QG checks

<Изменения QG_CHECKS / check_*; либо «Нет.».>

7. Совместимость / регресс

<Обратная совместимость, kill-switch, область раската, обратимость.>

1.4 KiB Raw Blame History Unescape Escape