11 KiB
11 KiB
1. Контракт версии OpenSpec и проектная схема
- 1.1 Добавить точный контракт CLI
1.10.0и тонкий version preflight вspecs/openspecиspecs/scripts, вызывать его до project-owned операций со store и проверить реальный успешный случай1.10.0и контролируемый временный wrong-version failure без отдельного unit-test suite для скрипта. - 1.2 Создать native fork схемы
spec-drivenвspecs/openspec/schemas/wealth-ledger-sdd, изменить dependency graph наproposal → specs → design → tasks → applyи проверить успешныйopenspec schema validate wealth-ledger-sdd --verboseи project-local source вopenspec schema which wealth-ledger-sdd --json. - 1.3 Настроить templates и instructions
wealth-ledger-sdd, чтобы Proposal, Delta Specs, Design и Tasks сохраняли согласованные непересекающиеся роли, Design требовал Delivery Map четырёх областей и условный Solution Assessment, а Tasks применял risk-based testing и исключал observed evidence/archive bookkeeping; проверить принятие всех templates schema validator без нового обязательного артефакта. - 1.4 Выбрать
wealth-ledger-sdddefault-схемой вspecs/openspec/config.yaml, добавить только компактный workspace context и additive lifecycle rules и на disposable project-local change проверить последовательную готовность артефактов, сохранив bootstrap changeharden-agent-sdd-governanceнаspec-driven.
2. OpenSpec authority и workspace orchestration
- 2.1 Перегенерировать OpenSpec 1.10 agent entrypoints в isolated staging, перенести upstream delta в корневую
.opencodeprojection, повторно наложить только fixedwealth-ledger-specs, one-artifact-at-a-time и hard archive-blocker overlays и проверить, что второй workspaceopenspecroot не создан, а каждый generated entrypoint указывает OpenSpec 1.10. - 2.2 Расширить
specs/scripts/verify-openspec-authority.shи существующие hard-guardrail fixtures, чтобы отклонять неверный CLI/schema contract, implicit или conditional store selection, непоследовательный artifact graph, permissive archive и competing planning root при сохранении валидного projection case; проверитьbash specs/scripts/verify-openspec-authority.test.sh. - 2.3 Добавить non-mutating workspace dispatcher в
specs/scripts: принимать canonical change, проверять решения для frontend, backend, specs и docs, всегда запускать specs gates, делегировать только affected repository gates и условно добавлять runtime OpenAPI comparison; проверить выбор всех четырёх областей этого change и отказ для disposable неполного Delivery Map без постоянного unit test оркестрационного скрипта. - 2.4 Обновить project-owned semantic verification и archive entrypoints: требовать завершённые affected-area gates, semantic verification и independent read-only review без confirmation override; проверить, что authority fixture отклоняет репрезентативные варианты с отсутствующей verification и разрешённым override.
3. Канонический локальный gate frontend
- 3.1 Добавить тонкий Node runtime preflight frontend из
engines/.nvmrc, поставить его первым в canonicalnpm run verifyи проверить успешный запуск под Node 22 и остановку до application checks под контролируемым неподдерживаемым Node без отдельного unit test. - 3.2 Удалить повторный вызов
test:runиз composite verifier frontend, сохранив один coverage-backed запуск Vitest и все OpenAPI, hygiene, type, Biome, Knip, dependency, build, bundle и coverage ratchets; проверить по полному выводуnpm run verifyодин запуск Vitest suite и выполнение всех обязательных stages. - 3.3 Согласовать
frontend/README.mdиfrontend/docs/TESTING.mdс canonical gate и risk-based выбором тестов, сохранить существующие hard-guardrail fixtures и обозначить coverage как anti-regression constraint, а не причину тестировать декларативные файлы; проверить разрешение задокументированных команд и ссылок из frontend repository.
4. Канонический локальный gate backend
- 4.1 Добавить тонкий Node runtime preflight backend из
engines/.nvmrc, поставить его первым в новом canonical verification entrypoint и проверить успешный запуск под Node 22 и остановку до application checks под контролируемым неподдерживаемым Node без отдельного unit test. - 4.2 Добавить backend
npm run verifyкак fail-fast non-mutating chain для runtime, hygiene, lint, application/test typechecks, Jest и build, явно исключив deferred Prisma e2e и новый global coverage threshold; проверить полный gate под Node 22 и ненулевой общий результат при контролируемом failure одного child stage. - 4.3 Обновить
backend/README.mdиdocs/development/backend-workflow.md, обозначив толькоnpm run verifycompletion gate, оставивlint:fix, coverage и deferred e2e отдельными, и проверить соответствие документированных командbackend/package.jsonпри сохранённом WL-P2-05 review trigger.
5. Docs-as-code и устойчивая governance-документация
- 5.1 Добавить Node 22 lockfile-backed toolchain docs с
markdownlint-cli2, отключить в committed configuration только MD013, предоставить один non-mutatingnpm run verifyи проверитьnpm ciи полный docs gate на текущем Markdown baseline без auto-fix и network/browser link checking. - 5.2 Создать authoritative development policy для Change Owner, artifact approvals, Delivery Map, Completion Evidence, Enforceable Engineering Invariant, risk-based testing, build-vs-buy Solution Assessment и SSOT boundaries; добавить ссылку в
docs/development/README.md, привестиdocs/development/openspec-authority-and-lifecycle.mdк as-built custom-schema workflow без копирования schema instructions и проверить разрешение всех local links. - 5.3 Добавить ADR 010 о native OpenSpec schema и минимальной local orchestration, проиндексировать его в
docs/adr/README.mdи проверить, что ADR фиксирует alternatives, consequences и reconsideration triggers без пересказа requirements change. - 5.4 Создать immutable
docs/audits/audit-24-08-2026.md, добавить его вdocs/audits/README.md, расширить единый live remediation registry на все audit snapshots, сделатьharden-agent-sdd-governanceединственным active remediation change и перевести WL-P3-04 вdeferredс accessibility trigger; проверить разрешение каждого Audit ID в один snapshot и не более одной active записи. - 5.5 Исправить подтверждённые current-state contradictions исторических A-15 и A-18 в authoritative ADR и основной spec
user-authentication, не редактируя immutable audit snapshots; проверить разрешение implementation-status links ADR и успешную strict validation всех основных specs.
6. Слоистые agent instructions и onboarding
- 6.1 Переписать слои корневого, frontend, backend, specs и docs
AGENTS.md: оставить в корне только workspace-wide SSOT/lifecycle constraints, а в каждом репозитории — canonical gate, enforceable style/boundary sources, маршруты к durable docs и audit registry, явный--store wealth-ledger-specsи запрет parallel planning stores; проверить authority fixture и все repository-local link/path checks. - 6.2 Обновить onboarding references frontend, backend и specs на новую governance policy, custom schema и workspace dispatcher без копирования architecture или feature content в AGENTS/README; проверить, что читатель из каждого репозитория достигает canonical SDD authority, local gate и относящейся к области durable documentation.
7. Интегрированная pre-archive verification
- 7.1 Запустить workspace dispatcher для
harden-agent-sdd-governanceпод Node 22 и проверить успешные canonical results frontend, backend, specs и docs без fallback, auto-fix или запуска deferred e2e. - 7.2 Запустить
bash specs/scripts/verify-runtime-openapi.shпод Node 22 и проверить соответствие backend runtime contract committed OpenAPI snapshot frontend, поскольку обе contract sides входят в Delivery Map этого change. - 7.3 Запустить project-local schema validation, strict validation
harden-agent-sdd-governance, strict validation всех canonical specs, OpenSpec authority fixtures иgit diff --checkв каждом affected Git repository; проверить успешное завершение всех structural и repository hygiene gates. - 7.4 Выполнить semantic verification реализации против Proposal, всех 19 требований Delta Specs, Design и этого checklist, затем провести independent read-only standards/spec review и проверить отсутствие Critical и Important findings до запроса archive.