Context Decision Log
意思決定を構造化して記録するスキル。暗黙的な決定の検出も担う。
2つの記録パターン
パターンA: AIとの作業中に決まったこと
セッション中の会話から情報を自動抽出してドラフト生成。
パターンB: 人間が別の場所で決めたこと
「会議で○○が決まった」等の事後報告。AIが質問して情報を補完:
code
記録します。いくつか教えてください: - 他にどんな選択肢がありましたか? - なぜそれに決めましたか? - 見直す条件はありますか? (わからない項目はスキップOK)
暗黙的な決定の検出
セッション中、以下のパターンを検出したら1行で提案する:
検出するパターン
| パターン | 例 |
|---|---|
| 「○○にする」「○○を使う」 | 「DBはPostgreSQLにする」 |
| 「○○で行こう」「○○で進める」 | 「この設計で行こう」 |
| 「○○はやめる」「○○は不採用」 | 「Redisはやめておこう」 |
| 比較検討後の結論 | 「AよりBの方がいいね」 |
| 「○○にしておく」(暫定) | 「ひとまずSQLiteにしておく」→ 🔄仮決定 |
検出しないもの
- •変数名やインデント幅など軽微な判断
- •仮定の話(「もし○○なら」)
- •既知の事実の確認
提案
code
💡 Decision Logに記録しますか? → {決定の要約}
- •1セッション最大3回
- •断られたら引き下がる
- •作業の流れを止めない(1行で済ませる)
ファイル名規則
_ai-context/decision_log/YYYY-MM-DD_{topic}.md
- •topic: 英語snake_case(例:
db_schema_choice,api_framework_selection) - •同日複数:
_a,_bをつける
ドラフト生成
TEMPLATE.md に従って生成:
markdown
# Decision: {タイトル}
> 日付: YYYY-MM-DD
> ステータス: ✅ 確定 / 🔄 仮決定
> 経緯: AI作業中 / 会議 / 単独判断
## Context(背景)
{2-3文}
## Options(選択肢)
### Option A: {名前}
- メリット:
- デメリット:
### Option B: {名前}
- メリット:
- デメリット:
## Chosen(選択)
**→ Option {X}: {名前}**
## Why(理由)
{2-4文}
## Risk(リスク)
-
## Revisit Trigger(再検討条件)
-
手順
- •決定内容の把握(会話から抽出 or ユーザーに質問)
- •ドラフト生成してユーザーに提示
- •ステータス(確定/仮決定)と内容を確認
- •承認後にファイル保存
- •project_summary.md の決定事項テーブルへの追記を提案
品質基準
- •Options は最低2つ(1つだけなら決定ではなく事実の記録)
- •Why は「AIが推薦したから」ではなく具体的根拠
- •Revisit Trigger は測定可能な条件
- •情報不足の場合(特にパターンB)は「不明」と書いてOK。後から補完できる