decision structure rename rationale

判断記録 artifact を「履歴 (Decision Log)」から「構造 (Decision Structure)」へ rename + 意味 shift

Question

判断記録の永続化アーティファクトを「履歴 (log/history)」として framing するか、「構造 (structure)」として framing するか。

Current resolution

「構造 (Decision Structure)」として framing する。docs/Decision-Log.md を docs/Decision-Structure.md に rename し、writer skill を evolution-decision-structure-write に rename し、entry shape ガイダンスを event 形 (YYYY-MM-DD: decided X for reason Y) から state 形 (Question Q: current resolution = X, supersedes <link>) に shift する。リネームと意味 shift は #1329 / PR (link TBD) で同一 PR にまとめる。

Edges

• supersedes: Decision Log layer 命名 (a-z prefix 採用) — 当初は時間順 + 順序 prefix の log framing で導入。本判断で「log」語彙そのものを置き換える。
• depends on: a-z prefix drop による free title 化 — 順序の暗黙構造を明示 index に移行した #1324。本判断はその延長で framing 自体を構造化する。
• depends on: AI 自律な判断記録 Wiki write surface の activate — Decision_Log_Write_Autonomy と evolution-decision-log-write skill を activate した PR。本判断はこの機構を破壊せず、命名と意味 framing のみ shift する。

背景

Master との対話で「判断履歴の WIKI 正直どう思う？」という問いから surface した観察:

• 「履歴」framing は時間順 append-only / event 形のエントリ shape を含意する。単調増加が「正しい」方向にバイアスされ、維持運用が「履歴を消す」心理的重みを帯びる。結果として S/N が時間とともに劣化する。
• 「構造」framing は state 形ノード + supersede / depend / conflict edge という意味グラフを含意する。volume は refine/replace で安定し、削除や統合は refactor (normal operation) として扱われる。
• #1324 が a-z prefix を drop して順序を明示 index に移行した方向と整合する。順序の暗黙構造 -> 明示構造、と並列に、framing も暗黙履歴 -> 明示構造として整列する。

制約

• 既存の wiki entry 本文は遡及書き換えしない。今回の意味 shift は forward guidance であり、今後の新規 entry に向けてのみ適用される。
• skill 命名は evolution-decision-structure-write (artifact-name 整合)。evolution-judgment-graph-* 系の第三語彙は意図的に却下した (vocabulary の発散を防ぐため、artifact 名と一致させる)。
• 読み手側 skill evolution-judgment-learning は名前を維持する。reader 側で「judgment learning」は意味的に正しく、命名 churn を増やす必要がない。
• リリース分類は patch (Master 判断による override、初期 minor 提案から訂正)。rules/operations/execution-mode.md Per-PR exception (content-based axis) に該当: 本変更は Li+ 内部 AI authoring surface (rules / skills / adapter / hooks / docs / wiki) のみで、外部 user / system に観測可能な挙動変更を伴わない。entry shape recommendation の shift は AI 内部 authoring guidance であり、外部 contract ではない (governance structure change + internal literal alignment)。major は phase transition / project milestone 用であり、本変更は phase transition ではない。

結論

採用案: option A (リネーム + 意味 shift を同一 PR で実施)

却下案 + 理由:

• option B (リネームのみ先行、意味 shift は別 PR) — リネームだけだと frame mismatch を温存したまま命名が変わり、AI authoring の挙動は変わらない。#1324 直後のリネーム churn を再現する。
• option C (意味 shift のみ、命名は据え置き) — 「Decision Log」のままで state 形 entry を推奨するのは語彙的に矛盾する。framing と命名は一体化している。

option A は同一 PR で意味整列を完了させるため、AI authoring 挙動が PR merge と同期して shift する。

メタ的観察

本エントリ自体が、現行の「Decision Log」framing 下で書かれているが、PR merge 後には「Decision Structure」framing 下のエントリとして読まれる。エントリの内容が「framing 自体の rename」を記述しているため、recursion は意図的かつ self-consistent。新しい framing 下でのエントリ shape (state 形 + supersede/depend edge) を本エントリで先取り demonstrate している。

関連

• Issue: #1329
• PR: TBD (PR 作成後にリンク追加)
• 過去判断: #1011 / #1205 / #1323 / #1324