ORCH-078 — ORCH-52e: трассировка ORCH-NNN (стандарт маркеров + правило чтения ADR) #95

Merged

admin merged 7 commits from feature/ORCH-078-orch-52e-orch-nnn into main 2026-06-09 15:52:57 +03:00

Conversation 0 Commits 7 Files Changed 19 +1321 -4

admin commented 2026-06-09 15:39:01 +03:00

Owner

Copy Link

ORCH-078 — ORCH-52e: трассировка ORCH-NNN (стандарт маркеров + правило чтения ADR)

Слой 4 (трассировка) эпика ORCH-52, замыкающий цепочку 52b (структура) / 52c (frontmatter) / 52d (промпты).

Что сделано

• Новый нормативный стандарт docs/_standards/TRACEABILITY.md (рядом с PIPELINE_DOCS.md/HANDOFF_PROTOCOL.md): формат маркера ORCH-NNN, правило размещения (рядом с нетривиальным инвариантом), чтение истории с реальным проверяемым примером (src/serial_gate.py → ORCH-088 → ADR-001-serial-gate.md), fallback-доступ (git show origin/main:...), анти-археология (3+ маркеров → сводный сквозной ADR), каноничный текст правила чтения (единый источник).
• Точечные аддитивные врезки в 3 промпта (52d-канон не переписан): developer.md (правило чтения чужого маркера + fallback, «❌ X → ✅ Y»), architect.md (правило чтения + анти-археология), reviewer.md (усиление оси «Соответствие ADR» под-пунктом «слом маркированного инварианта → finding ≥P1»). Все три ссылаются на единый текст в TRACEABILITY.md, не копируют (анти-дубль BR-6).
• Сопутствующе: CLAUDE.md, docs/architecture/README.md (слой 4 эпика 52), CHANGELOG.md.
• Анти-регресс: расширен tests/test_agent_prompts_canon.py (9 новых проверок: наличие стандарта/примера/fallback/анти-археологии, правило в 3 промптах, ссылки в CLAUDE.md/README).

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

AC-1 (стандарт + реальный пример) · AC-2 (правило в developer/architect) · AC-3 (контроль в reviewer) · AC-4 (fallback) · AC-5 (анти-археология) · AC-6 (анти-дубль 52d) · AC-7 (код не изменён; регресс зелёный) · AC-8 (сопутствующая дока + ADR).

Гарантии (NFR)

• Docs + prompts-only: src/**, STAGE_TRANSITIONS, QG_CHECKS, check_*/_parse_*, src/frontmatter.py, схема БД — не тронуты; frontmatter_validation_strict остаётся False; новый QG не вводится; ретро-фит 51 маркера вне объёма.
• git diff --name-only origin/main — только docs/**, .openclaw/agents/*.md, tests/test_agent_prompts_canon.py, CLAUDE.md, CHANGELOG.md.
• Полный pytest tests/ -q — 1253 passed; machine-verdict ключи сохранены байт-в-байт; test_agent_frontmatter_no_model.py зелёный.
• Полностью обратимо git revert (нет машинного поведения/состояния/kill-switch).

Refs: ORCH-078

🤖 Generated with Claude Code

## ORCH-078 — ORCH-52e: трассировка `ORCH-NNN` (стандарт маркеров + правило чтения ADR) **Слой 4 (трассировка)** эпика ORCH-52, замыкающий цепочку 52b (структура) / 52c (frontmatter) / 52d (промпты). ### Что сделано - **Новый нормативный стандарт `docs/_standards/TRACEABILITY.md`** (рядом с `PIPELINE_DOCS.md`/`HANDOFF_PROTOCOL.md`): формат маркера `ORCH-NNN`, правило размещения (рядом с нетривиальным инвариантом), чтение истории с **реальным проверяемым примером** (`src/serial_gate.py` → ORCH-088 → `ADR-001-serial-gate.md`), fallback-доступ (`git show origin/main:...`), анти-археология (3+ маркеров → сводный сквозной ADR), каноничный текст правила чтения (единый источник). - **Точечные аддитивные врезки в 3 промпта** (52d-канон не переписан): `developer.md` (правило чтения чужого маркера + fallback, «❌ X → ✅ Y»), `architect.md` (правило чтения + анти-археология), `reviewer.md` (усиление оси «Соответствие ADR» под-пунктом «слом маркированного инварианта → finding ≥P1»). Все три **ссылаются** на единый текст в `TRACEABILITY.md`, не копируют (анти-дубль BR-6). - **Сопутствующе:** `CLAUDE.md`, `docs/architecture/README.md` (слой 4 эпика 52), `CHANGELOG.md`. - **Анти-регресс:** расширен `tests/test_agent_prompts_canon.py` (9 новых проверок: наличие стандарта/примера/fallback/анти-археологии, правило в 3 промптах, ссылки в CLAUDE.md/README). ### Соответствие AC AC-1 (стандарт + реальный пример) · AC-2 (правило в developer/architect) · AC-3 (контроль в reviewer) · AC-4 (fallback) · AC-5 (анти-археология) · AC-6 (анти-дубль 52d) · AC-7 (код не изменён; регресс зелёный) · AC-8 (сопутствующая дока + ADR). ### Гарантии (NFR) - **Docs + prompts-only:** `src/**`, `STAGE_TRANSITIONS`, `QG_CHECKS`, `check_*`/`_parse_*`, `src/frontmatter.py`, схема БД — **не тронуты**; `frontmatter_validation_strict` остаётся `False`; новый QG не вводится; ретро-фит 51 маркера вне объёма. - `git diff --name-only origin/main` — только `docs/**`, `.openclaw/agents/*.md`, `tests/test_agent_prompts_canon.py`, `CLAUDE.md`, `CHANGELOG.md`. - Полный `pytest tests/ -q` — **1253 passed**; machine-verdict ключи сохранены байт-в-байт; `test_agent_frontmatter_no_model.py` зелёный. - Полностью обратимо `git revert` (нет машинного поведения/состояния/kill-switch). Refs: ORCH-078 🤖 Generated with [Claude Code](https://claude.com/claude-code)

admin added 6 commits 2026-06-09 15:48:45 +03:00

docs: init ORCH-078 business request 5349a41182

analyst(ET): auto-commit from analyst run_id=465 8064ae2c5d

architect(ET): auto-commit from architect run_id=466 14f037a8a9

docs(ORCH-078): ORCH-52e — стандарт трассировки ORCH-NNN + правило чтения ADR ... 572b3172cd

Слой 4 (трассировка) эпика ORCH-52, замыкающий цепочку 52b/52c/52d.
Docs + prompts-only: src/**, STAGE_TRANSITIONS, QG_CHECKS, src/frontmatter.py,
схема БД — не тронуты; новый QG не вводится; ретро-фит 51 маркера вне объёма.

- Новый нормативный стандарт docs/_standards/TRACEABILITY.md: формат маркера,
  правило размещения, чтение истории с реальным проверяемым примером
  (src/serial_gate.py → ORCH-088 → ADR-001-serial-gate.md), fallback-доступ
  (git show origin/main:...), анти-археология (3+ → сводный сквозной ADR),
  каноничный текст правила чтения (единый источник).
- Точечные аддитивные врезки в промпты (52d-канон не переписан): developer.md
  (правило чтения чужого маркера + fallback, «❌ X → ✅ Y»), architect.md
  (правило чтения + анти-археология), reviewer.md (усиление оси «Соответствие
  ADR» под-пунктом: слом маркированного инварианта → finding ≥P1). Все три
  ссылаются на единый текст в TRACEABILITY.md, не копируют (анти-дубль BR-6).
- Сопутствующе: CLAUDE.md, docs/architecture/README.md (слой 4 эпика 52),
  CHANGELOG.md.
- Анти-регресс: расширен tests/test_agent_prompts_canon.py (9 новых проверок);
  проверки 52d и test_agent_frontmatter_no_model.py зелёные;
  полный pytest tests/ -q зелёный (1253 passed), src/ не изменён.

Refs: ORCH-078

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

reviewer(ET): auto-commit from reviewer run_id=468 fb9c133ef9

tester(ET): auto-commit from tester run_id=469 da709895f9

admin force-pushed feature/ORCH-078-orch-52e-orch-nnn from 7f8d855e80 to da709895f9 2026-06-09 15:48:45 +03:00 Compare

admin merged commit 55ead46f13 into main 2026-06-09 15:52:57 +03:00

admin referenced this issue from a commit 2026-06-09 15:52:59 +03:00

Merge pull request 'ORCH-078 — ORCH-52e: трассировка ORCH-NNN (стандарт маркеров + правило чтения ADR)' (#95) from feature/ORCH-078-orch-52e-orch-nnn into main

Sign in to join this conversation.

Reviewers

No Reviewers

Labels

No items

No Label

Milestone

No items

No Milestone

Projects

Clear projects

No project

Assignees

Clear assignees

admin

No Assignees

1 Participants

Notifications

Subscribe

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: admin/orchestrator#95