feat: Add 2-product structure (csirt-automation, iot-prototype) with ADR/EXP/AAR templates

- Root level templates with Product field - csirt-automation/ sub-project for CSIRT AI efficiency - iot-prototype/ sub-project for IoT security prototyping - Cross-product README with grep-based search guidance
2026-04-20 08:53:57 +09:00
parent b3ebeed743
commit 805b3c44b9
12 changed files with 212 additions and 5 deletions
@@ -1,20 +1,28 @@
 # decisions-log

-このリポジトリは、組織の「判断の記録」と「実験の蓄積」を目的としています。
+このリポジトリは、2つのプロダクトの「判断の記録」と「実験の蓄積」を目的としています。

 ## 目的
 1. **判断の再現性**: なぜその選択をしたかを未来の自分に伝える。
 2. **学習の蓄積**: 成功・失敗からの教訓を形式知化する。
 3. **属人化の排除**: 判断の背景を可視化し、個人に依存しない意思決定基盤を作る。

-## 3層構造
+## 2プロダクト構成
+
+| プロダクト | サブディレクトリ | 目的 |
+|-----------|-----------------|------|
+| **CSIRT効率化** | `csirt-automation/` | 顧客のCSIRT業務をAIで効率化。時間単価の構造からスケーラブルな価値へ |
+| **IoTプロトタイピング** | `iot-prototype/` | IoTセキュリティの単体価値ではなく、利便性とセットでの価値実証 |
+
+## 3層構造（各プロダクト内）
 - **ADR (adr/)**: 事業・技術判断の記録。一度決まったことは削除せず、新しいADRで上書きする。
 - **Experiment (exp/)**: 仮説検証の記録。成功基準を事前に定義し、確証バイアスを防ぐ。
 - **AAR (aar/)**: 短期間の振り返り。ギャップの原因を事実ベースで分析し、次へつなぐ。

 ## 運用ルール
 1. **AER-0001**: ADRは30分以上かけない。判断が熟していない証拠。
-2. **EXP-0001**: EXPは開始時5分、終了時15分で記述。詳細はコメントアウトや別ファイルで管理。
-3. **AAR-0001**: AARは金曜夕方の30分固定。タイマーを使い、時間内に終わらせる。
+2. **EXP-0001**: EXPは開始時5分、終了時15分で記述。
+3. **AAR-0001**: AARは金曜夕方の30分固定。
 4. **Blameless**: 批判ではなく「計測可能な事実」を書く。
-5. **ツール最小化**: 50件を超えるまでは手動検索（grep/Gitea検索）で十分。
+5. **ツール最小化**: 1プロダクトあたり50件を超えるまでは手動検索で十分。
+6. **プロダクト横断検索**: `grep -r "キーワード" csirt-automation/ iot-prototype/` で横断検索。
@@ -1,6 +1,7 @@
 # AAR YYYY-Www (第w週)

 - **Date**: YYYY-MM-DD
+- **Product**: csirt-automation | iot-prototype
 - **Participants**: [参加者]

 ## 1. What was intended? (何を狙っていたか)
@@ -3,6 +3,7 @@
 - **Status**: Proposed | Accepted | Superseded | Rejected
 - **Date**: YYYY-MM-DD
 - **Deciders**: [判断に関与した人]
+- **Product**: csirt-automation | iot-prototype
 - **Related EXP**: [関連する実験ID, e.g., EXP-0023]

 ## Context
@@ -0,0 +1,12 @@
+# csirt-automation
+
+CSIRT業務のAI効率化に関する判断・実験・振り返りの記録。
+
+## 目的
+時間単価のCSIRT業務から、スケーラブルな価値提供への転換。
+
+## 主要テーマ
+- 運用効率化（AIの活用）
+- アナリストの生産性向上
+- PoCの摩擦低減
+- 課題のサービス化（DaaSアプローチ）
@@ -0,0 +1,22 @@
+# AAR YYYY-Www (第w週)
+
+- **Date**: YYYY-MM-DD
+- **Product**: csirt-automation
+- **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昇格の候補)]
@@ -0,0 +1,30 @@
+# ADR-NNNN: [判断のタイトル]
+
+- **Status**: Proposed | Accepted | Superseded | Rejected
+- **Date**: YYYY-MM-DD
+- **Deciders**: [判断に関与した人]
+- **Product**: csirt-automation
+- **Related EXP**: [関連する実験ID, e.g., EXP-0023]
+
+## Context
+この判断が求められる背景は何か？
+誰が、どの問題に直面している？
+データや事実は何がある？
+
+## Decision
+どのような判断をしたのか？
+具体的かつ簡潔に記述する。
+
+## Rationale
+なぜこの選択肢を選んだのか？
+他の選択肢との比較含め、理由を列挙する。
+
+## Alternatives Considered
+却下した選択肢は何か？
+なぜそれらを棄てたのか？
+
+## Consequences
+この判断によって何が起きるか？
+- 期待される効果
+- 潜在的なリスク
+- この判断を覆すトリガー（例：〇〇が失敗したら見直す）
@@ -0,0 +1,34 @@
+# EXP-NNNN: [実験のタイトル]
+
+- **Start**: YYYY-MM-DD
+- **End**: YYYY-MM-DD
+- **Owner**: [責任者]
+- **Product**: csirt-automation
+- **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]
@@ -3,6 +3,7 @@
 - **Start**: YYYY-MM-DD
 - **End**: YYYY-MM-DD
 - **Owner**: [責任者]
+- **Product**: csirt-automation | iot-prototype
 - **Related ADR**: [関連する判断ID, e.g., ADR-0012]
 - **Status**: Running | Done | Aborted

@@ -0,0 +1,12 @@
+# iot-prototype
+
+IoTセキュアプロトタイピングに関する判断・実験・振り返りの記録。
+
+## 目的
+IoTセキュリティの単体価値ではなく、「利便性とセットでの価値」を実証し、将来の収益源を構築。
+
+## 主要テーマ
+- セキュリティ×利便性の統合設計
+- ユーザビリティベースの実証
+- プロトタイプ開発と検証
+- ビジネスモデルの仮説検証
@@ -0,0 +1,22 @@
+# AAR YYYY-Www (第w週)
+
+- **Date**: YYYY-MM-DD
+- **Product**: iot-prototype
+- **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昇格の候補)]
@@ -0,0 +1,30 @@
+# ADR-NNNN: [判断のタイトル]
+
+- **Status**: Proposed | Accepted | Superseded | Rejected
+- **Date**: YYYY-MM-DD
+- **Deciders**: [判断に関与した人]
+- **Product**: iot-prototype
+- **Related EXP**: [関連する実験ID, e.g., EXP-0023]
+
+## Context
+この判断が求められる背景は何か？
+誰が、どの問題に直面している？
+データや事実は何がある？
+
+## Decision
+どのような判断をしたのか？
+具体的かつ簡潔に記述する。
+
+## Rationale
+なぜこの選択肢を選んだのか？
+他の選択肢との比較含め、理由を列挙する。
+
+## Alternatives Considered
+却下した選択肢は何か？
+なぜそれらを棄てたのか？
+
+## Consequences
+この判断によって何が起きるか？
+- 期待される効果
+- 潜在的なリスク
+- この判断を覆すトリガー（例：〇〇が失敗したら見直す）
@@ -0,0 +1,34 @@
+# EXP-NNNN: [実験のタイトル]
+
+- **Start**: YYYY-MM-DD
+- **End**: YYYY-MM-DD
+- **Owner**: [責任者]
+- **Product**: iot-prototype
+- **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]