decision structure rename rationale - Liplus-Project/liplus-language GitHub Wiki
判断記録の永続化アーティファクトを「履歴 (log/history)」として framing するか、「構造 (structure)」として framing するか。
「構造 (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 にまとめる。
- 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-writeskill を 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-zprefix を 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.mdPer-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