From 805b3c44b9ba3c7484dee83c18cd4a93cdc378f9 Mon Sep 17 00:00:00 2001 From: kmwebnet Date: Mon, 20 Apr 2026 08:53:57 +0900 Subject: [PATCH] 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 --- README.md | 18 +++++++++++----- aar/_template.md | 1 + adr/_template.md | 1 + csirt-automation/README.md | 12 +++++++++++ csirt-automation/aar/_template.md | 22 ++++++++++++++++++++ csirt-automation/adr/_template.md | 30 +++++++++++++++++++++++++++ csirt-automation/exp/_template.md | 34 +++++++++++++++++++++++++++++++ exp/_template.md | 1 + iot-prototype/README.md | 12 +++++++++++ iot-prototype/aar/_template.md | 22 ++++++++++++++++++++ iot-prototype/adr/_template.md | 30 +++++++++++++++++++++++++++ iot-prototype/exp/_template.md | 34 +++++++++++++++++++++++++++++++ 12 files changed, 212 insertions(+), 5 deletions(-) create mode 100644 csirt-automation/README.md create mode 100644 csirt-automation/aar/_template.md create mode 100644 csirt-automation/adr/_template.md create mode 100644 csirt-automation/exp/_template.md create mode 100644 iot-prototype/README.md create mode 100644 iot-prototype/aar/_template.md create mode 100644 iot-prototype/adr/_template.md create mode 100644 iot-prototype/exp/_template.md diff --git a/README.md b/README.md index 3efdb67..f7aa0ca 100644 --- a/README.md +++ b/README.md @@ -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/` で横断検索。 diff --git a/aar/_template.md b/aar/_template.md index 1567fc0..e1420f8 100644 --- a/aar/_template.md +++ b/aar/_template.md @@ -1,6 +1,7 @@ # AAR YYYY-Www (第w週) - **Date**: YYYY-MM-DD +- **Product**: csirt-automation | iot-prototype - **Participants**: [参加者] ## 1. What was intended? (何を狙っていたか) diff --git a/adr/_template.md b/adr/_template.md index 9ced5ca..478e648 100644 --- a/adr/_template.md +++ b/adr/_template.md @@ -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 diff --git a/csirt-automation/README.md b/csirt-automation/README.md new file mode 100644 index 0000000..3aecf3d --- /dev/null +++ b/csirt-automation/README.md @@ -0,0 +1,12 @@ +# csirt-automation + +CSIRT業務のAI効率化に関する判断・実験・振り返りの記録。 + +## 目的 +時間単価のCSIRT業務から、スケーラブルな価値提供への転換。 + +## 主要テーマ +- 運用効率化（AIの活用） +- アナリストの生産性向上 +- PoCの摩擦低減 +- 課題のサービス化（DaaSアプローチ） diff --git a/csirt-automation/aar/_template.md b/csirt-automation/aar/_template.md new file mode 100644 index 0000000..7f0116c --- /dev/null +++ b/csirt-automation/aar/_template.md @@ -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昇格の候補)] diff --git a/csirt-automation/adr/_template.md b/csirt-automation/adr/_template.md new file mode 100644 index 0000000..4e55f53 --- /dev/null +++ b/csirt-automation/adr/_template.md @@ -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 +この判断によって何が起きるか？ +- 期待される効果 +- 潜在的なリスク +- この判断を覆すトリガー（例：〇〇が失敗したら見直す） diff --git a/csirt-automation/exp/_template.md b/csirt-automation/exp/_template.md new file mode 100644 index 0000000..35689f6 --- /dev/null +++ b/csirt-automation/exp/_template.md @@ -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] diff --git a/exp/_template.md b/exp/_template.md index 7649fbf..8d46bb8 100644 --- a/exp/_template.md +++ b/exp/_template.md @@ -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 diff --git a/iot-prototype/README.md b/iot-prototype/README.md new file mode 100644 index 0000000..db42186 --- /dev/null +++ b/iot-prototype/README.md @@ -0,0 +1,12 @@ +# iot-prototype + +IoTセキュアプロトタイピングに関する判断・実験・振り返りの記録。 + +## 目的 +IoTセキュリティの単体価値ではなく、「利便性とセットでの価値」を実証し、将来の収益源を構築。 + +## 主要テーマ +- セキュリティ×利便性の統合設計 +- ユーザビリティベースの実証 +- プロトタイプ開発と検証 +- ビジネスモデルの仮説検証 diff --git a/iot-prototype/aar/_template.md b/iot-prototype/aar/_template.md new file mode 100644 index 0000000..68570fc --- /dev/null +++ b/iot-prototype/aar/_template.md @@ -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昇格の候補)] diff --git a/iot-prototype/adr/_template.md b/iot-prototype/adr/_template.md new file mode 100644 index 0000000..fa21669 --- /dev/null +++ b/iot-prototype/adr/_template.md @@ -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 +この判断によって何が起きるか？ +- 期待される効果 +- 潜在的なリスク +- この判断を覆すトリガー（例：〇〇が失敗したら見直す） diff --git a/iot-prototype/exp/_template.md b/iot-prototype/exp/_template.md new file mode 100644 index 0000000..17ccfad --- /dev/null +++ b/iot-prototype/exp/_template.md @@ -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]