docs(phase29ai): add P2 SSOT registry + freeze taxonomy

This commit is contained in:
2025-12-29 07:07:39 +09:00
parent 3e13d16a00
commit 07529d3826
4 changed files with 121 additions and 0 deletions

View File

@ -0,0 +1,49 @@
# Phase 29ai P2: SSOT Registry + Freeze Taxonomy (docs-only) — Instructions
Status: Ready for execution
Scope: docs-first仕様不変
## Goal
Phase 29ai の “single-planner” を長期で壊れない形にするために、SSOT真実の所在と FreezeFail-Fastの分類規約を
1枚に固定する。
## Non-goals
- コード変更docs-only
- 既存エラー文言の変更
- 新しいトグル/環境変数の追加
## Deliverables
1) SSOT Registry真実の所在の表を追加
- 新規: `docs/development/current/main/design/planfrag-ssot-registry.md`
- 最低限含める項目(列):
- LayerFacts / Normalize / Planner / Plan / Emit / Frag
- SSOT真実: どのデータが唯一の根拠か
- Forbidden禁止: その層が“覗いてはいけない”もの(再解析/再推論など)
- Verification検証: 破れたらどこで Fail-Fast するかstrict/dev の扱いも)
2) Freeze taxonomy分類を SSOT 化
- 新規: `docs/development/current/main/design/planfrag-freeze-taxonomy.md`
- 最低限のタグ(推奨):
- `plan/freeze:contract`(契約違反・形が崩れている)
- `plan/freeze:ambiguous`(複数解釈で一意化できない)
- `plan/freeze:unsupported`(対象だが未対応、将来対応予定)
- `plan/freeze:bug`(不変条件が壊れている/到達してはいけない状態)
- `Ok(None)``Err(Freeze)` の境界を例つきで固定する
3) Phase 29ai README を更新P2 のリンク追加)
## References (SSOT)
- Plan/Frag の設計入口: `docs/development/current/main/design/edgecfg-fragments.md`
- Pattern6/7 契約: `docs/development/current/main/design/pattern6-7-contracts.md`
- Phase 29ai 入口: `docs/development/current/main/phases/phase-29ai/README.md`
- Phase 29ai P1Freeze/候補集合のコード側規約): `docs/development/current/main/phases/phase-29ai/P1-PLANNER-CANDIDATES-FREEZE-SSOT-INSTRUCTIONS.md`
## Acceptance Criteria
- docs-only 変更であること(ビルド不要だが、`./tools/smokes/v2/run.sh --profile quick` が緑を維持)
- 新規2文書が “入口SSOTとして参照される前提” で読める(表 + 例 + 禁止事項が明確)

View File

@ -12,6 +12,11 @@ Goal: pattern 名による分岐を外部APIから消し、Facts事実
- 指示書: `docs/development/current/main/phases/phase-29ai/P1-PLANNER-CANDIDATES-FREEZE-SSOT-INSTRUCTIONS.md`
- ねらい: `Ok(None)` / `Err(Freeze)` の境界と “候補集合→一意化” をSSOT化未接続のまま、仕様不変
## P2: SSOT Registry + Freeze Taxonomydocs-only
- 指示書: `docs/development/current/main/phases/phase-29ai/P2-SSOT-REGISTRY-FREEZE-TAXONOMY-INSTRUCTIONS.md`
- ねらい: “真実の所在” と Freeze 分類を1枚に固定して、後続実装の迷子を防ぐ仕様不変
## Verification (SSOT)
- `cargo build --release`