specs/openspec/changes/archive/2026-08-26-harden-openspec-sdd-quality/tasks.md

1. Planning guardrails

• 1.1 [specs] Реализовать выбранный в Solution Assessment вариант native OpenSpec + thin project verifiers: извлечь или переиспользовать существующий разбор Delivery Map и добавить stage-aware verify-openspec-planning.sh без собственного workflow state
  • Covers: openspec-authority-and-lifecycle — Planning artifact проверяется до запроса approval
  • Verification: Запустить verifier последовательно на fixtures стадий Proposal, Delta Specs, Design и Tasks и подтвердить, что он применяет только доступные на каждой стадии checks.
• 1.2 [specs] Добавить positive и controlled-negative fixtures для proposal structure и capability set, malformed rollback decision, invalid или N/A delivery area, отсутствующей task metadata, неверной requirement reference и uncovered Requirement
  • Covers: openspec-authority-and-lifecycle — Planning artifact проверяется до запроса approval; multi-repository-delivery — Каждая задача объявляет единственную delivery area; multi-repository-delivery — Tasks трассируются к утверждённым требованиям; engineering-change-governance — Труднообратимое изменение имеет rollback contract
  • Verification: Запустить fixture suite и проверить успешный compliant case, ожидаемые non-zero exits и actionable сообщения для каждого representative failure.
• 1.3 [specs] Подключить planning verifier к workspace dispatcher до affected-area gates, сохранив явное различие между stage success, full-change validation и semantic approval
  • Covers: openspec-authority-and-lifecycle — Planning artifact проверяется до запроса approval
  • Verification: На incomplete disposable change проверить stage-only результат, а на полном change запустить dispatcher и подтвердить, что planning gate выполняется раньше repository gates.

2. Versioned agent projection

• 2.1 [specs] Импортировать project-owned commands и skills в canonical source tree specs/agent-projection/opencode, документировав границы projection и исключив package manifests, dependencies и machine-local state
  • Covers: openspec-authority-and-lifecycle — Project-owned agent workflow воспроизводим из versioned authority
  • Verification: Сравнить перечень canonical files с текущей project-owned root projection и подтвердить отсутствие package/runtime files в committed source tree.
• 2.2 [specs] Добавить explicit atomic sync для root .opencode с восстановлением pre-cutover state при ошибке и отдельный non-mutating exact-content verifier required file set
  • Covers: openspec-authority-and-lifecycle — Project-owned agent workflow воспроизводим из versioned authority
  • Verification: В disposable workspace проверить успешное восстановление projection из canonical source, обнаружение missing/content drift и отсутствие частично обновлённого output после искусственно сорванного sync.
• 2.3 [specs] Расширить authority fixtures проверками projection drift и generated version markers, получая expected version только из openspec/.cli-version
  • Covers: openspec-authority-and-lifecycle — Project-owned agent workflow воспроизводим из versioned authority; openspec-authority-and-lifecycle — OpenSpec tooling имеет проверяемый version contract
  • Verification: Запустить authority fixture suite для current contract, mismatched CLI/marker, missing projection и content drift; проверить отсутствие независимого literal 1.10.0 в normative scripts и fixtures.

3. Schema v2 and entrypoints

• 3.1 [specs] Повысить wealth-ledger-sdd до version 2 и перераспределить guidance по утверждённой owner matrix между schema instructions, templates и additive config без _rules.md, добавив stage validation, полный feedback path и компактные примеры сложных delta operations
  • Covers: openspec-authority-and-lifecycle — Изменение upstream artifact требует каскадной проверки; openspec-authority-and-lifecycle — Planning artifact проверяется до запроса approval
  • Verification: Выполнить openspec schema validate wealth-ledger-sdd --verbose из specs, получить instructions всех четырёх artifacts и проверить graph, русские explanations, exact English OpenSpec syntax и отсутствие дублирующих config rules.
• 3.2 [specs] Обновить Design template условным Rollback Contract, а Tasks template — checkbox owner [area] и обязательными Covers/Verification, сохранив minimal ADDED-first Spec template
  • Covers: multi-repository-delivery — Каждая задача объявляет единственную delivery area; multi-repository-delivery — Tasks трассируются к утверждённым требованиям; engineering-change-governance — Труднообратимое изменение имеет rollback contract
  • Verification: Сгенерировать disposable lifecycle по schema v2 и проверить template shape, required/N/A rollback cases, точные requirement references и отсутствие пустых delta sections.
• 3.3 [specs] Обновить canonical agent commands и skills: запускать version и доступные planning checks до approval, возвращать Apply feedback к раннему затронутому artifact и использовать canonical store; затем атомарно синхронизировать root projection
  • Covers: openspec-authority-and-lifecycle — Изменение upstream artifact требует каскадной проверки; openspec-authority-and-lifecycle — OpenSpec tooling имеет проверяемый version contract; openspec-authority-and-lifecycle — Project-owned agent workflow воспроизводим из versioned authority; openspec-authority-and-lifecycle — Planning artifact проверяется до запроса approval
  • Verification: Выполнить sync и non-mutating projection check, затем просмотреть instructions/entrypoints для Proposal, Specs, Design, Tasks и Apply и подтвердить fixed store, stage gate и feedback routing.
• 3.4 [specs] Проверить собственный tasks.md этого change новым v2 verifier и исправить только технические нарушения формата без изменения утверждённого scope
  • Covers: multi-repository-delivery — Каждая задача объявляет единственную delivery area; multi-repository-delivery — Tasks трассируются к утверждённым требованиям
  • Verification: Запустить planning verifier для harden-openspec-sdd-quality и подтвердить owners только affected areas, валидность всех references и покрытие каждого Delta Requirement.

4. Audit evidence and durable documentation

• 4.1 [docs] Перенести пять исходных model reports byte-for-byte в один dated snapshot set под docs/audits, добавить index с source list, checksums и external non-authority warning, обновить audits index и удалить unversioned sdd-audit только после проверки равенства
  • Covers: audit-remediation-workflow — Реестр remediation отделён от снимка аудита
  • Verification: Сверить для всех пяти файлов byte count и checksum source/destination до удаления source, затем проверить index links и ровно один versioned snapshot set.
• 4.2 [docs] Нормализовать все уникальные audit claims в live remediation registry с Audit IDs, всеми source references, доказательными dispositions и отдельными remediation statuses; связать confirmed scope с текущим active change и сохранить auth platform assessment следующим planned item без будущего terminal evidence
  • Covers: audit-remediation-workflow — Каждое audit claim получает доказательный disposition; audit-remediation-workflow — Реестр remediation отделён от снимка аудита
  • Verification: Сопоставить каждое claim пяти reports ровно одному Audit ID и проверить обязательные evidence/rationale/review trigger для соответствующего disposition и отсутствие дублирующего registry.
• 4.3 [docs] Обновить engineering governance, OpenSpec lifecycle guide, ADR 010 и связанные indexes до фактического v2 ownership, projection recovery, traceability, feedback, rollback и controlled-upgrade contract
  • Covers: openspec-authority-and-lifecycle — Изменение upstream artifact требует каскадной проверки; openspec-authority-and-lifecycle — OpenSpec tooling имеет проверяемый version contract; openspec-authority-and-lifecycle — Project-owned agent workflow воспроизводим из versioned authority; openspec-authority-and-lifecycle — Planning artifact проверяется до запроса approval; multi-repository-delivery — Каждая задача объявляет единственную delivery area; multi-repository-delivery — Tasks трассируются к утверждённым требованиям; engineering-change-governance — Труднообратимое изменение имеет rollback contract
  • Verification: Выполнить scoped review updated docs против поставленных scripts/schema и проверить local links и indexes без копирования planning artifacts в docs.

5. Delivery verification

• 5.1 [specs] Выполнить canonical specs gates и controlled-invalid fixture suites после интеграции schema, planning, projection и authority checks
  • Covers: N/A — задача агрегирует verification уже покрытых требований и не вводит самостоятельное spec-level behavior.
  • Verification: Запустить version preflight, planning/projection/authority fixture suites, schema validation, strict change validation, strict main-spec validation, authority verifier и git diff --check в specs.
• 5.2 [docs] Выполнить canonical docs gate и scoped проверку audit snapshot, checksums, registry completeness, indexes и local links
  • Covers: N/A — задача проверяет docs delivery уже покрытых audit requirements и не добавляет новое поведение.
  • Verification: Запустить npm run verify в docs и отдельно подтвердить affected local links, snapshot checksums и claim-to-Audit-ID coverage.
• 5.3 [workspace] Выполнить cross-area dispatcher для полного change без frontend/backend и runtime-openapi gates
  • Covers: N/A — workspace task оркестрирует canonical gates affected repositories и не заменяет repository-owned implementation.
  • Verification: Запустить bash specs/scripts/verify-workspace-change.sh harden-openspec-sdd-quality и подтвердить Delivery Map specs/docs=affected, frontend/backend=N/A и runtime-openapi=N/A.
• 5.4 [workspace] Провести semantic verification реализации против Proposal, всех 9 Delta Requirements и 28 Scenarios, Design и Tasks, затем independent read-only review без Critical или Important findings
  • Covers: N/A — terminal semantic и independent reviews проверяют change целиком, но не реализуют отдельный Requirement.
  • Verification: Сохранить наблюдаемое review evidence только после фактических запусков и устранить блокирующие findings до archive eligibility.