commit b3ebeed743dae5b1f9e6ba1bc7d405e996adc5fd Author: kmwebnet Date: Mon Apr 20 08:09:56 2026 +0900 Initial: ADR/EXP/AAR templates and README diff --git a/README.md b/README.md new file mode 100644 index 0000000..3efdb67 --- /dev/null +++ b/README.md @@ -0,0 +1,20 @@ +# decisions-log + +このリポジトリは、組織の「判断の記録」と「実験の蓄積」を目的としています。 + +## 目的 +1. **判断の再現性**: なぜその選択をしたかを未来の自分に伝える。 +2. **学習の蓄積**: 成功・失敗からの教訓を形式知化する。 +3. **属人化の排除**: 判断の背景を可視化し、個人に依存しない意思決定基盤を作る。 + +## 3層構造 +- **ADR (adr/)**: 事業・技術判断の記録。一度決まったことは削除せず、新しいADRで上書きする。 +- **Experiment (exp/)**: 仮説検証の記録。成功基準を事前に定義し、確証バイアスを防ぐ。 +- **AAR (aar/)**: 短期間の振り返り。ギャップの原因を事実ベースで分析し、次へつなぐ。 + +## 運用ルール +1. **AER-0001**: ADRは30分以上かけない。判断が熟していない証拠。 +2. **EXP-0001**: EXPは開始時5分、終了時15分で記述。詳細はコメントアウトや別ファイルで管理。 +3. **AAR-0001**: AARは金曜夕方の30分固定。タイマーを使い、時間内に終わらせる。 +4. **Blameless**: 批判ではなく「計測可能な事実」を書く。 +5. **ツール最小化**: 50件を超えるまでは手動検索(grep/Gitea検索)で十分。 diff --git a/aar/_template.md b/aar/_template.md new file mode 100644 index 0000000..1567fc0 --- /dev/null +++ b/aar/_template.md @@ -0,0 +1,21 @@ +# AAR YYYY-Www (第w週) + +- **Date**: YYYY-MM-DD +- **Participants**: [参加者] + +## 1. What was intended? (何を狙っていたか) +- [目標1] +- [目標2] + +## 2. What actually happened? (実際に何が起きたか) +- [事実1] +- [事実2] + +## 3. Why was there a difference? (ギャップの理由) +- [要因1 (事実ベース)] +- [要因2 (事実ベース)] + +## 4. What will we do differently? (次に何を変えるか) +- [アクション1 (タスク化)] +- [アクション2 (EXP昇格の候補)] +- [アクション3 (ADR昇格の候補)] diff --git a/adr/_template.md b/adr/_template.md new file mode 100644 index 0000000..9ced5ca --- /dev/null +++ b/adr/_template.md @@ -0,0 +1,29 @@ +# ADR-NNNN: [判断のタイトル] + +- **Status**: Proposed | Accepted | Superseded | Rejected +- **Date**: YYYY-MM-DD +- **Deciders**: [判断に関与した人] +- **Related EXP**: [関連する実験ID, e.g., EXP-0023] + +## Context +この判断が求められる背景は何か? +誰が、どの問題に直面している? +データや事実は何がある? + +## Decision +どのような判断をしたのか? +具体的かつ簡潔に記述する。 + +## Rationale +なぜこの選択肢を選んだのか? +他の選択肢との比較含め、理由を列挙する。 + +## Alternatives Considered +却下した選択肢は何か? +なぜそれらを棄てたのか? + +## Consequences +この判断によって何が起きるか? +- 期待される効果 +- 潜在的なリスク +- この判断を覆すトリガー(例:〇〇が失敗したら見直す) diff --git a/exp/_index.md b/exp/_index.md new file mode 100644 index 0000000..1c44e3d --- /dev/null +++ b/exp/_index.md @@ -0,0 +1,5 @@ +# Experiment Index + +| ID | Title | Owner | Start | End | Status | Related ADR | +|----|-------|-------|-------|-----|--------|-------------| + diff --git a/exp/_template.md b/exp/_template.md new file mode 100644 index 0000000..7649fbf --- /dev/null +++ b/exp/_template.md @@ -0,0 +1,33 @@ +# EXP-NNNN: [実験のタイトル] + +- **Start**: YYYY-MM-DD +- **End**: YYYY-MM-DD +- **Owner**: [責任者] +- **Related ADR**: [関連する判断ID, e.g., ADR-0012] +- **Status**: Running | Done | Aborted + +## Hypothesis +もし [行動] をすれば、[結果] が起こるだろう。 +なぜなら [理由] だからだ。 + +## Minimum Viable Test +- **Who**: [誰に/] +- **What**: [何を/] +- **When**: [いつ/] + +## Success Criteria +- 成功: [具体的な数値や状態, e.g., 3社中2社からyesの反応] +- 失敗: [具体的な数値や状態, e.g., 0社からの反応] +- 延長: [条件, e.g., 1社しか話せない] + +## Cost +- **Time**: [自分の時間, e.g., 3時間] +- **Customer Time**: [顧客の時間, e.g., 各30分] +- **Money**: [金銭的コスト, e.g., 0円] + +## Result (終了時に記入) +[結果をここに書く] + +## Learnings (AAR層へ昇格する候補) +1. [学び1] +2. [学び2]