[P0] 01. Однозначно описать task-first режим и область применения SDD #1

Closed
opened 2026-09-13 15:32:26 +03:00 by codex-bot · 2 comments
Owner

Проблема

README уже говорит «OpenSpec применяется по явному запросу», AGENTS и AI_INDEX также исключают обязательный SDD для обычной задачи. Поэтому общего запрета работать без planning artifacts нет. Однако Purpose действующей lifecycle spec не повторяет условие входа в SDD, а config.yaml всё ещё утверждает, что verification выполняется «без CI», хотя CI frontend/backend/docs уже существует.

Что сделать

Уточнить текущие точки входа и область применения нормативных правил SDD; исправить устаревший факт о CI.

Критерии готовности

  • README, AGENTS, AI_INDEX и Purpose/применимость lifecycle spec одинаково объясняют: обычная работа идёт по задаче, строгий SDD — только по явному запросу.
  • Правила approval для явно начатого SDD сохранены; уточнение области применения не превращается в переписывание исторических process specs или archives.
  • В config.yaml нет утверждения об отсутствии CI; описание соответствует фактическому состоянию и не обещает ещё не поставленный specs CI.
  • Согласованность с ADR 012 проверена; исторические ADR не переписаны под текущую редакцию.
  • Проверены ссылки, diff и применимая native validation при изменении current spec.

Основание

Сверка 14.09.2026: README, AGENTS, AI_INDEX, config, lifecycle spec.
Файл docs/development/openspec-authority-and-lifecycle.md отсутствует: создавать его заново ради этой задачи не нужно.

## Проблема README уже говорит «OpenSpec применяется по явному запросу», AGENTS и AI_INDEX также исключают обязательный SDD для обычной задачи. Поэтому общего запрета работать без planning artifacts нет. Однако Purpose действующей lifecycle spec не повторяет условие входа в SDD, а config.yaml всё ещё утверждает, что verification выполняется «без CI», хотя CI frontend/backend/docs уже существует. ## Что сделать Уточнить текущие точки входа и область применения нормативных правил SDD; исправить устаревший факт о CI. ## Критерии готовности - [ ] README, AGENTS, AI_INDEX и Purpose/применимость lifecycle spec одинаково объясняют: обычная работа идёт по задаче, строгий SDD — только по явному запросу. - [ ] Правила approval для явно начатого SDD сохранены; уточнение области применения не превращается в переписывание исторических process specs или archives. - [ ] В config.yaml нет утверждения об отсутствии CI; описание соответствует фактическому состоянию и не обещает ещё не поставленный specs CI. - [ ] Согласованность с ADR 012 проверена; исторические ADR не переписаны под текущую редакцию. - [ ] Проверены ссылки, diff и применимая native validation при изменении current spec. ## Основание Сверка 14.09.2026: [README](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/50658ea8be85568995cc2b71568f9779452424b6/README.md), [AGENTS](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/50658ea8be85568995cc2b71568f9779452424b6/AGENTS.md), [AI_INDEX](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/50658ea8be85568995cc2b71568f9779452424b6/AI_INDEX.md), [config](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/50658ea8be85568995cc2b71568f9779452424b6/openspec/config.yaml), [lifecycle spec](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/50658ea8be85568995cc2b71568f9779452424b6/openspec/specs/openspec-authority-and-lifecycle/spec.md). Файл docs/development/openspec-authority-and-lifecycle.md отсутствует: создавать его заново ради этой задачи не нужно.
codex-bot changed title from [P0] 01. Уточнить действующий процесс в Specs README to [P0] 01. Однозначно описать task-first режим и область применения SDD 2026-09-14 06:11:32 +03:00
ksv741 was assigned by codex-bot 2026-09-14 06:11:32 +03:00
codex-bot added the Kind/Documentation
Priority
High
2
Reviewed
Confirmed
1
labels 2026-09-14 06:12:46 +03:00
Author
Owner

[Process] Audit supplement — task-first/documentation authority

Исходное user-authored решение и assignee сохраняются; audit priority P2 отражает нынешний scope, исторический P0 в title не изменяется.

Problem

Canonical project-documentation требует docs/features/audit snapshots/remediation registry, current docs AGENTS запрещает research reports и использует thematic pages. Foundation/remediation process requirements также конкурируют с explicit opt-in обычной разработки. Это продолжение existing applicability task, не новый SDD workflow.

Expected Behavior

Одна согласованная current authority различает обычную task-first работу и явно выбранный SDD; документационный outcome достигается существующими thematic owners.

Evidence

Audit date 2026-10-11; 15, Complexity. IDs SPEC-001, CA-H20 (normative arm). Revision fcdc805f6c1b3be6a20a7e858e3e80cbd83a9121; docs e6fd4f64b81dd73b33959b845a1babcfac1891c8; Confidence High; Verification status static.
Affected: project-documentation/spec.md:47–108, :141–189; project-foundation:9–19; audit-remediation-workflow:9–49; docs AGENTS:3–14/CONTRIBUTING:19–26,81–99.

Scope

In scope

Engineering Owner согласует applicability/placement delta в existing current norms; root dated archive здесь — explicit campaign exception/location.

Out of scope

Standard OpenSpec skills, исторические archives/ADR, новые docs trees/registry/approval infrastructure, новый change на каждый Issue.

Proposed Approach

Убрать stale path prescriptions, сохранить discoverable thematic explanation, rationale по значимому decision, completion/independent review evidence. Process scope не расширять автоматически.

Acceptance Criteria

  • README/AGENTS/index/current norms одинаково описывают opt-in и documentation owner.
  • Current norms не требуют конкурирующие docs/features/audit registry; this root archive допустим явно.
  • Screener Docs Impact и banking thematic page удовлетворяют observable docs outcomes без placeholder trees.
  • SDD approval/native phases/completion evidence сохранены; исходные criteria этой Issue остаются проверяемыми.

Verification

Semantic cross-authority review, applicable native spec validation и docs links при affected text change; no application build/tests.

Dependencies

Named Engineering Owner decision по normative scope; generic skill applicability — main #24 независимая coordination task.

Traceability

Campaign WealthLedger/main#23 . Findings SPEC-001, CA-H20. WealthLedger/specs; T29.

<!-- wealthledger-audit:2026-10-11:documentation-authority --> # [Process] Audit supplement — task-first/documentation authority Исходное user-authored решение и assignee сохраняются; audit priority P2 отражает нынешний scope, исторический P0 в title не изменяется. ## Problem Canonical project-documentation требует docs/features/audit snapshots/remediation registry, current docs AGENTS запрещает research reports и использует thematic pages. Foundation/remediation process requirements также конкурируют с explicit opt-in обычной разработки. Это продолжение existing applicability task, не новый SDD workflow. ## Expected Behavior Одна согласованная current authority различает обычную task-first работу и явно выбранный SDD; документационный outcome достигается существующими thematic owners. ## Evidence Audit date `2026-10-11`; [15](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/d07fbfabb1295780952a554185989d2d5b5c8349/audits/2026-10-11/reports/15-sdd-specs-and-documentation.md), [Complexity](https://git.personal.ksv741.ru/WealthLedger/main/src/commit/d07fbfabb1295780952a554185989d2d5b5c8349/audits/2026-10-11/reports/previous/complexity-audit.md). IDs SPEC-001, CA-H20 (normative arm). Revision `fcdc805f6c1b3be6a20a7e858e3e80cbd83a9121`; docs `e6fd4f64b81dd73b33959b845a1babcfac1891c8`; Confidence High; Verification status static. Affected: [project-documentation/spec.md:47–108](https://git.personal.ksv741.ru/WealthLedger/specs/src/commit/fcdc805f6c1b3be6a20a7e858e3e80cbd83a9121/openspec/specs/project-documentation/spec.md#L47-L108), :141–189; project-foundation:9–19; audit-remediation-workflow:9–49; docs AGENTS:3–14/CONTRIBUTING:19–26,81–99. ## Scope ### In scope Engineering Owner согласует applicability/placement delta в existing current norms; root dated archive здесь — explicit campaign exception/location. ### Out of scope Standard OpenSpec skills, исторические archives/ADR, новые docs trees/registry/approval infrastructure, новый change на каждый Issue. ## Proposed Approach Убрать stale path prescriptions, сохранить discoverable thematic explanation, rationale по значимому decision, completion/independent review evidence. Process scope не расширять автоматически. ## Acceptance Criteria - [ ] README/AGENTS/index/current norms одинаково описывают opt-in и documentation owner. - [ ] Current norms не требуют конкурирующие docs/features/audit registry; this root archive допустим явно. - [ ] Screener Docs Impact и banking thematic page удовлетворяют observable docs outcomes без placeholder trees. - [ ] SDD approval/native phases/completion evidence сохранены; исходные criteria этой Issue остаются проверяемыми. ## Verification Semantic cross-authority review, applicable native spec validation и docs links при affected text change; no application build/tests. ## Dependencies Named Engineering Owner decision по normative scope; generic skill applicability — main #24 независимая coordination task. ## Traceability Campaign https://git.personal.ksv741.ru/WealthLedger/main/issues/23 . Findings SPEC-001, CA-H20. WealthLedger/specs; T29.
codex-bot added this to the Technical Audit Remediation — 2026-10-11 milestone 2026-10-11 21:54:44 +03:00
codex-bot added
Priority
Medium
3
audit/2026-10-11
and removed
Priority
High
2
labels 2026-10-11 21:55:07 +03:00
ksv741 was unassigned by hermes-agent 2026-10-12 00:04:36 +03:00
codex-bot was assigned by hermes-agent 2026-10-12 00:04:36 +03:00
hermes-agent added this to the WealthLedger — Delivery Board project 2026-10-12 00:04:36 +03:00
hermes-agent added Kind/Enhancement and removed Kind/Documentation labels 2026-10-12 00:04:36 +03:00
Author
Owner

Сделано в WealthLedger/specs#42 (merged в develop): условие «SDD только по явному запросу» добавлено в Purpose lifecycle spec. README, AGENTS, AI_INDEX уже были согласованы; config.yaml без утверждения про CI. openspec validate --specs: 32 passed.

Сделано в WealthLedger/specs#42 (merged в develop): условие «SDD только по явному запросу» добавлено в Purpose lifecycle spec. README, AGENTS, AI_INDEX уже были согласованы; config.yaml без утверждения про CI. `openspec validate --specs`: 32 passed.
Sign in to join this conversation.
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: WealthLedger/specs#1