{"id":31580975,"url":"https://github.com/khaoss85/mcp-orchestro","last_synced_at":"2026-05-14T23:15:16.422Z","repository":{"id":318006793,"uuid":"1068648086","full_name":"khaoss85/mcp-orchestro","owner":"khaoss85","description":"Transform product ideas into reality with an intelligent orchestration system that bridges Product Managers, Developers, and AI. Orchestro conducts the entire development symphony: task decomposition, dependency tracking, pattern learning, and real-time progress visualization.","archived":false,"fork":false,"pushed_at":"2025-10-04T12:21:32.000Z","size":9055,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-10-04T14:19:27.560Z","etag":null,"topics":["claude-code","development","mcp-server","mcp-tools"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/khaoss85.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-10-02T17:41:16.000Z","updated_at":"2025-10-04T12:21:35.000Z","dependencies_parsed_at":"2025-10-04T14:19:32.469Z","dependency_job_id":"326c8470-8a75-4991-bf74-c934eccc8d7b","html_url":"https://github.com/khaoss85/mcp-orchestro","commit_stats":null,"previous_names":["khaoss85/mcp-orchestro"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/khaoss85/mcp-orchestro","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaoss85%2Fmcp-orchestro","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaoss85%2Fmcp-orchestro/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaoss85%2Fmcp-orchestro/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaoss85%2Fmcp-orchestro/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/khaoss85","download_url":"https://codeload.github.com/khaoss85/mcp-orchestro/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/khaoss85%2Fmcp-orchestro/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":278526242,"owners_count":26001325,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-05T02:00:06.059Z","response_time":54,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["claude-code","development","mcp-server","mcp-tools"],"created_at":"2025-10-05T21:51:44.549Z","updated_at":"2026-05-14T23:15:16.411Z","avatar_url":"https://github.com/khaoss85.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🎭 Orchestro\n\n\u003e **Your AI Development Conductor** - From Product Vision to Production Code\n\nTransform product ideas into reality with an intelligent orchestration system that bridges Product Managers, Developers, and AI. Orchestro conducts the entire development symphony: task decomposition, dependency tracking, pattern learning, and real-time progress visualization.\n\n[![Status](https://img.shields.io/badge/status-production%20ready-brightgreen)]()\n[![MCP Registry](https://img.shields.io/badge/MCP-Registry-blue)](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.khaoss85/orchestro)\n[![NPM Package](https://img.shields.io/npm/v/@khaoss85/orchestro?label=npm)](https://www.npmjs.com/package/@khaoss85/orchestro)\n[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)]()\n[![MCP Tools](https://img.shields.io/badge/MCP%20Tools-60-purple)]()\n[![License](https://img.shields.io/badge/license-MIT-blue)]()\n\n---\n\n## 🎯 Why Orchestro?\n\n**The Problem**:\n- Product Managers lose track of development progress\n- Developers struggle with context switching and dependencies\n- Knowledge is lost between Claude Code sessions\n- No single source of truth for what's being built\n\n**The Solution**: Orchestro orchestrates the entire development lifecycle:\n- 👔 **For PMs**: Visual Kanban board, user story decomposition, progress tracking\n- 👨‍💻 **For Developers**: AI-powered task analysis, dependency graphs, pattern learning\n- 🤖 **For Claude Code**: Structured workflows, enriched context, knowledge retention\n- 📊 **For Everyone**: Real-time dashboard, transparent progress, complete audit trail\n\n**Think Trello × Jira × AI** - but designed specifically for AI-assisted development.\n\n---\n\n## ✨ Key Features\n\n### 👔 For Product Managers \u0026 Owners\n- **User Story Decomposition** - Write a story, AI creates technical tasks automatically\n- **Visual Progress Board** - Kanban view with real-time updates\n- **No Technical Knowledge Required** - Manage development without coding\n- **Complete Transparency** - See exactly what's being built, when, and why\n- **Risk Awareness** - Auto-flagged risks with plain English explanations\n\n### 👨‍💻 For Developers\n- **Intelligent Task Analysis** - AI analyzes codebase and suggests implementation\n- **Dependency Tracking** - Visual graphs show what depends on what\n- **Pattern Learning** - System learns from successes and failures\n- **Conflict Prevention** - Detects when tasks touch the same files\n- **Context Retention** - Never lose context between sessions\n\n### 🤖 For Claude Code\n- **60 MCP Tools** - Complete toolkit for orchestrated development\n- **Structured Workflows** - prepare → analyze → implement → learn\n- **Enriched Prompts** - Context-aware implementation guidance\n- **Knowledge Base** - Templates, patterns, learnings persist forever\n\n### 📊 For Everyone\n- **Real-Time Dashboard** - Live updates via Socket.io\n- **Complete History** - Timeline of all decisions and changes\n- **Rollback Capability** - Undo mistakes safely\n- **Export Everything** - Markdown reports for stakeholders\n\n---\n\n## 🎼 The Development Symphony\n\n### How Orchestro Conducts Your Development\n\n```\n┌─────────────────────────────────────────────────────┐\n│  PRODUCT MANAGER                                     │\n│  \"User should login with email/password\"           │\n└─────────────────────────────────────────────────────┘\n                        ↓\n            ┌──────────────────────┐\n            │  ORCHESTRO AI        │\n            │  Decomposes Story    │\n            └──────────────────────┘\n                        ↓\n    ┌──────────────────────────────────────────┐\n    │  7 Technical Tasks Created               │\n    │  • Database schema                       │\n    │  • Authentication service                │\n    │  • API endpoints                         │\n    │  • Frontend components                   │\n    │  • State management                      │\n    │  (with dependencies automatically)       │\n    └──────────────────────────────────────────┘\n                        ↓\n            ┌──────────────────────┐\n            │  DEVELOPER/CLAUDE    │\n            │  Implements Tasks    │\n            └──────────────────────┘\n                        ↓\n    ┌──────────────────────────────────────────┐\n    │  PM SEES PROGRESS                        │\n    │  • Kanban updates in real-time          │\n    │  • Risks flagged automatically          │\n    │  • Dependencies visualized              │\n    └──────────────────────────────────────────┘\n```\n\n---\n\n## 🚀 Quick Start\n\n### Option 1: From MCP Registry ⭐ (Recommended)\n\n**Orchestro is now in the [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.khaoss85/orchestro)!**\n\n```bash\n# Install via NPX (no global install needed)\nnpx @khaoss85/orchestro@latest\n```\n\n**Or add to Claude Code config**:\n```json\n{\n  \"mcpServers\": {\n    \"orchestro\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@khaoss85/orchestro@latest\"],\n      \"env\": {\n        \"DATABASE_URL\": \"your-supabase-connection-string\"\n      }\n    }\n  }\n}\n```\n\n---\n\n### Option 2: One-Command Install ⚡\n\n```bash\nnpx @orchestro/init\n```\n\n**That's it!** The installer will:\n- ✅ Download and setup Orchestro\n- ✅ Apply database migrations to Supabase\n- ✅ Configure Claude Code automatically\n- ✅ Setup Supabase connection\n- ✅ Start the dashboard\n- ✅ Verify everything works\n\n**Interactive prompts:**\n```\n🎭 Orchestro Setup Wizard\n\n? Supabase connection string: ████████\n? Project name: My Project\n? Install location: ~/orchestro\n\n⚙️  Setting up...\n✓ Orchestro installed\n✓ Claude Code configured\n✓ Database ready\n\n🎉 Done! Restart Claude Code and ask:\n   \"Show me orchestro tools\"\n```\n\n---\n\n### Option 2: Manual Install (5 Minutes)\n\n#### 1. Prerequisites\n```bash\n# Node.js 18+\nnode --version\n\n# Supabase account (free tier works great)\n# Sign up at https://supabase.com\n```\n\n#### 2. Database Setup on Supabase\n\n**Create your Supabase project:**\n1. Go to https://supabase.com and create a new project\n2. Wait for the database to be provisioned (~2 minutes)\n3. Go to **Settings** → **Database** and copy the **Connection String** (Transaction mode)\n\n**Apply database schema:**\n```bash\n# Clone this repo first\ngit clone https://github.com/khaoss85/mcp-orchestro.git\ncd mcp-orchestro\n\n# Install dependencies\nnpm install\n\n# Set your Supabase connection string\nexport DATABASE_URL=\"your-supabase-connection-string\"\n\n# Apply all migrations to create the schema\nnpm run migrate\n```\n\n**Verify database setup:**\n```bash\n# The migrate script will show you all tables created:\n# You should see:\n# ✅ Running migration: code_entities\n# ✅ Running migration: add_tasks_metadata\n# ✅ Running migration: fix_status_transition_trigger\n# ✅ Running migration: event_queue\n# ✅ Running migration: auto_update_user_story_status\n# ✅ Running migration: add_task_metadata_fields\n# ✅ Running migration: add_pattern_frequency_tracking\n\n# Or verify manually via Supabase dashboard:\n# Go to Database → Tables and check all tables are created\n```\n\n**Get your credentials:**\n```bash\n# From Supabase Dashboard:\n\n# 1. DATABASE_URL (for migrations \u0026 MCP server)\n#    Settings → Database → Connection String → Transaction mode\n#    Example: postgresql://postgres:[password]@db.[project].supabase.co:5432/postgres\n\n# 2. SUPABASE_URL (for API calls)\n#    Settings → API → Project URL\n#    Example: https://[project].supabase.co\n\n# 3. SUPABASE_SERVICE_KEY (for admin operations - keep secret!)\n#    Settings → API → service_role key\n#    Example: eyJhbG...\n```\n\n#### 3. Quick Setup Script\n```bash\n# Run interactive setup\nnpm run setup\n\n# Or manual configuration:\ncat \u003e .env \u003c\u003c EOF\nDATABASE_URL=your-supabase-connection-string\nSUPABASE_URL=your-supabase-url\nSUPABASE_SERVICE_KEY=your-service-key\nEOF\n```\n\n#### 4. Configure Claude Code\n```bash\n# Auto-configure (recommended)\nnpm run configure-claude\n\n# Or manually edit:\nopen ~/Library/Application\\ Support/Claude/claude_desktop_config.json\n\n# Add:\n{\n  \"mcpServers\": {\n    \"orchestro\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/orchestro/dist/server.js\"],\n      \"env\": {\n        \"DATABASE_URL\": \"your-connection-string\"\n      }\n    }\n  }\n}\n```\n\n#### 5. Start Dashboard\n```bash\nnpm run dashboard\n# 🌐 Opens http://localhost:3000\n```\n\n#### 6. Verify Installation\n```\n# Restart Claude Code, then ask:\n\"Show me all orchestro tools\"\n\n# You should see 60 tools! 🎭\n```\n\n---\n\n### Option 3: Add to Existing Project\n\nAlready have a Claude Code project? Add Orchestro:\n\n```bash\n# In your project directory\nnpx @orchestro/add\n\n# Or via Claude Code config:\nclaude mcp add orchestro\n```\n\nSee **[Integration Guide](INTEGRATION_GUIDE.md)** for existing project setup.\n\n---\n\n### Option 4: Claude Code Plugin 🎁 (Easiest!)\n\n**New!** Install Orchestro as a Claude Code plugin with one command:\n\n```bash\n# In Claude Code terminal\n/plugin marketplace add khaoss85/mcp-orchestro\n\n# Install the Orchestro Suite\n/plugin install orchestro-suite@orchestro-marketplace\n\n# Restart Claude Code when prompted\n```\n\n**What you get:**\n- ✅ **Orchestro MCP Server** - 60 tools via `npx @khaoss85/orchestro@latest` (no global install needed)\n- ✅ **5 Guardian Agents** - database, API, architecture, test-maintainer, production-ready\n- ✅ **Auto-configured** - MCP server and agents ready to use\n- ✅ **Complete Documentation** - Setup guide included\n\n**Prerequisites:**\n- Supabase account (see Option 2 for setup)\n- Environment variables set:\n  ```bash\n  export SUPABASE_URL=\"https://your-project.supabase.co\"\n  export SUPABASE_SERVICE_KEY=\"your-service-key\"\n  export ANTHROPIC_API_KEY=\"your-key\"\n  ```\n\n**Verify installation:**\n```bash\n# Check agents\n/agents\n# Should show: database-guardian, api-guardian, architecture-guardian,\n#              test-maintainer, production-ready-code-reviewer\n\n# Test MCP tools\nmcp__orchestro__get_project_info\nmcp__orchestro__list_tasks\n```\n\n**Plugin includes:**\n- MCP server configuration (`.mcp.json`)\n- 5 specialized guardian agents\n- Complete README with usage examples\n- Troubleshooting guide\n\nSee **[plugins/orchestro-suite/README.md](plugins/orchestro-suite/README.md)** for detailed plugin documentation.\n\n---\n\n## 🎭 Use Cases\n\n### 📱 For Product Managers\n**Scenario**: New feature request from stakeholder\n\n```\n1. Write user story in dashboard:\n   \"User should be able to export report as PDF\"\n\n2. Click \"Decompose with AI\"\n   → Orchestro creates 5 technical tasks with dependencies\n\n3. Monitor Kanban board:\n   → See real-time progress as Claude implements\n   → Risks flagged automatically (e.g., \"PDF library size impact\")\n   → Hover over task for technical details\n\n4. Review \u0026 Accept:\n   → See code diffs in plain English\n   → Rollback if needed\n   → Export timeline for stakeholder report\n```\n\n### 💻 For Developers\n**Scenario**: Implementing complex feature\n\n```\n1. Pick task from Kanban board\n\n2. Ask Claude:\n   \"Prepare task [task-id] for execution\"\n   → Orchestro analyzes codebase\n   → Shows: files to modify, dependencies, risks\n\n3. Get enriched context:\n   → Past similar implementations\n   → Relevant patterns (with success rates!)\n   → Risk mitigation strategies\n\n4. Implement with confidence:\n   → Conflict detection warns if other tasks touch same files\n   → Pattern learning suggests best approaches\n   → Complete history for rollback safety\n```\n\n### 🤝 For Teams\n**Scenario**: Cross-functional collaboration\n\n```\nPM writes story → AI decomposes → Dev implements → All see progress\n\n• PM: Non-technical Kanban view\n• Dev: Technical dependency graph\n• Claude: Enriched implementation context\n• Everyone: Real-time updates, complete transparency\n```\n\n---\n\n## 🛠️ All 60 MCP Tools ✅ Production Tested\n\n### 📋 Project Management (3 tools)\n- `get_project_info` - Project metadata and status\n- `get_project_configuration` - Complete project configuration\n- `initialize_project_configuration` - Setup default tools and guardians\n\n### 📝 Task Management (7 tools)\n- `create_task` - Create with assignee, priority, tags, category\n- `list_tasks` - Filter by status/category/tags\n- `update_task` - Modify any field with validation\n- `delete_task` - Safe deletion with dependency checks\n- `get_task_context` - Full context with dependencies (deprecated, use prepare_task_for_execution)\n- `get_execution_order` - Topological sort by dependencies\n- `safe_delete_tasks_by_status` - Bulk delete with safety checks\n\n### ⚙️ Task Execution \u0026 Analysis (3 tools)\n- `prepare_task_for_execution` - Generate codebase analysis prompt\n- `save_task_analysis` - Store analysis results\n- `get_execution_prompt` - Enriched implementation context\n\n### 📖 User Stories (4 tools)\n- `decompose_story` - AI-powered story → tasks decomposition with automatic analysis (autoAnalyze=true default)\n- `get_user_stories` - List all user stories\n- `get_tasks_by_user_story` - Get all child tasks\n- `get_user_story_health` - Monitor story completion status\n\n### 🔗 Dependencies \u0026 Conflicts (4 tools)\n- `save_dependencies` - Record task resource dependencies\n- `get_task_dependency_graph` - Visualize dependency graph\n- `get_resource_usage` - Find tasks using a resource\n- `get_task_conflicts` - Detect conflicting resource usage\n\n### 📚 Knowledge \u0026 Templates (5 tools)\n- `list_templates` - Available prompt/code templates\n- `list_patterns` - Coding patterns library\n- `list_learnings` - Past experience records\n- `render_template` - Generate from template with variables\n- `get_relevant_knowledge` - Context-aware suggestions\n\n### 🧠 Feedback \u0026 Learning (7 tools)\n- `add_feedback` - Record success/failure/improvement\n- `get_similar_learnings` - Find related experiences\n- `get_top_patterns` - Most frequently used patterns\n- `get_trending_patterns` - Recently popular patterns\n- `get_pattern_stats` - Detailed pattern metrics\n- `detect_failure_patterns` - Auto-detect risky approaches\n- `check_pattern_risk` - Risk assessment before using pattern\n\n### ⚙️ Project Configuration (14 tools)\n**Tech Stack**:\n- `add_tech_stack` - Add framework/library\n- `update_tech_stack` - Update version/config\n- `remove_tech_stack` - Remove technology\n\n**Sub-Agents (Guardians)**:\n- `add_sub_agent` - Register guardian agent\n- `update_sub_agent` - Modify agent config\n- `sync_claude_code_agents` - Sync from .claude/agents/\n- `read_claude_code_agents` - Read agent files\n- `suggest_agents_for_task` - AI-powered agent recommendations\n- `update_agent_prompt_templates` - Update prompt templates\n\n**MCP Tools Management**:\n- `add_mcp_tool` - Register MCP tool\n- `update_mcp_tool` - Update tool config\n- `suggest_tools_for_task` - AI-powered tool recommendations\n\n**Guidelines \u0026 Patterns**:\n- `add_guideline` - Add coding guideline\n- `add_code_pattern` - Add reusable pattern\n\n### 📊 Task History \u0026 Events (13 tools)\n- `get_task_history` - Complete event timeline\n- `get_status_history` - Status transition log\n- `get_decisions` - Decision records\n- `get_guardian_interventions` - Guardian activity log\n- `get_code_changes` - Code modification history\n- `record_decision` - Log a decision with rationale\n- `record_code_change` - Log code modifications\n- `record_guardian_intervention` - Log guardian action\n- `record_status_transition` - Log status change\n- `get_iteration_count` - Count task iterations\n- `get_task_snapshot` - Task state at timestamp\n- `rollback_task` - Restore previous state\n- `get_task_stats` - Aggregate statistics\n\n---\n\n## 📊 Dashboard Features\n\n### Kanban Board - For Everyone\n![Kanban Board](https://via.placeholder.com/800x400?text=Orchestro+Kanban+Board)\n\n**PM View**:\n- Drag \u0026 drop user stories\n- See progress at a glance\n- Risk indicators in plain English\n- Export reports for stakeholders\n\n**Developer View**:\n- Technical task details\n- Dependency indicators\n- Code complexity badges\n- Direct links to files\n\n### Task Detail Page - Deep Insights\n\n**Tab: Overview** (PM-friendly)\n- User story description\n- Technical requirements\n- Assignee \u0026 priority\n- Dependencies explained\n\n**Tab: History** (Audit trail)\n- Complete event timeline\n- Decision records with rationale\n- Code changes (with diffs)\n- Rollback capability\n\n**Tab: Dependencies** (Developer focus)\n- Visual dependency graph\n- Resource impact analysis\n- Risk assessment\n- Conflict detection\n\n---\n\n## 🏗️ Architecture\n\n```\n┌─────────────────────────────────────────┐\n│         PRODUCT MANAGER                 │\n│  • Writes user stories                  │\n│  • Monitors Kanban board                │\n│  • Reviews progress                     │\n└─────────────────────────────────────────┘\n              ↓ (Dashboard)\n┌─────────────────────────────────────────┐\n│      ORCHESTRO DASHBOARD (Next.js)      │\n│  • Kanban board with real-time updates │\n│  • Dependency graphs                    │\n│  • Progress visualization               │\n└─────────────────────────────────────────┘\n              ↓ ↑ (Socket.io)\n┌─────────────────────────────────────────┐\n│         SUPABASE (Data Layer)           │\n│  • Tasks, dependencies, resources       │\n│  • Event queue \u0026 real-time sync         │\n│  • Knowledge base \u0026 pattern tracking    │\n└─────────────────────────────────────────┘\n              ↓ ↑ (PostgreSQL)\n┌─────────────────────────────────────────┐\n│    ORCHESTRO MCP SERVER (Conductor)     │\n│  • 27 tools for task orchestration      │\n│  • Pattern learning \u0026 risk detection    │\n│  • AI story decomposition               │\n└─────────────────────────────────────────┘\n              ↓ ↑ (MCP Protocol)\n┌─────────────────────────────────────────┐\n│      CLAUDE CODE (Developer + AI)       │\n│  • Analyzes codebase                    │\n│  • Implements features                  │\n│  • Records decisions                    │\n└─────────────────────────────────────────┘\n```\n\n---\n\n## 💡 Real-World Example\n\n### Story: E-commerce Checkout Flow\n\n**PM writes in dashboard**:\n```\n\"Customer should complete purchase with\ncredit card payment and email confirmation\"\n```\n\n**Orchestro decomposes** (AI-powered):\n1. ✅ Design checkout database schema (2h) - *No dependencies*\n2. ✅ Implement payment service integration (4h) - *Depends on: #1*\n3. ✅ Create checkout API endpoints (3h) - *Depends on: #2*\n4. ✅ Build checkout UI components (4h) - *Depends on: #3*\n5. ✅ Add email notification service (2h) - *Depends on: #3*\n6. ✅ Implement order confirmation flow (3h) - *Depends on: #4, #5*\n\n**Total**: 18 hours, 6 tasks, dependencies mapped automatically\n\n**Developer flow** (with autoAnalyze=true):\n```typescript\n// 1. Decompose story (auto-analyzes tasks)\ndecompose_story(\"Customer checkout with payment\")\n// → Creates 6 tasks\n// → Auto-generates analysis prompts for tasks without dependencies\n// → Returns analysisPrompts[] ready to use\n\n// 2. Claude reviews analysis prompts\n// Prompts include: files to check, patterns to find, risks to identify\n\n// 3. Claude analyzes codebase using the prompts\n// Finds: existing payment tables, similar schemas\n// Risks: None (new table)\n\n// 4. Save analysis results\nsave_task_analysis({\n  taskId: \"task-1-id\",\n  filesToCreate: [\"migrations/002_checkout.sql\"],\n  dependencies: [{type: \"file\", name: \"001_orders.sql\", action: \"uses\"}],\n  risks: []\n})\n\n// 5. Get enriched context\nget_execution_prompt(\"task-1-id\")\n// → Returns: related code, patterns, guidelines\n\n// 6. Implement!\n// Claude writes migration, runs tests\n\n// 7. Record learning\nadd_feedback({\n  pattern: \"e-commerce checkout schema\",\n  type: \"success\",\n  feedback: \"Stripe integration smooth\"\n})\n```\n\n**Key improvement**: Step 1 now auto-prepares analysis, reducing manual workflow steps!\n\n**PM sees**:\n- ✅ Task 1 → Done (real-time update)\n- 🟡 Task 2 → In Progress (Claude working)\n- ⏳ Tasks 3-6 → Blocked (waiting for dependencies)\n- 📊 Progress: 17% (1/6 tasks done)\n\n---\n\n## 🧪 Pattern Learning in Action\n\n### Automatic Failure Detection (Saves Time!)\n\n```typescript\n// Scenario: Regex parsing keeps failing\n\n// Attempt 1\nadd_feedback({\n  pattern: \"regex pattern matching\",\n  type: \"failure\",\n  feedback: \"Unescaped metacharacters broke parser\"\n})\n\n// Attempt 2\nadd_feedback({\n  pattern: \"regex pattern matching\",\n  type: \"failure\",\n  feedback: \"Special chars not sanitized\"\n})\n\n// Attempt 3\nadd_feedback({\n  pattern: \"regex pattern matching\",\n  type: \"success\",\n  feedback: \"Finally worked after sanitizing\"\n})\n\n// Now Orchestro knows...\ndetect_failure_patterns()\n// 🚨 Returns:\n// {\n//   pattern: \"regex pattern matching\",\n//   failure_rate: 66.67%,\n//   risk_level: \"medium\",\n//   recommendation: \"⚡ Review sanitization first!\"\n// }\n\n// Next time, before using regex:\ncheck_pattern_risk(\"regex pattern matching\")\n// ⚠️ Warning: \"67% failure rate (2/3).\n//    Common issue: Unescaped metacharacters.\n//    Mitigation: Use sanitization helper first.\"\n```\n\n**Result**: Future regex tasks complete faster with fewer errors!\n\n---\n\n## 🎨 Tech Stack\n\n**Backend (MCP Server)**\n- TypeScript 5.0\n- @modelcontextprotocol/sdk\n- Supabase (PostgreSQL)\n- Socket.io for real-time\n\n**Frontend (Dashboard)**\n- Next.js 14 (App Router)\n- React 18 + TypeScript\n- TailwindCSS + shadcn/ui\n- React Flow (graphs)\n- react-markdown (rendering)\n\n**Database (Supabase/PostgreSQL)**\n- **Core**: projects, tasks, task_dependencies\n- **Knowledge**: learnings, patterns, templates, pattern_frequency\n- **Resources**: resource_nodes, resource_edges, code_entities, code_dependencies\n- **System**: event_queue, file_history, codebase_analysis\n- **Tech**: JSONB metadata, GIN indexes, Row-level security (RLS)\n\n**AI Integration**\n- Claude Code (MCP protocol)\n- AI task decomposition\n- Pattern recognition\n- Risk assessment\n\n---\n\n## 📈 Performance \u0026 Scale\n\n- ⚡ **Query Speed**: \u003c10ms with GIN indexes\n- 🔄 **Real-time**: 1s polling interval\n- 🗄️ **Storage**: Auto-cleanup processed events (24h)\n- 📊 **Scalability**: Tested with 100+ tasks\n- 🚀 **Analysis**: Non-blocking (delegated to Claude)\n- 👥 **Users**: Multi-PM, multi-developer ready\n\n---\n\n## 🔐 Security \u0026 Compliance\n\n- ✅ **Environment Variables** - No hardcoded secrets\n- ✅ **Supabase RLS** - Row-level security policies\n- ✅ **Complete Audit Trail** - Every decision recorded\n- ✅ **Event Processing** - Prevents duplicate actions\n- ✅ **Local First** - All data in your Supabase instance\n- ✅ **GDPR Ready** - Export \u0026 delete capabilities\n\n---\n\n## 📚 Documentation\n\n### Getting Started\n- **[QUICK_START.md](QUICK_START.md)** - 5-minute setup guide\n- **[PM_GUIDE.md](PM_GUIDE.md)** - For Product Managers *(Coming Soon)*\n- **[DEV_GUIDE.md](DEV_GUIDE.md)** - For Developers *(Coming Soon)*\n- **[EXAMPLES.md](EXAMPLES.md)** - Real-world usage examples\n\n### Deep Dive\n- **[WORKFLOW.md](WORKFLOW.md)** - Complete workflow explanation\n- **[ARCHITECTURE.md](ARCHITECTURE.md)** - Technical architecture\n- **[API.md](API.md)** - MCP Tools reference\n\n---\n\n## 🗺️ Roadmap\n\n### ✅ Phase 1: Core Orchestration (DONE)\n- [x] 60 MCP tools fully functional and tested\n- [x] Real-time dashboard with Kanban\n- [x] AI story decomposition with dependencies\n- [x] Pattern learning \u0026 failure detection\n- [x] Dependency tracking \u0026 conflict detection\n- [x] Task metadata (assignee, priority, tags, category)\n- [x] Complete audit trail with task history\n- [x] Project configuration management\n- [x] Claude Code agent synchronization\n- [x] AI-powered agent and tool suggestions\n\n### 🚧 Phase 2: PM Empowerment (Current)\n- [ ] Non-technical PM dashboard view\n- [ ] Story templates for common features\n- [ ] Progress reporting \u0026 exports\n- [ ] Stakeholder notifications\n- [ ] Risk explanations in plain English\n\n### 🔮 Phase 3: Team Intelligence\n- [ ] Multi-team workspaces\n- [ ] Cross-project pattern sharing\n- [ ] Velocity tracking \u0026 estimation\n- [ ] Auto-assignment based on expertise\n- [ ] Slack/Teams integration\n\n### 🚀 Phase 4: Advanced AI\n- [ ] LangGraph auto-orchestration\n- [ ] Predictive risk detection\n- [ ] Auto-conflict resolution\n- [ ] Code review automation\n- [ ] Documentation generation\n\n---\n\n## 🤝 Contributing\n\nWe welcome contributions from PMs, Developers, and AI enthusiasts!\n\n**For Product Managers**:\n- 📝 Share user story templates\n- 💡 Suggest PM-friendly features\n- 📊 Report UX issues\n\n**For Developers**:\n- 🔧 Submit bug fixes\n- ✨ Add new MCP tools\n- 📈 Improve pattern detection\n\n**How to contribute**:\n1. Fork the repo\n2. Create feature branch (`git checkout -b feature/amazing-feature`)\n3. Commit changes (`git commit -m 'Add amazing feature'`)\n4. Push to branch (`git push origin feature/amazing-feature`)\n5. Open Pull Request\n\n---\n\n## 📝 Changelog\n\n### v2.1.0 (2025-10-10) - Current 🎉\n- ✅ **Published to MCP Registry** - Now in [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.khaoss85/orchestro)\n- ✅ **NPM Package** - Published as `@khaoss85/orchestro` on npm\n- ✅ **60 MCP Tools** - Expanded from 27 to 60 production-ready tools\n- ✅ **Automatic Task Analysis** - decompose_story now auto-prepares analysis prompts (autoAnalyze=true default)\n- ✅ **Project Configuration System** - Complete tech stack, agents, tools management\n- ✅ **Claude Code Agent Sync** - Automatic sync with .claude/agents/ directory\n- ✅ **AI Agent/Tool Suggestions** - Smart recommendations for tasks\n- ✅ **Task History \u0026 Events** - Complete audit trail with 13 history tools\n- ✅ **User Story Health** - Monitor completion and status alignment\n- ✅ **Bug Fix** - Resolved SQL error in get_project_configuration\n- ✅ **Full Test Coverage** - All 60 tools tested and verified (96.7% success)\n\n### v2.0.0 (2025-10-03)\n- ✅ **Rebranded to Orchestro** - \"Your AI Development Conductor\"\n- ✅ **Pattern Analysis Tools** - 5 new MCP tools for failure detection\n- ✅ **Pattern Frequency** - Automatic tracking with database triggers\n- ✅ **Risk Assessment** - detect_failure_patterns \u0026 check_pattern_risk\n- ✅ **Task Metadata** - assignee, priority, tags fields\n- ✅ **PM-focused Documentation** - Updated for product owners\n\n### v1.5.0 (2025-10-02)\n- ✅ New workflow: MCP orchestrates, Claude Code analyzes\n- ✅ 3 execution tools: prepare, save_analysis, get_execution_prompt\n- ✅ tasks.metadata JSONB column\n- ✅ Event queue updated (8 event types)\n- ✅ Guardian verification passed\n\n### v1.0.0\n- Initial MCP implementation\n- Basic task management\n- AI story decomposition\n- Knowledge base integration\n\n---\n\n## 🌟 Success Stories\n\n\u003e *\"As a PM, I finally understand what developers are building in real-time. Orchestro bridges the gap between product vision and technical implementation.\"*\n\u003e — *Your testimonial here*\n\n\u003e *\"Pattern learning saved us hours. The system warned about a risky approach before we wasted time on it.\"*\n\u003e — *Your testimonial here*\n\n---\n\n## 📞 Support \u0026 Community\n\n- 📧 **Issues**: [GitHub Issues](https://github.com/khaoss85/mcp-orchestro/issues)\n- 💬 **Discussions**: [GitHub Discussions](https://github.com/khaoss85/mcp-orchestro/discussions)\n- 📖 **Docs**: Comprehensive guides in the repo\n- 🌐 **Dashboard**: http://localhost:3000\n- 🐦 **Twitter**: [@orchestro_ai](https://twitter.com/orchestro_ai) *(Coming Soon)*\n\n---\n\n## 📜 License\n\nMIT License - See [LICENSE](LICENSE) file for details\n\n---\n\n## 🙏 Acknowledgments\n\n- **[Claude Code](https://claude.ai)** - MCP platform \u0026 AI development\n- **[Supabase](https://supabase.com)** - Database \u0026 real-time infrastructure\n- **[Next.js](https://nextjs.org)** - React framework for dashboard\n- **[React Flow](https://reactflow.dev)** - Beautiful dependency graphs\n- **[shadcn/ui](https://ui.shadcn.com)** - Gorgeous UI components\n\n---\n\n\u003cdiv align=\"center\"\u003e\n\n## 🎭 Ready to Conduct Your Development Symphony?\n\nTransform product ideas into production code with AI orchestration\n\n**[Get Started](QUICK_START.md)** · **[PM Guide](PM_GUIDE.md)** · **[Dev Guide](DEV_GUIDE.md)** · **[See Examples](EXAMPLES.md)**\n\n---\n\n**Status**: ✅ Production Ready (96.7% Test Coverage)\n**Version**: 2.1.0\n**NPM**: [@khaoss85/orchestro](https://www.npmjs.com/package/@khaoss85/orchestro)\n**Registry**: [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.khaoss85/orchestro)\n**MCP Tools**: 60\n**Made for**: PMs · Developers · Claude Code\n\n---\n\n**🎼 Conducting development, one task at a time**\n\nMade with ❤️ by developers who care about product\n\n**⭐ Star us on GitHub to support the project!**\n\n\u003c/div\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhaoss85%2Fmcp-orchestro","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fkhaoss85%2Fmcp-orchestro","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fkhaoss85%2Fmcp-orchestro/lists"}