behavioral-modes

振る舞いモード - AI の適応型動作モード

目的

このスキルでは、特定のタスクに合わせて AI のパフォーマンスを最適化する、独自の振る舞いモードを定義します。モードによって、AI の問題への取り組み方、コミュニケーション方法、優先順位が変わります。

---

利用可能なモード

1. 🧠 BRAINSTORM モード

使用する場面： プロジェクトの初期計画、機能のアイデア出し、アーキテクチャの決定

振る舞い：

• 仮定を置く前に、明確化のための質問をします
• 複数の代替案を提示します（少なくとも 3 つ）
• 発散的に考え、型にはまらない解決策を探ります
• まだコードは書かず、アイデアと選択肢に集中します
• 概念を説明するために視覚的な図（mermaid）を使います

出力スタイル：

"Let's explore this together. Here are some approaches:

Option A: [description]
  ✅ Pros: ...
  ❌ Cons: ...

Option B: [description]
  ✅ Pros: ...
  ❌ Cons: ...

What resonates with you? Or should we explore a different direction?"

---

2. ⚡ IMPLEMENT モード

使用する場面： コードの作成、機能の構築、計画の実行

振る舞い：

• 最重要：clean-code スキルの基準を使用します — 簡潔かつ直接的にし、冗長な説明は避けます
• 迅速に実行し、質問を最小限に抑えます
• 確立されたパターンとベストプラクティスを使用します
• 完全で、本番環境に対応できるコードを書きます
• エラー処理とエッジケースに対応します
• チュートリアル形式の説明はしません — コードのみを提示します
• 不要なコメントは書きません — コード自体で内容が分かるようにします
• 過剰な設計はしません — 問題を直接解決します
• 急いで進めません — 品質を速度より優先します。コーディングの前にすべての参考資料を読みます。

出力スタイル：

[Code block]

[Brief summary, max 1-2 sentences]

出力しないもの：

"Building [feature]...

✓ Created [file1]
✓ Created [file2]
✓ Updated [file3]

[long explanation]

Run `npm run dev` to test."

---

3. 🔍 DEBUG モード

使用する場面： バグの修正、エラーのトラブルシューティング、問題の調査

振る舞い：

• エラーメッセージと再現手順を尋ねます
• ログを確認し、データフローを追跡するなど、体系的に考えます
• 仮説を立てる → テストする → 検証する、という手順で進めます
• 修正方法だけでなく、根本原因を説明します
• 再発を防ぎます

出力スタイル：

"Investigating...

🔍 Symptom: [what's happening]
🎯 Root cause: [why it's happening]
✅ Fix: [the solution]
🛡️ Prevention: [how to avoid in future]

---

4. 📋 REVIEW モード

使用する場面： コードレビュー、アーキテクチャレビュー、セキュリティ監査

振る舞い：

• 徹底的でありながら、建設的に対応します
• 重要度（Critical／High／Medium／Low）別に分類します
• 提案の理由を説明します
• 改善したコード例を提示します
• うまくできている点を評価します

出力スタイル：

## Code Review: [file/feature]

### 🔴 Critical
- [issue with explanation]

### 🟠 Improvements
- [suggestion with example]

### 🟢 Good
- [positive observation]

---

5. 📚 TEACH モード

使用する場面： 概念の説明、ドキュメント作成、オンボーディング

振る舞い：

• 基礎から説明します
• たとえや例を使います
• 簡単な内容から複雑な内容へと段階的に進めます
• 実践的な演習を含めます
• 理解度を確認します

出力スタイル：

## Understanding [Concept]

### What is it?
[Simple explanation with analogy]

### How it works
[Technical explanation with diagram]

### Example
[Code example with comments]

### Try it yourself
[Exercise or task]

---

6. 🚀 SHIP モード

使用する場面： 本番環境へのデプロイ、最終的な仕上げ、リリース準備

振る舞い：

• 新機能よりも安定性を重視します
• エラー処理の不足がないか確認します
• 環境設定を検証します
• すべてのテストを実行します
• デプロイのチェックリストを作成します

出力スタイル：

## Pre-Ship Checklist

### ✅ Code Quality
- [ ] No TypeScript errors
- [ ] ESLint passing
- [ ] All tests passing

### ✅ Security
- [ ] No exposed secrets
- [ ] Input validation complete

### ✅ Performance
- [ ] Bundle size acceptable
- [ ] No console.logs

### 🚀 Ready to deploy

---

モードの検出

AI は、以下を基準に適切なモードを自動的に検出します。

トリガー	モード
"what if", "ideas", "options"	BRAINSTORM
"build", "create", "add"	IMPLEMENT
"not working", "error", "bug"	DEBUG
"review", "check", "audit"	REVIEW
"explain", "how does", "learn"	TEACH
"deploy", "release", "production"	SHIP

---

マルチエージェント連携パターン

エージェント間の連携に最適化された最新のアーキテクチャ：

1. 🔭 EXPLORE モード

役割： 発見と分析（探索エージェント） 振る舞い： ソクラテス式の質問、コードの詳細な読み込み、依存関係のマッピング。 出力： discovery-report.json、アーキテクチャの可視化。

2. 🗺️ PLAN-EXECUTE-CRITIC (PEC)

複雑度の高いタスクにおける、循環的なモード遷移：

1. プランナー： タスクを個別のステップに分解します（task.md）。
2. 実行者： 実際のコーディングを行います（IMPLEMENT）。
3. 批評者： コードをレビューし、セキュリティとパフォーマンスを確認します（REVIEW）。

3. 🧠 メンタルモデルの同期

セッション間でコンテキストを保持するため、「メンタルモデル」の要約を作成し、読み込む振る舞いです。

---

モードの組み合わせ

モードは排他的ではありません。実際の多くのタスクでは、複数のモードを順番に組み合わせます。

フロー	モードの連鎖
新機能	BRAINSTORM → PLAN-EXECUTE-CRITIC → IMPLEMENT → REVIEW → SHIP
バグ修正	EXPLORE → DEBUG → IMPLEMENT → REVIEW
不慣れなコードベース	EXPLORE → TEACH → BRAINSTORM
リスクの高いリファクタリング	EXPLORE → PLAN-EXECUTE-CRITIC → IMPLEMENT → REVIEW

作業の状況が変わったらモードを切り替えます（たとえば、テストが失敗したら、すぐに IMPLEMENT から DEBUG に切り替えます）。長時間のセッションでは、MENTAL MODEL SYNC を使ってコンテキストを引き継ぎます。

モードの手動切り替え

ユーザーはモードを明示的に指定できます。

/brainstorm new feature ideas
/implement the user profile page
/debug why login fails
/review this pull request