philosophy.md

English | 한국어 | 中文 | 日本語 | Español

設計思想

このドキュメントでは、Codingbuddyのビジョン、核となる信念、設計原則を説明します。

ビジョン

コードのためのAIエキスパートチーム

単一のAIがすべてのエキスパートになることはできません。AIにコードを依頼すると、単一の視点しか得られません—セキュリティレビューもなく、アクセシビリティチェックもなく、アーキテクチャ検証もありません。一つのAIがすべてを「まあまあ」こなすだけで、何も優れていません。

人間の開発チームにはスペシャリストがいます：

• システムを設計するアーキテクト
• 脆弱性を見つけるセキュリティエンジニア
• エッジケースを捕捉するQAスペシャリスト
• ボトルネックを最適化するパフォーマンスエキスパート

CodingbuddyはAIコーディングにスペシャリストチームモデルを導入します。

一つのAIがすべてを試みる代わりに、Codingbuddyは35の専門エージェントを調整し、コードがプロフェッショナルな基準に達するまで協力してレビュー、検証、改善します。

核となる信念

1. マルチエージェントコラボレーション

品質は複数の視点から生まれます。3層エージェントシステムが包括的なカバレッジを保証します：

層	目的	例
モードエージェント	ワークフローオーケストレーション	plan-mode, act-mode, eval-mode
主要エージェント	コア実装	solution-architect, frontend-developer, backend-developer
スペシャリストエージェント	ドメイン専門知識	security, accessibility, performance, test-strategy

各エージェントは集中した専門知識を提供し、単一のAIでは達成できないことを協力して実現します。

2. 品質駆動開発

PLAN → ACT → EVALサイクルが各ステップで品質を保証します：

PLAN: コーディング前の設計（アーキテクチャ、テスト戦略）
  ↓
ACT: TDDと品質基準で実装
  ↓
EVAL: マルチスペシャリストレビュー（セキュリティ、パフォーマンス、アクセシビリティ）
  ↓
反復: Critical=0 AND High=0まで

3. 終了基準

品質目標達成時のみ出荷：

重大度	出荷前に修正必須
🔴 Critical	はい - 即時のセキュリティ/データ問題
🟠 High	はい - 重大な問題
🟡 Medium	オプション - 技術的負債
🟢 Low	オプション - 改善

4. 段階的開示

シンプルに始め、必要に応じて深く：

• クイックスタート: npx codingbuddy initで2分で実行
• ワークフローモード: PLAN → ACT → EVAL構造化開発
• スペシャリストエージェント: 35のドメインエキスパートにオンデマンドアクセス
• AUTOモード: 品質達成まで自律的に反復

5. 設定より規約

ほとんどのプロジェクトで機能する合理的なデフォルト：

• PLAN → ACT → EVALワークフロー
• TDDファースト開発アプローチ
• 90%以上のテストカバレッジ目標
• SOLID原則とクリーンコード

変更が必要な部分のみオーバーライドします。

設計原則

エージェントアーキテクチャ

┌─────────────────────────────────────────┐
│           モードエージェント (4)          │
│  plan-mode, act-mode, eval-mode,        │
│  auto-mode                              │
└─────────────────────────────────────────┘
                    │
                    ▼
┌─────────────────────────────────────────┐
│         主要エージェント (16)            │
│  solution-architect, frontend-developer │
│  backend-developer, code-reviewer, ...  │
└─────────────────────────────────────────┘
                    │
                    ▼
┌─────────────────────────────────────────┐
│      スペシャリストエージェント (15)      │
│   security, accessibility, performance  │
│   test-strategy, event-architecture ... │
└─────────────────────────────────────────┘

関心の分離

レイヤー	目的	形式
ルール	何をするか（ワークフロー、品質基準）	Markdown
エージェント	誰が何を知っているか（専門知識）	JSON
アダプター	どう統合するか（ツール固有のセットアップ）	Markdown

この分離により：

• ツールサポートとは独立してルールを進化
• コアルールを変更せずに新しいエージェントを追加
• 既存ルールを修正せずに新しいツールをサポート

複雑さより拡張性

システムは設定ではなく拡張のために設計されています：

• JSONファイルを作成して新しいスペシャリストエージェントを追加
• アダプターガイドを作成して新しいAIツールをサポート
• コアルールを修正せずにプロジェクト固有のコンテキストを含める

シンプルなことはシンプルに。複雑なことは可能に。

ワークフローモデル

CodingbuddyはAI支援開発のための構造化されたワークフローを導入します：

PLANモード（デフォルト）

• 要件を理解
• 実装アプローチを設計
• リスクとエッジケースを特定
• コード変更なし
• 活性化: ソリューションアーキテクト + 関連スペシャリスト

ACTモード

• 計画を実行
• TDDを遵守: Red → Green → Refactor
• 段階的でテスト済みの変更
• 活性化: 主要デベロッパー + 品質スペシャリスト

EVALモード

• 実装品質をレビュー
• 多次元評価（セキュリティ、パフォーマンス、アクセシビリティ）
• 重大度レベル付きで改善点を特定
• 活性化: コードレビュアー + 並列スペシャリスト

AUTOモード

• 自律的なPLAN → ACT → EVALサイクル
• 継続: Critical=0 AND High=0まで
• 最大反復のセーフガード
• 反復的改善が必要な複雑な機能に最適

このワークフローは、AIアシスタントが適切な計画なしにすぐコードに飛び込む一般的な落とし穴を防ぎます。

差別化ポイント

従来のAIコーディング	Codingbuddy
単一AIの視点	35のスペシャリストエージェントの視点
「生成して祈る」	計画 → 実装 → 検証
品質ゲートなし	Critical=0, High=0必須
手動レビューが必要	自動多次元レビュー
一貫性のない品質	基準達成まで反復改善

Codingbuddyではないもの

• コードジェネレーターではない: 構造、専門知識、品質ゲートを提供—魔法のコードではない
• 人間の判断の代替ではない: スペシャリストの視点で開発者の意思決定を補強
• 万能ソリューションではない: プロジェクトごとのカスタマイズのために設計

参考資料

• はじめに - クイックセットアップガイド
• 対応ツール - AIツール統合
• コアルール - ワークフロー詳細
• エージェントシステム - 完全なエージェントリファレンス