Orchestro - Trello for Claude Code

🎭 Orchestro

AI 開発の指揮者 - プロダクトビジョンから本番コードまで

プロダクトマネージャー、開発者、AI をつなぐインテリジェントなオーケストレーションシステムで、プロダクトのアイデアを現実に変えます。Orchestro は開発のシンフォニー全体を指揮します。タスクの分解、依存関係の追跡、パターンの学習、リアルタイムの進捗の可視化を行います。

---

🎯 なぜ Orchestro なのか？

課題：

• プロダクトマネージャーは開発の進捗を把握できなくなります
• 開発者はコンテキストの切り替えや依存関係に苦労します
• Claude Code のセッション間でナレッジが失われます
• 開発中の内容を確認できる唯一の信頼できる情報源がありません

解決策：Orchestro は開発ライフサイクル全体をオーケストレーションします：

• 👔 PM 向け：ビジュアルなカンバンボード、ユーザーストーリーの分解、進捗の追跡
• 👨‍💻 開発者向け：AI を活用したタスク分析、依存関係グラフ、パターン学習
• 🤖 Claude Code 向け：構造化されたワークフロー、強化されたコンテキスト、ナレッジの保持
• 📊 すべての人向け：リアルタイムダッシュボード、透明性の高い進捗、完全な監査証跡

Trello × Jira × AI のようなものですが、AI 支援開発のために特別に設計されています。

---

✨ 主な機能

👔 プロダクトマネージャーとオーナー向け

• ユーザーストーリーの分解 - ストーリーを記述すると、AI が技術タスクを自動的に作成します
• ビジュアルな進捗ボード - リアルタイムで更新されるカンバンビュー
• 技術知識は不要 - コーディングなしで開発を管理できます
• 完全な透明性 - 何が、いつ、なぜ開発されているのかを正確に確認できます
• リスクの把握 - リスクを自動で検出し、平易な言葉で説明します

👨‍💻 開発者向け

• インテリジェントなタスク分析 - AI がコードベースを分析し、実装方法を提案します
• 依存関係の追跡 - 視覚的なグラフで依存関係を確認できます
• パターン学習 - システムが成功と失敗から学習します
• 競合の防止 - タスクが同じファイルを編集する場合に検出します
• コンテキストの保持 - セッション間でコンテキストが失われることはありません

🤖 Claude Code 向け

• 60 個の MCP ツール - オーケストレーションされた開発に必要なツール一式
• 構造化されたワークフロー - prepare → analyze → implement → learn
• 強化されたプロンプト - コンテキストを考慮した実装ガイダンス
• ナレッジベース - テンプレート、パターン、学習内容を永続的に保存

📊 すべての人向け

• リアルタイムダッシュボード - Socket.io 経由のライブ更新
• 完全な履歴 - すべての決定と変更のタイムライン
• ロールバック機能 - ミスを安全に元に戻せます
• すべてをエクスポート - 関係者向けの Markdown レポート

---

🎼 開発のシンフォニー

Orchestro が開発を指揮する仕組み

┌─────────────────────────────────────────────────────┐
│  PRODUCT MANAGER                                     │
│  "User should login with email/password"           │
└─────────────────────────────────────────────────────┘
                        ↓
            ┌──────────────────────┐
            │  ORCHESTRO AI        │
            │  Decomposes Story    │
            └──────────────────────┘
                        ↓
    ┌──────────────────────────────────────────┐
    │  7 Technical Tasks Created               │
    │  • Database schema                       │
    │  • Authentication service                │
    │  • API endpoints                         │
    │  • Frontend components                   │
    │  • State management                      │
    │  (with dependencies automatically)       │
    └──────────────────────────────────────────┘
                        ↓
            ┌──────────────────────┐
            │  DEVELOPER/CLAUDE    │
            │  Implements Tasks    │
            └──────────────────────┘
                        ↓
    ┌──────────────────────────────────────────┐
    │  PM SEES PROGRESS                        │
    │  • Kanban updates in real-time          │
    │  • Risks flagged automatically          │
    │  • Dependencies visualized              │
    └──────────────────────────────────────────┘

---

🚀 クイックスタート

オプション 1：MCP レジストリから ⭐（推奨）

Orchestro は現在、公式 MCP レジストリに登録されています！

# Install via NPX (no global install needed)
npx @khaoss85/orchestro@latest

または Claude Code の設定に追加します：

{
  "mcpServers": {
    "orchestro": {
      "command": "npx",
      "args": ["-y", "@khaoss85/orchestro@latest"],
      "env": {
        "DATABASE_URL": "your-supabase-connection-string"
      }
    }
  }
}

---

オプション 2：ワンコマンドインストール ⚡

npx @orchestro/init

これで完了です！ インストーラーは次の処理を行います：

• ✅ Orchestro をダウンロードしてセットアップ
• ✅ Supabase にデータベースのマイグレーションを適用
• ✅ Claude Code を自動的に設定
• ✅ Supabase 接続をセットアップ
• ✅ ダッシュボードを起動
• ✅ すべて正常に動作することを確認

対話型プロンプト：

🎭 Orchestro Setup Wizard

? Supabase connection string: ████████
? Project name: My Project
? Install location: ~/orchestro

⚙️  Setting up...
✓ Orchestro installed
✓ Claude Code configured
✓ Database ready

🎉 Done! Restart Claude Code and ask:
   "Show me orchestro tools"

---

オプション 2：手動インストール（5 分）

1. 前提条件

# Node.js 18+
node --version

# Supabase account (free tier works great)
# Sign up at https://supabase.com

2. Supabase でのデータベースのセットアップ

Supabase プロジェクトを作成します：

1. https://supabase.com にアクセスし、新しいプロジェクトを作成します
2. データベースのプロビジョニングが完了するまで待ちます（約 2 分）
3. Settings → Database に移動し、Connection String（Transaction モード）をコピーします

データベーススキーマを適用します：

# Clone this repo first
git clone https://github.com/khaoss85/mcp-orchestro.git
cd mcp-orchestro

# Install dependencies
npm install

# Set your Supabase connection string
export DATABASE_URL="your-supabase-connection-string"

# Apply all migrations to create the schema
npm run migrate

データベースのセットアップを確認します：

# The migrate script will show you all tables created:
# You should see:
# ✅ Running migration: code_entities
# ✅ Running migration: add_tasks_metadata
# ✅ Running migration: fix_status_transition_trigger
# ✅ Running migration: event_queue
# ✅ Running migration: auto_update_user_story_status
# ✅ Running migration: add_task_metadata_fields
# ✅ Running migration: add_pattern_frequency_tracking

# Or verify manually via Supabase dashboard:
# Go to Database → Tables and check all tables are created

認証情報を取得します：

# From Supabase Dashboard:

# 1. DATABASE_URL (for migrations & MCP server)
#    Settings → Database → Connection String → Transaction mode
#    Example: postgresql://postgres:[password]@db.[project].supabase.co:5432/postgres

# 2. SUPABASE_URL (for API calls)
#    Settings → API → Project URL
#    Example: https://[project].supabase.co

# 3. SUPABASE_SERVICE_KEY (for admin operations - keep secret!)
#    Settings → API → service_role key
#    Example: eyJhbG...

3. クイックセットアップスクリプト

# Run interactive setup
npm run setup

# Or manual configuration:
cat > .env << EOF
DATABASE_URL=your-supabase-connection-string
SUPABASE_URL=your-supabase-url
SUPABASE_SERVICE_KEY=your-service-key
EOF

4. Claude Code を設定します

# Auto-configure (recommended)
npm run configure-claude

# Or manually edit:
open ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Add:
{
  "mcpServers": {
    "orchestro": {
      "command": "node",
      "args": ["/absolute/path/to/orchestro/dist/server.js"],
      "env": {
        "DATABASE_URL": "your-connection-string"
      }
    }
  }
}

5. ダッシュボードを起動します

npm run dashboard
# 🌐 Opens http://localhost:3000

6. インストールを確認します

# Restart Claude Code, then ask:
"Show me all orchestro tools"

# You should see 60 tools! 🎭

---

オプション 3：既存のプロジェクトに追加する

すでに Claude Code プロジェクトをお持ちですか？ Orchestro を追加しましょう：

# In your project directory
npx @orchestro/add

# Or via Claude Code config:
claude mcp add orchestro

既存のプロジェクトのセットアップについては、統合ガイド をご覧ください。

---

オプション 4：Claude Code プラグイン 🎁（最も簡単！）

新機能！ Orchestro を Claude Code プラグインとして、1 つのコマンドでインストールできます：

# In Claude Code terminal
/plugin marketplace add khaoss85/mcp-orchestro

# Install the Orchestro Suite
/plugin install orchestro-suite@orchestro-marketplace

# Restart Claude Code when prompted

利用できる機能：

• ✅ Orchestro MCP サーバー - npx @khaoss85/orchestro@latest で 60 個のツールを利用可能（グローバルインストール不要）
• ✅ 5 つのガーディアンエージェント - database、API、architecture、test-maintainer、production-ready
• ✅ 自動設定済み - MCP サーバーとエージェントをすぐに使用できます
• ✅ 完全なドキュメント - セットアップガイドが含まれます

前提条件：

• Supabase アカウント（セットアップについてはオプション 2 を参照）
• 環境変数の設定：

  export SUPABASE_URL="https://your-project.supabase.co"
  export SUPABASE_SERVICE_KEY="your-service-key"
  export ANTHROPIC_API_KEY="your-key"
  

インストールを確認します：

# Check agents
/agents
# Should show: database-guardian, api-guardian, architecture-guardian,
#              test-maintainer, production-ready-code-reviewer

# Test MCP tools
mcp__orchestro__get_project_info
mcp__orchestro__list_tasks

プラグインに含まれるもの：

• MCP サーバーの設定（.mcp.json）
• 5 つの専門ガーディアンエージェント
• 使用例を含む完全な README
• トラブルシューティングガイド

プラグインの詳細なドキュメントについては、plugins/orchestro-suite/README.md をご覧ください。

---

🎭 使用例

📱 プロダクトマネージャー向け

シナリオ：ステークホルダーからの新機能リクエスト

1. Write user story in dashboard:
   "User should be able to export report as PDF"

2. Click "Decompose with AI"
   → Orchestro creates 5 technical tasks with dependencies

3. Monitor Kanban board:
   → See real-time progress as Claude implements
   → Risks flagged automatically (e.g., "PDF library size impact")
   → Hover over task for technical details

4. Review & Accept:
   → See code diffs in plain English
   → Rollback if needed
   → Export timeline for stakeholder report

💻 開発者向け

シナリオ：複雑な機能の実装

1. Pick task from Kanban board

2. Ask Claude:
   "Prepare task [task-id] for execution"
   → Orchestro analyzes codebase
   → Shows: files to modify, dependencies, risks

3. Get enriched context:
   → Past similar implementations
   → Relevant patterns (with success rates!)
   → Risk mitigation strategies

4. Implement with confidence:
   → Conflict detection warns if other tasks touch same files
   → Pattern learning suggests best approaches
   → Complete history for rollback safety

🤝 チーム向け

シナリオ：部門横断のコラボレーション

PM writes story → AI decomposes → Dev implements → All see progress

• PM: Non-technical Kanban view
• Dev: Technical dependency graph
• Claude: Enriched implementation context
• Everyone: Real-time updates, complete transparency

---

🛠️ MCP ツール全 60 個 ✅ 本番環境でテスト済み

📋 プロジェクト管理（3 個のツール）

• get_project_info - プロジェクトのメタデータとステータス
• get_project_configuration - プロジェクトの完全な設定
• initialize_project_configuration - デフォルトのツールとガーディアンをセットアップ

📝 タスク管理（7 個のツール）

• create_task - 担当者、優先度、タグ、カテゴリを指定して作成
• list_tasks - ステータス／カテゴリ／タグで絞り込み
• update_task - 検証を行いながら任意のフィールドを変更
• delete_task - 依存関係を確認して安全に削除
• get_task_context - 依存関係を含む完全なコンテキスト（非推奨。代わりに prepare_task_for_execution を使用）
• get_execution_order - 依存関係に基づくトポロジカルソート
• safe_delete_tasks_by_status - 安全性を確認して一括削除

⚙️ タスクの実行と分析（3 個のツール）

• prepare_task_for_execution - コードベース分析用プロンプトを生成
• save_task_analysis - 分析結果を保存
• get_execution_prompt - 実装コンテキストを拡充

📖 ユーザーストーリー（4 個のツール）

• decompose_story - AI を活用したストーリーからタスクへの分解と自動分析（autoAnalyze=true がデフォルト）
• get_user_stories - すべてのユーザーストーリーを一覧表示
• get_tasks_by_user_story - すべての子タスクを取得
• get_user_story_health - ストーリーの完了状況を監視

🔗 依存関係と競合（4 個のツール）

• save_dependencies - タスクのリソース依存関係を記録
• get_task_dependency_graph - 依存関係グラフを可視化
• get_resource_usage - リソースを使用しているタスクを検索
• get_task_conflicts - リソース使用の競合を検出

📚 ナレッジとテンプレート（5 個のツール）

• list_templates - 利用可能なプロンプト／コードテンプレート
• list_patterns - コーディングパターンのライブラリ
• list_learnings - 過去の経験の記録
• render_template - 変数を使ってテンプレートから生成
• get_relevant_knowledge - コンテキストに応じた提案

🧠 フィードバックと学習（7 ツール）

• add_feedback - 成功／失敗／改善を記録します
• get_similar_learnings - 関連する経験を検索します
• get_top_patterns - 最も頻繁に使用されているパターンを取得します
• get_trending_patterns - 最近人気のパターンを取得します
• get_pattern_stats - パターンの詳細な指標を取得します
• detect_failure_patterns - リスクの高いアプローチを自動検出します
• check_pattern_risk - パターンを使用する前にリスクを評価します

⚙️ プロジェクト設定（14 ツール）

技術スタック：

• add_tech_stack - フレームワーク／ライブラリを追加します
• update_tech_stack - バージョン／設定を更新します
• remove_tech_stack - 技術を削除します

サブエージェント（ガーディアン）：

• add_sub_agent - ガーディアンエージェントを登録します
• update_sub_agent - エージェント設定を変更します
• sync_claude_code_agents - .claude/agents/ から同期します
• read_claude_code_agents - エージェントファイルを読み込みます
• suggest_agents_for_task - AI を活用してタスクに適したエージェントを提案します
• update_agent_prompt_templates - プロンプトテンプレートを更新します

MCP ツール管理：

• add_mcp_tool - MCP ツールを登録します
• update_mcp_tool - ツール設定を更新します
• suggest_tools_for_task - AI を活用してタスクに適したツールを提案します

ガイドラインとパターン：

• add_guideline - コーディングガイドラインを追加します
• add_code_pattern - 再利用可能なパターンを追加します

📊 タスク履歴とイベント（13 ツール）

• get_task_history - イベントの全タイムラインを取得します
• get_status_history - ステータス遷移のログを取得します
• get_decisions - 決定事項の記録を取得します
• get_guardian_interventions - ガーディアンの活動ログを取得します
• get_code_changes - コード変更履歴を取得します
• record_decision - 根拠とともに決定事項を記録します
• record_code_change - コード変更を記録します
• record_guardian_intervention - ガーディアンのアクションを記録します
• record_status_transition - ステータス変更を記録します
• get_iteration_count - タスクの反復回数を取得します
• get_task_snapshot - 指定した時点のタスク状態を取得します
• rollback_task - 以前の状態に戻します
• get_task_stats - 集計統計を取得します

---

📊 ダッシュボードの機能

カンバンボード - すべての人向け

PM ビュー：

• ユーザーストーリーをドラッグ＆ドロップ
• 進捗をひと目で確認
• リスクをわかりやすい言葉で表示
• ステークホルダー向けレポートをエクスポート

開発者ビュー：

• 技術的なタスクの詳細
• 依存関係インジケーター
• コードの複雑度バッジ
• ファイルへの直接リンク

タスク詳細ページ - 詳細な分析

タブ：概要（PM 向け）

• ユーザーストーリーの説明
• 技術要件
• 担当者と優先度
• 依存関係の説明

タブ：履歴（監査証跡）

• イベントの全タイムライン
• 根拠を含む決定事項の記録
• コード変更（差分付き）
• ロールバック機能

タブ：依存関係（開発者向け）

• 依存関係のビジュアルグラフ
• リソースへの影響分析
• リスク評価
• 競合の検出

---

🏗️ アーキテクチャ

┌─────────────────────────────────────────┐
│         PRODUCT MANAGER                 │
│  • Writes user stories                  │
│  • Monitors Kanban board                │
│  • Reviews progress                     │
└─────────────────────────────────────────┘
              ↓ (Dashboard)
┌─────────────────────────────────────────┐
│      ORCHESTRO DASHBOARD (Next.js)      │
│  • Kanban board with real-time updates │
│  • Dependency graphs                    │
│  • Progress visualization               │
└─────────────────────────────────────────┘
              ↓ ↑ (Socket.io)
┌─────────────────────────────────────────┐
│         SUPABASE (Data Layer)           │
│  • Tasks, dependencies, resources       │
│  • Event queue & real-time sync         │
│  • Knowledge base & pattern tracking    │
└─────────────────────────────────────────┘
              ↓ ↑ (PostgreSQL)
┌─────────────────────────────────────────┐
│    ORCHESTRO MCP SERVER (Conductor)     │
│  • 27 tools for task orchestration      │
│  • Pattern learning & risk detection    │
│  • AI story decomposition               │
└─────────────────────────────────────────┘
              ↓ ↑ (MCP Protocol)
┌─────────────────────────────────────────┐
│      CLAUDE CODE (Developer + AI)       │
│  • Analyzes codebase                    │
│  • Implements features                  │
│  • Records decisions                    │
└─────────────────────────────────────────┘

---

💡 実際の活用例

ストーリー：E コマースのチェックアウトフロー

PM がダッシュボードに記入：

"Customer should complete purchase with
credit card payment and email confirmation"

Orchestro による分解（AI を活用）：

1. ✅ チェックアウトのデータベーススキーマを設計（2h） - 依存関係なし
2. ✅ 決済サービスとの連携を実装（4h） - 依存先：#1
3. ✅ チェックアウト API エンドポイントを作成（3h） - 依存先：#2
4. ✅ チェックアウト UI コンポーネントを構築（4h） - 依存先：#3
5. ✅ メール通知サービスを追加（2h） - 依存先：#3
6. ✅ 注文確認フローを実装（3h） - 依存先：#4、#5

合計：18 時間、6 タスク、依存関係は自動でマッピング

開発者のワークフロー（autoAnalyze=true の場合）：

// 1. Decompose story (auto-analyzes tasks)
decompose_story("Customer checkout with payment")
// → Creates 6 tasks
// → Auto-generates analysis prompts for tasks without dependencies
// → Returns analysisPrompts[] ready to use

// 2. Claude reviews analysis prompts
// Prompts include: files to check, patterns to find, risks to identify

// 3. Claude analyzes codebase using the prompts
// Finds: existing payment tables, similar schemas
// Risks: None (new table)

// 4. Save analysis results
save_task_analysis({
  taskId: "task-1-id",
  filesToCreate: ["migrations/002_checkout.sql"],
  dependencies: [{type: "file", name: "001_orders.sql", action: "uses"}],
  risks: []
})

// 5. Get enriched context
get_execution_prompt("task-1-id")
// → Returns: related code, patterns, guidelines

// 6. Implement!
// Claude writes migration, runs tests

// 7. Record learning
add_feedback({
  pattern: "e-commerce checkout schema",
  type: "success",
  feedback: "Stripe integration smooth"
})

主な改善点：ステップ 1 で分析が自動的に準備されるようになり、手動のワークフロー手順が削減されました！

PM の画面：

• ✅ タスク 1 → 完了（リアルタイム更新）
• 🟡 タスク 2 → 進行中（Claude が作業中）
• ⏳ タスク 3～6 → ブロック中（依存関係の解消待ち）
• 📊 進捗：17%（6 タスク中 1 タスク完了）

---

🧪 パターン学習の動作例

失敗の自動検出（時間を節約！）

// Scenario: Regex parsing keeps failing

// Attempt 1
add_feedback({
  pattern: "regex pattern matching",
  type: "failure",
  feedback: "Unescaped metacharacters broke parser"
})

// Attempt 2
add_feedback({
  pattern: "regex pattern matching",
  type: "failure",
  feedback: "Special chars not sanitized"
})

// Attempt 3
add_feedback({
  pattern: "regex pattern matching",
  type: "success",
  feedback: "Finally worked after sanitizing"
})

// Now Orchestro knows...
detect_failure_patterns()
// 🚨 Returns:
// {
//   pattern: "regex pattern matching",
//   failure_rate: 66.67%,
//   risk_level: "medium",
//   recommendation: "⚡ Review sanitization first!"
// }

// Next time, before using regex:
check_pattern_risk("regex pattern matching")
// ⚠️ Warning: "67% failure rate (2/3).
//    Common issue: Unescaped metacharacters.
//    Mitigation: Use sanitization helper first."

結果：今後の正規表現タスクを、より少ないエラーで短時間に完了できます！

---

🎨 技術スタック

バックエンド（MCP サーバー）

• TypeScript 5.0
• @modelcontextprotocol/sdk
• Supabase（PostgreSQL）
• リアルタイム通信に Socket.io

フロントエンド（ダッシュボード）

• Next.js 14（App Router）
• React 18 + TypeScript
• TailwindCSS + shadcn/ui
• React Flow（グラフ）
• react-markdown（レンダリング）

データベース（Supabase/PostgreSQL）

• コア：projects、tasks、task_dependencies
• ナレッジ：learnings、patterns、templates、pattern_frequency
• リソース：resource_nodes、resource_edges、code_entities、code_dependencies
• システム：event_queue、file_history、codebase_analysis
• 技術：JSONB メタデータ、GIN インデックス、行レベルセキュリティ（RLS）

AI 統合

• Claude Code（MCP プロトコル）
• AI によるタスク分解
• パターン認識
• リスク評価

---

📈 パフォーマンスとスケーラビリティ

• ⚡ クエリ速度：GIN インデックスを使用して <10ms
• 🔄 リアルタイム：1s のポーリング間隔
• 🗄️ ストレージ：処理済みイベントを自動クリーンアップ（24h）
• 📊 スケーラビリティ：100 件以上のタスクでテスト済み
• 🚀 分析：ノンブロッキング（Claude に委任）
• 👥 ユーザー：複数の PM、複数の開発者に対応

---

🔐 セキュリティとコンプライアンス

• ✅ 環境変数 - シークレットをハードコードしません
• ✅ Supabase RLS - 行レベルセキュリティポリシー
• ✅ 完全な監査証跡 - すべての判断を記録
• ✅ イベント処理 - アクションの重複を防止
• ✅ ローカルファースト - すべてのデータはお使いの Supabase インスタンス内に保存
• ✅ GDPR 対応 - エクスポートと削除が可能

---

📚 ドキュメント

はじめに

• QUICK_START.md - 5 分でできるセットアップガイド
• PM_GUIDE.md - プロダクトマネージャー向け (近日公開)
• DEV_GUIDE.md - 開発者向け (近日公開)
• EXAMPLES.md - 実際の使用例

詳細

• WORKFLOW.md - ワークフローの詳細な説明
• ARCHITECTURE.md - 技術アーキテクチャ
• API.md - MCP ツールのリファレンス

---

🗺️ ロードマップ

✅ フェーズ 1：コアオーケストレーション（完了）

• 60 個の MCP ツールが完全に機能し、テスト済み
• カンバンを備えたリアルタイムダッシュボード
• 依存関係を含む AI によるストーリー分解
• パターン学習と失敗検出
• 依存関係の追跡と競合検出
• タスクのメタデータ（担当者、優先度、タグ、カテゴリー）
• タスク履歴を含む完全な監査証跡
• プロジェクト構成管理
• Claude Code エージェント同期
• AI を活用したエージェントとツールの提案

🚧 フェーズ 2：PM の支援（現在）

• 技術知識を必要としない PM 向けダッシュボード表示
• 一般的な機能向けのストーリーテンプレート
• 進捗レポートとエクスポート
• ステークホルダーへの通知
• 平易な英語によるリスクの説明

🔮 フェーズ 3：チームインテリジェンス

• 複数チームのワークスペース
• プロジェクト間のパターン共有
• ベロシティの追跡と見積もり
• 専門知識に基づく自動割り当て
• Slack/Teams との統合

🚀 フェーズ 4：高度な AI

• LangGraph による自動オーケストレーション
• 予測型リスク検出
• 競合の自動解決
• コードレビューの自動化
• ドキュメントの生成

---

🤝 コントリビューション

PM、開発者、AI 愛好家の皆さまからのコントリビューションを歓迎します！

プロダクトマネージャーの方へ：

• 📝 ユーザーストーリーテンプレートの共有
• 💡 PM にとって使いやすい機能の提案
• 📊 UX の問題の報告

開発者の方へ：

• 🔧 バグ修正の提出
• ✨ 新しい MCP ツールの追加
• 📈 パターン検出の改善

コントリビューションの方法：

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

---

📝 変更履歴

v2.1.0 (2025-10-10) - 現在 🎉

• ✅ MCP Registry に公開 - 公式 MCP Registry に掲載されました
• ✅ NPM パッケージ - npm で @khaoss85/orchestro として公開されました
• ✅ 60 個の MCP ツール - 本番環境ですぐに使えるツールを 27 個から 60 個に拡張しました
• ✅ タスク分析の自動化 - decompose_story が分析プロンプトを自動で準備するようになりました（autoAnalyze=true がデフォルト）
• ✅ プロジェクト設定システム - 技術スタック、エージェント、ツールを包括的に管理できます
• ✅ Claude Code エージェントの同期 - .claude/agents/ ディレクトリと自動で同期します
• ✅ AI エージェント／ツールの提案 - タスクに対してスマートな推奨を行います
• ✅ タスク履歴とイベント - 13 個の履歴ツールで完全な監査証跡を提供します
• ✅ ユーザーストーリーの健全性 - 完了状況とステータスの整合性を監視します
• ✅ バグ修正 - get_project_configuration の SQL エラーを解決しました
• ✅ 完全なテストカバレッジ - 60 個すべてのツールをテストして検証済みです（成功率 96.7%）

v2.0.0 (2025-10-03)

• ✅ Orchestro にブランド変更 - 「あなたの AI 開発指揮者」
• ✅ パターン分析ツール - 失敗検出のための新しい MCP ツールを 5 個追加
• ✅ パターン頻度 - データベーストリガーによる自動追跡
• ✅ リスク評価 - detect_failure_patterns と check_pattern_risk
• ✅ タスクメタデータ - assignee、priority、tags フィールド
• ✅ PM 向けドキュメント - プロダクトオーナー向けに更新

v1.5.0 (2025-10-02)

• ✅ 新しいワークフロー：MCP がオーケストレーションし、Claude Code が分析します
• ✅ 3 つの実行ツール：prepare、save_analysis、get_execution_prompt
• ✅ tasks.metadata JSONB 列
• ✅ イベントキューを更新（イベント種別は 8 個）
• ✅ Guardian による検証に合格

v1.0.0

• MCP の初期実装
• 基本的なタスク管理
• AI によるストーリーの分解
• ナレッジベースとの統合

---

🌟 成功事例

「PM として、開発者が何を作っているのかをリアルタイムでようやく把握できるようになりました。Orchestro は、プロダクトビジョンと技術的な実装の間のギャップを埋めてくれます。」 — あなたの推薦コメントはこちら

「パターン学習のおかげで何時間も節約できました。時間を無駄にする前に、システムがリスクの高いアプローチを警告してくれました。」 — あなたの推薦コメントはこちら

---

📞 サポートとコミュニティ

• 📧 問題報告：GitHub Issues
• 💬 ディスカッション：GitHub Discussions
• 📖 ドキュメント：リポジトリに包括的なガイドがあります
• 🌐 ダッシュボード：http://localhost:3000
• 🐦 Twitter：@orchestro_ai (近日公開)

---

📜 ライセンス

MIT License - 詳細は LICENSE ファイルをご覧ください

---

🙏 謝辞

• Claude Code - MCP プラットフォームと AI 開発
• Supabase - データベースとリアルタイムインフラストラクチャ
• Next.js - ダッシュボード向け React フレームワーク
• React Flow - 美しい依存関係グラフ
• shadcn/ui - 優れた UI コンポーネント

---