decisiondecided

Blast Radius のスキーマ拡張を却下する

Blast Radius が要求する deciders / x-blast / x-outcome の3拡張を却下し、既存の tags と本文

Context

決定の依存関係と影響範囲を可視化する静的ツール public/tools/blast-radius/ を導入したい。ツールは単一HTMLで動き、npm run build:blast で生成した graph.json を読む。

ツールの元実装は組織向け ADR リポジトリを想定しており、以下の3つの frontmatter 拡張を前提にしていた:

  1. deciders: string[] — 意思決定者
  2. x-blast: — リスクモデルの数値上書き(reversal-mu, irreversibility 等)
  3. x-outcome: — 予測と実績の対(predicted, actual, observed)

しかし Parlourite Notes は meta/SCHEMA.md の完全フラット構造原則(type非依存、全フィールド共通)を採っており、これらを持ち込むとスキーマの複雑度が跳ね上がる。本決定は、3拡張の採否を判断する。

Decision

3拡張すべてを却下する。 ただし x-outcome が提供する学習ループの価値だけは、既存の仕組みに丸め込んで維持する。

拡張判定代替
deciders却下なし(機能ごと削除)
x-blast却下予約タグ(one-way / expensive / cheap / volatile)
x-outcome却下本文 ## Outcome (YYYY-MM-DD) — worked|failed|mixed セクション

meta/SCHEMA.md には frontmatter フィールドを1つも追加しない。

却下した拡張と、失ったメリット

1. deciders: string[]

得られるはずだったメリット:

  • バス係数: 各決定者の媒介中心性を合算し、「誰が抜けたら何が失われるか」を定量化する
  • 決定者別キャリブレーション: 「alice は12pt 過信傾向、bob は5pt 慎重」のような個人差の抽出
  • サイドバーの決定者フィルタ

却下理由:

meta/RULES.md の冒頭に「自分の判断をエージェントに再供給するための構造化コンテキスト置き場」と書いてある。決定者は常に自分1人である。バス係数1、キャリブレーションサンプル1は情報にならない。

ツールのデモ(knight / ariane5 / therac25)が全てチーム事故なのは、deciders が組織向け ADR のための機能だからだ。個人ブログに持ち込む意味はない。

代替案として却下したもの:

  • tags: [author-alice] — タグフィルタを汚染する。個人ブログでは「著者」は自明
  • deciders: [me] を機械的に書く — 情報量ゼロのフィールドを全記事に増やす

2. x-blast:(リスクモデルの数値上書き)

得られるはずだったメリット:

  • ツールの既定リスクモデル(語数・fan-in/out・改訂回数からの P50 導出)を実測値で上書きできる
  • 例: reversal-mu: Math.log(440) = 反転コスト P50 を 440 人日と明示
  • 公開事故の事後分析(Knight Capital, Ariane 5 等)の実数を反映できる

却下理由:

自分の決定に「P50 = 440人日」という実測値は普通存在しない。あるのは「これは戻せない」「これは高い」という粗い直感だけ。粗い直感に reversal-mu: 6.09 を書かせるのは、スキーマの複雑度に見合わない。

さらに、既定モデルの数値自体がヒューリスティクスである。440日と12日を区別する精度は元々ない。相対順位が合っていれば実用上十分。

採用した代替 — 予約タグ:

tags: [architecture, one-way, expensive]
予約タグ効果
one-way不可逆性を max(現在値, 0.85) に底上げ
expensiveP50 を ×2.5
cheapP50 を ×0.4
volatileBeta 事前分布の分散を拡大

利点:

  • frontmatter が完全にフラットのまま
  • タグは既に UI で見える
  • 予約タグの存在を忘れても、単なるタグとして無害
  • SCHEMA.md の「status の慣習値」と同じ扱いで、schema 制約を増やさない

欠点:

  • 精度を失う(440日は表現不能)
  • 予約タグという隠れた契約が増える → タイポを診断に出すことで緩和

3. x-outcome:(予測と実績の対)

得られるはずだったメリット:

  • Brier スコア: 予測の二乗誤差平均
  • Murphy 分解(BS = REL − RES + UNC): 誤差の内訳(較正誤差 / 分解能 / 不確実性)
  • 信頼性ダイアグラム: 「85%と言ったとき、本当に85%当たっているか」
  • 過信量: 予測平均 − 実測成功率

これは個人の意思決定ジャーナルにおける唯一の複利的機能である。「決定を記録する」と「決定から学ぶ」の差はここにしかない。Superforecasting や calibration training の文脈で知られている。

却下理由(frontmatter として):

「予測確率」を frontmatter に置くと、以下の問題が生じる:

  1. status に埋め込む → predicted の数値が失われ、Brier 計算不能
  2. tags: [predicted-85, outcome-failed] → タグフィルタ汚染、数値を文字列で持つ不自然さ
  3. x-outcome: オブジェクト → 入れ子構造。フラット原則違反

採用した代替 — 本文 ## Outcome セクション:

SCHEMA.md には既に ## Update (YYYY-MM-DD) という本文セクション規約がある。同じ発想で ## Outcome を追加する。

## Outcome (2026-11-15) — failed
Confidence at decision time: 0.85
フラグは8台中1台で再利用され、旧い意味が残っていた。
インシデント1件、復旧に2日。

パーサは以下を抽出:

  • 見出しの — failed → actual
  • Confidence at decision time: 0.85 → predicted
  • 見出しの (2026-11-15) → observed
  • 本文の インシデントN件 / N日 → incidents / rework-days

利点:

  • frontmatter は1バイトも増えない
  • レンダリングされたサイトで自然に読める
  • ## Update と同じ既存の慣習に乗る
  • 「予測確率を後から追記する」行為が、本文を書く流れに自然に組み込まれる

欠点:

  • ツール側のパーサ実装が必要
  • 見出し形式を守らないと静かに無視される → 診断に出すことで緩和

Consequences

失うもの

  • バス係数 — 使えない。個人ブログでは元々無意味
  • 決定者別キャリブレーション — 同上
  • 精密なリスク数値 — 予約タグで粗くしか表現できない

得るもの

  • frontmatter は完全にフラットのまま — 設計原則を1つも破らない
  • x-blast / x-outcome の入れ子オブジェクトを削除できる — ツール実装が単純化
  • ## Outcome がレンダリングされたサイトで自然に読める — OGP的にもプラス
  • Brier / 信頼性ダイアグラム / 過信量という複利的価値は維持

トレードオフの本質

「frontmatter のフラット性」と「予測確率の機械可読性」は本質的に衝突する。## Outcome 本文規約はこの衝突を本文側に逃がすことで解決する。frontmatter はメタデータ、本文は内容、という自然な分離である。

将来の見直し条件

以下のいずれかが成立した場合、本決定を再検討する:

  • 複数人で運用するようになった(deciders の価値が復活)
  • 予約タグでは表現できない精度の必要性が生じた(x-blast の価値が復活)
  • ## Outcome のパース失敗が頻発した(frontmatter 化の検討材料)

参照

  • meta/SCHEMA.md § 予約タグ / § Outcome セクション
  • meta/RULES.md § 可視化ツール連携
  • Blast Radius 実装仕様 — 実装仕様