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 拡張を前提にしていた:
deciders: string[]— 意思決定者x-blast:— リスクモデルの数値上書き(reversal-mu,irreversibility等)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) に底上げ |
expensive | P50 を ×2.5 |
cheap | P50 を ×0.4 |
volatile | Beta 事前分布の分散を拡大 |
利点:
- frontmatter が完全にフラットのまま
- タグは既に UI で見える
- 予約タグの存在を忘れても、単なるタグとして無害
SCHEMA.mdの「status の慣習値」と同じ扱いで、schema 制約を増やさない
欠点:
- 精度を失う(440日は表現不能)
- 予約タグという隠れた契約が増える → タイポを診断に出すことで緩和
3. x-outcome:(予測と実績の対)
得られるはずだったメリット:
- Brier スコア: 予測の二乗誤差平均
- Murphy 分解(BS = REL − RES + UNC): 誤差の内訳(較正誤差 / 分解能 / 不確実性)
- 信頼性ダイアグラム: 「85%と言ったとき、本当に85%当たっているか」
- 過信量: 予測平均 − 実測成功率
これは個人の意思決定ジャーナルにおける唯一の複利的機能である。「決定を記録する」と「決定から学ぶ」の差はここにしかない。Superforecasting や calibration training の文脈で知られている。
却下理由(frontmatter として):
「予測確率」を frontmatter に置くと、以下の問題が生じる:
statusに埋め込む →predictedの数値が失われ、Brier 計算不能tags: [predicted-85, outcome-failed]→ タグフィルタ汚染、数値を文字列で持つ不自然さ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 実装仕様 — 実装仕様