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
This commit is contained in:
@@ -1,20 +1,28 @@
|
|||||||
# decisions-log
|
# decisions-log
|
||||||
|
|
||||||
このリポジトリは、組織の「判断の記録」と「実験の蓄積」を目的としています。
|
このリポジトリは、2つのプロダクトの「判断の記録」と「実験の蓄積」を目的としています。
|
||||||
|
|
||||||
## 目的
|
## 目的
|
||||||
1. **判断の再現性**: なぜその選択をしたかを未来の自分に伝える。
|
1. **判断の再現性**: なぜその選択をしたかを未来の自分に伝える。
|
||||||
2. **学習の蓄積**: 成功・失敗からの教訓を形式知化する。
|
2. **学習の蓄積**: 成功・失敗からの教訓を形式知化する。
|
||||||
3. **属人化の排除**: 判断の背景を可視化し、個人に依存しない意思決定基盤を作る。
|
3. **属人化の排除**: 判断の背景を可視化し、個人に依存しない意思決定基盤を作る。
|
||||||
|
|
||||||
## 3層構造
|
## 2プロダクト構成
|
||||||
|
|
||||||
|
| プロダクト | サブディレクトリ | 目的 |
|
||||||
|
|-----------|-----------------|------|
|
||||||
|
| **CSIRT効率化** | `csirt-automation/` | 顧客のCSIRT業務をAIで効率化。時間単価の構造からスケーラブルな価値へ |
|
||||||
|
| **IoTプロトタイピング** | `iot-prototype/` | IoTセキュリティの単体価値ではなく、利便性とセットでの価値実証 |
|
||||||
|
|
||||||
|
## 3層構造(各プロダクト内)
|
||||||
- **ADR (adr/)**: 事業・技術判断の記録。一度決まったことは削除せず、新しいADRで上書きする。
|
- **ADR (adr/)**: 事業・技術判断の記録。一度決まったことは削除せず、新しいADRで上書きする。
|
||||||
- **Experiment (exp/)**: 仮説検証の記録。成功基準を事前に定義し、確証バイアスを防ぐ。
|
- **Experiment (exp/)**: 仮説検証の記録。成功基準を事前に定義し、確証バイアスを防ぐ。
|
||||||
- **AAR (aar/)**: 短期間の振り返り。ギャップの原因を事実ベースで分析し、次へつなぐ。
|
- **AAR (aar/)**: 短期間の振り返り。ギャップの原因を事実ベースで分析し、次へつなぐ。
|
||||||
|
|
||||||
## 運用ルール
|
## 運用ルール
|
||||||
1. **AER-0001**: ADRは30分以上かけない。判断が熟していない証拠。
|
1. **AER-0001**: ADRは30分以上かけない。判断が熟していない証拠。
|
||||||
2. **EXP-0001**: EXPは開始時5分、終了時15分で記述。詳細はコメントアウトや別ファイルで管理。
|
2. **EXP-0001**: EXPは開始時5分、終了時15分で記述。
|
||||||
3. **AAR-0001**: AARは金曜夕方の30分固定。タイマーを使い、時間内に終わらせる。
|
3. **AAR-0001**: AARは金曜夕方の30分固定。
|
||||||
4. **Blameless**: 批判ではなく「計測可能な事実」を書く。
|
4. **Blameless**: 批判ではなく「計測可能な事実」を書く。
|
||||||
5. **ツール最小化**: 50件を超えるまでは手動検索(grep/Gitea検索)で十分。
|
5. **ツール最小化**: 1プロダクトあたり50件を超えるまでは手動検索で十分。
|
||||||
|
6. **プロダクト横断検索**: `grep -r "キーワード" csirt-automation/ iot-prototype/` で横断検索。
|
||||||
|
|||||||
@@ -1,6 +1,7 @@
|
|||||||
# AAR YYYY-Www (第w週)
|
# AAR YYYY-Www (第w週)
|
||||||
|
|
||||||
- **Date**: YYYY-MM-DD
|
- **Date**: YYYY-MM-DD
|
||||||
|
- **Product**: csirt-automation | iot-prototype
|
||||||
- **Participants**: [参加者]
|
- **Participants**: [参加者]
|
||||||
|
|
||||||
## 1. What was intended? (何を狙っていたか)
|
## 1. What was intended? (何を狙っていたか)
|
||||||
|
|||||||
@@ -3,6 +3,7 @@
|
|||||||
- **Status**: Proposed | Accepted | Superseded | Rejected
|
- **Status**: Proposed | Accepted | Superseded | Rejected
|
||||||
- **Date**: YYYY-MM-DD
|
- **Date**: YYYY-MM-DD
|
||||||
- **Deciders**: [判断に関与した人]
|
- **Deciders**: [判断に関与した人]
|
||||||
|
- **Product**: csirt-automation | iot-prototype
|
||||||
- **Related EXP**: [関連する実験ID, e.g., EXP-0023]
|
- **Related EXP**: [関連する実験ID, e.g., EXP-0023]
|
||||||
|
|
||||||
## Context
|
## 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
|
- **Start**: YYYY-MM-DD
|
||||||
- **End**: YYYY-MM-DD
|
- **End**: YYYY-MM-DD
|
||||||
- **Owner**: [責任者]
|
- **Owner**: [責任者]
|
||||||
|
- **Product**: csirt-automation | iot-prototype
|
||||||
- **Related ADR**: [関連する判断ID, e.g., ADR-0012]
|
- **Related ADR**: [関連する判断ID, e.g., ADR-0012]
|
||||||
- **Status**: Running | Done | Aborted
|
- **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]
|
||||||
Reference in New Issue
Block a user