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. The Problem: - Product Managers lose track of development progress - Developers struggle with context switching and depend
Add this skill
npx mdskills install khaoss85/mcp-orchestroComprehensive orchestration platform with 60 MCP tools, multiple install options, and excellent documentation
1# ๐ญ Orchestro23> **Your AI Development Conductor** - From Product Vision to Production Code45Transform 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.67[]()8[](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.khaoss85/orchestro)9[](https://www.npmjs.com/package/@khaoss85/orchestro)10[]()11[]()12[]()1314---1516## ๐ฏ Why Orchestro?1718**The Problem**:19- Product Managers lose track of development progress20- Developers struggle with context switching and dependencies21- Knowledge is lost between Claude Code sessions22- No single source of truth for what's being built2324**The Solution**: Orchestro orchestrates the entire development lifecycle:25- ๐ **For PMs**: Visual Kanban board, user story decomposition, progress tracking26- ๐จโ๐ป **For Developers**: AI-powered task analysis, dependency graphs, pattern learning27- ๐ค **For Claude Code**: Structured workflows, enriched context, knowledge retention28- ๐ **For Everyone**: Real-time dashboard, transparent progress, complete audit trail2930**Think Trello ร Jira ร AI** - but designed specifically for AI-assisted development.3132---3334## โจ Key Features3536### ๐ For Product Managers & Owners37- **User Story Decomposition** - Write a story, AI creates technical tasks automatically38- **Visual Progress Board** - Kanban view with real-time updates39- **No Technical Knowledge Required** - Manage development without coding40- **Complete Transparency** - See exactly what's being built, when, and why41- **Risk Awareness** - Auto-flagged risks with plain English explanations4243### ๐จโ๐ป For Developers44- **Intelligent Task Analysis** - AI analyzes codebase and suggests implementation45- **Dependency Tracking** - Visual graphs show what depends on what46- **Pattern Learning** - System learns from successes and failures47- **Conflict Prevention** - Detects when tasks touch the same files48- **Context Retention** - Never lose context between sessions4950### ๐ค For Claude Code51- **60 MCP Tools** - Complete toolkit for orchestrated development52- **Structured Workflows** - prepare โ analyze โ implement โ learn53- **Enriched Prompts** - Context-aware implementation guidance54- **Knowledge Base** - Templates, patterns, learnings persist forever5556### ๐ For Everyone57- **Real-Time Dashboard** - Live updates via Socket.io58- **Complete History** - Timeline of all decisions and changes59- **Rollback Capability** - Undo mistakes safely60- **Export Everything** - Markdown reports for stakeholders6162---6364## ๐ผ The Development Symphony6566### How Orchestro Conducts Your Development6768```69โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ70โ PRODUCT MANAGER โ71โ "User should login with email/password" โ72โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ73 โ74 โโโโโโโโโโโโโโโโโโโโโโโโ75 โ ORCHESTRO AI โ76 โ Decomposes Story โ77 โโโโโโโโโโโโโโโโโโโโโโโโ78 โ79 โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ80 โ 7 Technical Tasks Created โ81 โ โข Database schema โ82 โ โข Authentication service โ83 โ โข API endpoints โ84 โ โข Frontend components โ85 โ โข State management โ86 โ (with dependencies automatically) โ87 โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ88 โ89 โโโโโโโโโโโโโโโโโโโโโโโโ90 โ DEVELOPER/CLAUDE โ91 โ Implements Tasks โ92 โโโโโโโโโโโโโโโโโโโโโโโโ93 โ94 โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ95 โ PM SEES PROGRESS โ96 โ โข Kanban updates in real-time โ97 โ โข Risks flagged automatically โ98 โ โข Dependencies visualized โ99 โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ100```101102---103104## ๐ Quick Start105106### Option 1: From MCP Registry โญ (Recommended)107108**Orchestro is now in the [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.khaoss85/orchestro)!**109110```bash111# Install via NPX (no global install needed)112npx @khaoss85/orchestro@latest113```114115**Or add to Claude Code config**:116```json117{118 "mcpServers": {119 "orchestro": {120 "command": "npx",121 "args": ["-y", "@khaoss85/orchestro@latest"],122 "env": {123 "DATABASE_URL": "your-supabase-connection-string"124 }125 }126 }127}128```129130---131132### Option 2: One-Command Install โก133134```bash135npx @orchestro/init136```137138**That's it!** The installer will:139- โ Download and setup Orchestro140- โ Apply database migrations to Supabase141- โ Configure Claude Code automatically142- โ Setup Supabase connection143- โ Start the dashboard144- โ Verify everything works145146**Interactive prompts:**147```148๐ญ Orchestro Setup Wizard149150? Supabase connection string: โโโโโโโโ151? Project name: My Project152? Install location: ~/orchestro153154โ๏ธ Setting up...155โ Orchestro installed156โ Claude Code configured157โ Database ready158159๐ Done! Restart Claude Code and ask:160 "Show me orchestro tools"161```162163---164165### Option 2: Manual Install (5 Minutes)166167#### 1. Prerequisites168```bash169# Node.js 18+170node --version171172# Supabase account (free tier works great)173# Sign up at https://supabase.com174```175176#### 2. Database Setup on Supabase177178**Create your Supabase project:**1791. Go to https://supabase.com and create a new project1802. Wait for the database to be provisioned (~2 minutes)1813. Go to **Settings** โ **Database** and copy the **Connection String** (Transaction mode)182183**Apply database schema:**184```bash185# Clone this repo first186git clone https://github.com/khaoss85/mcp-orchestro.git187cd mcp-orchestro188189# Install dependencies190npm install191192# Set your Supabase connection string193export DATABASE_URL="your-supabase-connection-string"194195# Apply all migrations to create the schema196npm run migrate197```198199**Verify database setup:**200```bash201# The migrate script will show you all tables created:202# You should see:203# โ Running migration: code_entities204# โ Running migration: add_tasks_metadata205# โ Running migration: fix_status_transition_trigger206# โ Running migration: event_queue207# โ Running migration: auto_update_user_story_status208# โ Running migration: add_task_metadata_fields209# โ Running migration: add_pattern_frequency_tracking210211# Or verify manually via Supabase dashboard:212# Go to Database โ Tables and check all tables are created213```214215**Get your credentials:**216```bash217# From Supabase Dashboard:218219# 1. DATABASE_URL (for migrations & MCP server)220# Settings โ Database โ Connection String โ Transaction mode221# Example: postgresql://postgres:[password]@db.[project].supabase.co:5432/postgres222223# 2. SUPABASE_URL (for API calls)224# Settings โ API โ Project URL225# Example: https://[project].supabase.co226227# 3. SUPABASE_SERVICE_KEY (for admin operations - keep secret!)228# Settings โ API โ service_role key229# Example: eyJhbG...230```231232#### 3. Quick Setup Script233```bash234# Run interactive setup235npm run setup236237# Or manual configuration:238cat > .env << EOF239DATABASE_URL=your-supabase-connection-string240SUPABASE_URL=your-supabase-url241SUPABASE_SERVICE_KEY=your-service-key242EOF243```244245#### 4. Configure Claude Code246```bash247# Auto-configure (recommended)248npm run configure-claude249250# Or manually edit:251open ~/Library/Application\ Support/Claude/claude_desktop_config.json252253# Add:254{255 "mcpServers": {256 "orchestro": {257 "command": "node",258 "args": ["/absolute/path/to/orchestro/dist/server.js"],259 "env": {260 "DATABASE_URL": "your-connection-string"261 }262 }263 }264}265```266267#### 5. Start Dashboard268```bash269npm run dashboard270# ๐ Opens http://localhost:3000271```272273#### 6. Verify Installation274```275# Restart Claude Code, then ask:276"Show me all orchestro tools"277278# You should see 60 tools! ๐ญ279```280281---282283### Option 3: Add to Existing Project284285Already have a Claude Code project? Add Orchestro:286287```bash288# In your project directory289npx @orchestro/add290291# Or via Claude Code config:292claude mcp add orchestro293```294295See **[Integration Guide](INTEGRATION_GUIDE.md)** for existing project setup.296297---298299### Option 4: Claude Code Plugin ๐ (Easiest!)300301**New!** Install Orchestro as a Claude Code plugin with one command:302303```bash304# In Claude Code terminal305/plugin marketplace add khaoss85/mcp-orchestro306307# Install the Orchestro Suite308/plugin install orchestro-suite@orchestro-marketplace309310# Restart Claude Code when prompted311```312313**What you get:**314- โ **Orchestro MCP Server** - 60 tools via `npx @khaoss85/orchestro@latest` (no global install needed)315- โ **5 Guardian Agents** - database, API, architecture, test-maintainer, production-ready316- โ **Auto-configured** - MCP server and agents ready to use317- โ **Complete Documentation** - Setup guide included318319**Prerequisites:**320- Supabase account (see Option 2 for setup)321- Environment variables set:322 ```bash323 export SUPABASE_URL="https://your-project.supabase.co"324 export SUPABASE_SERVICE_KEY="your-service-key"325 export ANTHROPIC_API_KEY="your-key"326 ```327328**Verify installation:**329```bash330# Check agents331/agents332# Should show: database-guardian, api-guardian, architecture-guardian,333# test-maintainer, production-ready-code-reviewer334335# Test MCP tools336mcp__orchestro__get_project_info337mcp__orchestro__list_tasks338```339340**Plugin includes:**341- MCP server configuration (`.mcp.json`)342- 5 specialized guardian agents343- Complete README with usage examples344- Troubleshooting guide345346See **[plugins/orchestro-suite/README.md](plugins/orchestro-suite/README.md)** for detailed plugin documentation.347348---349350## ๐ญ Use Cases351352### ๐ฑ For Product Managers353**Scenario**: New feature request from stakeholder354355```3561. Write user story in dashboard:357 "User should be able to export report as PDF"3583592. Click "Decompose with AI"360 โ Orchestro creates 5 technical tasks with dependencies3613623. Monitor Kanban board:363 โ See real-time progress as Claude implements364 โ Risks flagged automatically (e.g., "PDF library size impact")365 โ Hover over task for technical details3663674. Review & Accept:368 โ See code diffs in plain English369 โ Rollback if needed370 โ Export timeline for stakeholder report371```372373### ๐ป For Developers374**Scenario**: Implementing complex feature375376```3771. Pick task from Kanban board3783792. Ask Claude:380 "Prepare task [task-id] for execution"381 โ Orchestro analyzes codebase382 โ Shows: files to modify, dependencies, risks3833843. Get enriched context:385 โ Past similar implementations386 โ Relevant patterns (with success rates!)387 โ Risk mitigation strategies3883894. Implement with confidence:390 โ Conflict detection warns if other tasks touch same files391 โ Pattern learning suggests best approaches392 โ Complete history for rollback safety393```394395### ๐ค For Teams396**Scenario**: Cross-functional collaboration397398```399PM writes story โ AI decomposes โ Dev implements โ All see progress400401โข PM: Non-technical Kanban view402โข Dev: Technical dependency graph403โข Claude: Enriched implementation context404โข Everyone: Real-time updates, complete transparency405```406407---408409## ๐ ๏ธ All 60 MCP Tools โ Production Tested410411### ๐ Project Management (3 tools)412- `get_project_info` - Project metadata and status413- `get_project_configuration` - Complete project configuration414- `initialize_project_configuration` - Setup default tools and guardians415416### ๐ Task Management (7 tools)417- `create_task` - Create with assignee, priority, tags, category418- `list_tasks` - Filter by status/category/tags419- `update_task` - Modify any field with validation420- `delete_task` - Safe deletion with dependency checks421- `get_task_context` - Full context with dependencies (deprecated, use prepare_task_for_execution)422- `get_execution_order` - Topological sort by dependencies423- `safe_delete_tasks_by_status` - Bulk delete with safety checks424425### โ๏ธ Task Execution & Analysis (3 tools)426- `prepare_task_for_execution` - Generate codebase analysis prompt427- `save_task_analysis` - Store analysis results428- `get_execution_prompt` - Enriched implementation context429430### ๐ User Stories (4 tools)431- `decompose_story` - AI-powered story โ tasks decomposition with automatic analysis (autoAnalyze=true default)432- `get_user_stories` - List all user stories433- `get_tasks_by_user_story` - Get all child tasks434- `get_user_story_health` - Monitor story completion status435436### ๐ Dependencies & Conflicts (4 tools)437- `save_dependencies` - Record task resource dependencies438- `get_task_dependency_graph` - Visualize dependency graph439- `get_resource_usage` - Find tasks using a resource440- `get_task_conflicts` - Detect conflicting resource usage441442### ๐ Knowledge & Templates (5 tools)443- `list_templates` - Available prompt/code templates444- `list_patterns` - Coding patterns library445- `list_learnings` - Past experience records446- `render_template` - Generate from template with variables447- `get_relevant_knowledge` - Context-aware suggestions448449### ๐ง Feedback & Learning (7 tools)450- `add_feedback` - Record success/failure/improvement451- `get_similar_learnings` - Find related experiences452- `get_top_patterns` - Most frequently used patterns453- `get_trending_patterns` - Recently popular patterns454- `get_pattern_stats` - Detailed pattern metrics455- `detect_failure_patterns` - Auto-detect risky approaches456- `check_pattern_risk` - Risk assessment before using pattern457458### โ๏ธ Project Configuration (14 tools)459**Tech Stack**:460- `add_tech_stack` - Add framework/library461- `update_tech_stack` - Update version/config462- `remove_tech_stack` - Remove technology463464**Sub-Agents (Guardians)**:465- `add_sub_agent` - Register guardian agent466- `update_sub_agent` - Modify agent config467- `sync_claude_code_agents` - Sync from .claude/agents/468- `read_claude_code_agents` - Read agent files469- `suggest_agents_for_task` - AI-powered agent recommendations470- `update_agent_prompt_templates` - Update prompt templates471472**MCP Tools Management**:473- `add_mcp_tool` - Register MCP tool474- `update_mcp_tool` - Update tool config475- `suggest_tools_for_task` - AI-powered tool recommendations476477**Guidelines & Patterns**:478- `add_guideline` - Add coding guideline479- `add_code_pattern` - Add reusable pattern480481### ๐ Task History & Events (13 tools)482- `get_task_history` - Complete event timeline483- `get_status_history` - Status transition log484- `get_decisions` - Decision records485- `get_guardian_interventions` - Guardian activity log486- `get_code_changes` - Code modification history487- `record_decision` - Log a decision with rationale488- `record_code_change` - Log code modifications489- `record_guardian_intervention` - Log guardian action490- `record_status_transition` - Log status change491- `get_iteration_count` - Count task iterations492- `get_task_snapshot` - Task state at timestamp493- `rollback_task` - Restore previous state494- `get_task_stats` - Aggregate statistics495496---497498## ๐ Dashboard Features499500### Kanban Board - For Everyone501502503**PM View**:504- Drag & drop user stories505- See progress at a glance506- Risk indicators in plain English507- Export reports for stakeholders508509**Developer View**:510- Technical task details511- Dependency indicators512- Code complexity badges513- Direct links to files514515### Task Detail Page - Deep Insights516517**Tab: Overview** (PM-friendly)518- User story description519- Technical requirements520- Assignee & priority521- Dependencies explained522523**Tab: History** (Audit trail)524- Complete event timeline525- Decision records with rationale526- Code changes (with diffs)527- Rollback capability528529**Tab: Dependencies** (Developer focus)530- Visual dependency graph531- Resource impact analysis532- Risk assessment533- Conflict detection534535---536537## ๐๏ธ Architecture538539```540โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ541โ PRODUCT MANAGER โ542โ โข Writes user stories โ543โ โข Monitors Kanban board โ544โ โข Reviews progress โ545โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ546 โ (Dashboard)547โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ548โ ORCHESTRO DASHBOARD (Next.js) โ549โ โข Kanban board with real-time updates โ550โ โข Dependency graphs โ551โ โข Progress visualization โ552โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ553 โ โ (Socket.io)554โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ555โ SUPABASE (Data Layer) โ556โ โข Tasks, dependencies, resources โ557โ โข Event queue & real-time sync โ558โ โข Knowledge base & pattern tracking โ559โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ560 โ โ (PostgreSQL)561โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ562โ ORCHESTRO MCP SERVER (Conductor) โ563โ โข 27 tools for task orchestration โ564โ โข Pattern learning & risk detection โ565โ โข AI story decomposition โ566โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ567 โ โ (MCP Protocol)568โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ569โ CLAUDE CODE (Developer + AI) โ570โ โข Analyzes codebase โ571โ โข Implements features โ572โ โข Records decisions โ573โโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโโ574```575576---577578## ๐ก Real-World Example579580### Story: E-commerce Checkout Flow581582**PM writes in dashboard**:583```584"Customer should complete purchase with585credit card payment and email confirmation"586```587588**Orchestro decomposes** (AI-powered):5891. โ Design checkout database schema (2h) - *No dependencies*5902. โ Implement payment service integration (4h) - *Depends on: #1*5913. โ Create checkout API endpoints (3h) - *Depends on: #2*5924. โ Build checkout UI components (4h) - *Depends on: #3*5935. โ Add email notification service (2h) - *Depends on: #3*5946. โ Implement order confirmation flow (3h) - *Depends on: #4, #5*595596**Total**: 18 hours, 6 tasks, dependencies mapped automatically597598**Developer flow** (with autoAnalyze=true):599```typescript600// 1. Decompose story (auto-analyzes tasks)601decompose_story("Customer checkout with payment")602// โ Creates 6 tasks603// โ Auto-generates analysis prompts for tasks without dependencies604// โ Returns analysisPrompts[] ready to use605606// 2. Claude reviews analysis prompts607// Prompts include: files to check, patterns to find, risks to identify608609// 3. Claude analyzes codebase using the prompts610// Finds: existing payment tables, similar schemas611// Risks: None (new table)612613// 4. Save analysis results614save_task_analysis({615 taskId: "task-1-id",616 filesToCreate: ["migrations/002_checkout.sql"],617 dependencies: [{type: "file", name: "001_orders.sql", action: "uses"}],618 risks: []619})620621// 5. Get enriched context622get_execution_prompt("task-1-id")623// โ Returns: related code, patterns, guidelines624625// 6. Implement!626// Claude writes migration, runs tests627628// 7. Record learning629add_feedback({630 pattern: "e-commerce checkout schema",631 type: "success",632 feedback: "Stripe integration smooth"633})634```635636**Key improvement**: Step 1 now auto-prepares analysis, reducing manual workflow steps!637638**PM sees**:639- โ Task 1 โ Done (real-time update)640- ๐ก Task 2 โ In Progress (Claude working)641- โณ Tasks 3-6 โ Blocked (waiting for dependencies)642- ๐ Progress: 17% (1/6 tasks done)643644---645646## ๐งช Pattern Learning in Action647648### Automatic Failure Detection (Saves Time!)649650```typescript651// Scenario: Regex parsing keeps failing652653// Attempt 1654add_feedback({655 pattern: "regex pattern matching",656 type: "failure",657 feedback: "Unescaped metacharacters broke parser"658})659660// Attempt 2661add_feedback({662 pattern: "regex pattern matching",663 type: "failure",664 feedback: "Special chars not sanitized"665})666667// Attempt 3668add_feedback({669 pattern: "regex pattern matching",670 type: "success",671 feedback: "Finally worked after sanitizing"672})673674// Now Orchestro knows...675detect_failure_patterns()676// ๐จ Returns:677// {678// pattern: "regex pattern matching",679// failure_rate: 66.67%,680// risk_level: "medium",681// recommendation: "โก Review sanitization first!"682// }683684// Next time, before using regex:685check_pattern_risk("regex pattern matching")686// โ ๏ธ Warning: "67% failure rate (2/3).687// Common issue: Unescaped metacharacters.688// Mitigation: Use sanitization helper first."689```690691**Result**: Future regex tasks complete faster with fewer errors!692693---694695## ๐จ Tech Stack696697**Backend (MCP Server)**698- TypeScript 5.0699- @modelcontextprotocol/sdk700- Supabase (PostgreSQL)701- Socket.io for real-time702703**Frontend (Dashboard)**704- Next.js 14 (App Router)705- React 18 + TypeScript706- TailwindCSS + shadcn/ui707- React Flow (graphs)708- react-markdown (rendering)709710**Database (Supabase/PostgreSQL)**711- **Core**: projects, tasks, task_dependencies712- **Knowledge**: learnings, patterns, templates, pattern_frequency713- **Resources**: resource_nodes, resource_edges, code_entities, code_dependencies714- **System**: event_queue, file_history, codebase_analysis715- **Tech**: JSONB metadata, GIN indexes, Row-level security (RLS)716717**AI Integration**718- Claude Code (MCP protocol)719- AI task decomposition720- Pattern recognition721- Risk assessment722723---724725## ๐ Performance & Scale726727- โก **Query Speed**: <10ms with GIN indexes728- ๐ **Real-time**: 1s polling interval729- ๐๏ธ **Storage**: Auto-cleanup processed events (24h)730- ๐ **Scalability**: Tested with 100+ tasks731- ๐ **Analysis**: Non-blocking (delegated to Claude)732- ๐ฅ **Users**: Multi-PM, multi-developer ready733734---735736## ๐ Security & Compliance737738- โ **Environment Variables** - No hardcoded secrets739- โ **Supabase RLS** - Row-level security policies740- โ **Complete Audit Trail** - Every decision recorded741- โ **Event Processing** - Prevents duplicate actions742- โ **Local First** - All data in your Supabase instance743- โ **GDPR Ready** - Export & delete capabilities744745---746747## ๐ Documentation748749### Getting Started750- **[QUICK_START.md](QUICK_START.md)** - 5-minute setup guide751- **[PM_GUIDE.md](PM_GUIDE.md)** - For Product Managers *(Coming Soon)*752- **[DEV_GUIDE.md](DEV_GUIDE.md)** - For Developers *(Coming Soon)*753- **[EXAMPLES.md](EXAMPLES.md)** - Real-world usage examples754755### Deep Dive756- **[WORKFLOW.md](WORKFLOW.md)** - Complete workflow explanation757- **[ARCHITECTURE.md](ARCHITECTURE.md)** - Technical architecture758- **[API.md](API.md)** - MCP Tools reference759760---761762## ๐บ๏ธ Roadmap763764### โ Phase 1: Core Orchestration (DONE)765- [x] 60 MCP tools fully functional and tested766- [x] Real-time dashboard with Kanban767- [x] AI story decomposition with dependencies768- [x] Pattern learning & failure detection769- [x] Dependency tracking & conflict detection770- [x] Task metadata (assignee, priority, tags, category)771- [x] Complete audit trail with task history772- [x] Project configuration management773- [x] Claude Code agent synchronization774- [x] AI-powered agent and tool suggestions775776### ๐ง Phase 2: PM Empowerment (Current)777- [ ] Non-technical PM dashboard view778- [ ] Story templates for common features779- [ ] Progress reporting & exports780- [ ] Stakeholder notifications781- [ ] Risk explanations in plain English782783### ๐ฎ Phase 3: Team Intelligence784- [ ] Multi-team workspaces785- [ ] Cross-project pattern sharing786- [ ] Velocity tracking & estimation787- [ ] Auto-assignment based on expertise788- [ ] Slack/Teams integration789790### ๐ Phase 4: Advanced AI791- [ ] LangGraph auto-orchestration792- [ ] Predictive risk detection793- [ ] Auto-conflict resolution794- [ ] Code review automation795- [ ] Documentation generation796797---798799## ๐ค Contributing800801We welcome contributions from PMs, Developers, and AI enthusiasts!802803**For Product Managers**:804- ๐ Share user story templates805- ๐ก Suggest PM-friendly features806- ๐ Report UX issues807808**For Developers**:809- ๐ง Submit bug fixes810- โจ Add new MCP tools811- ๐ Improve pattern detection812813**How to contribute**:8141. Fork the repo8152. Create feature branch (`git checkout -b feature/amazing-feature`)8163. Commit changes (`git commit -m 'Add amazing feature'`)8174. Push to branch (`git push origin feature/amazing-feature`)8185. Open Pull Request819820---821822## ๐ Changelog823824### v2.1.0 (2025-10-10) - Current ๐825- โ **Published to MCP Registry** - Now in [Official MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.khaoss85/orchestro)826- โ **NPM Package** - Published as `@khaoss85/orchestro` on npm827- โ **60 MCP Tools** - Expanded from 27 to 60 production-ready tools828- โ **Automatic Task Analysis** - decompose_story now auto-prepares analysis prompts (autoAnalyze=true default)829- โ **Project Configuration System** - Complete tech stack, agents, tools management830- โ **Claude Code Agent Sync** - Automatic sync with .claude/agents/ directory831- โ **AI Agent/Tool Suggestions** - Smart recommendations for tasks832- โ **Task History & Events** - Complete audit trail with 13 history tools833- โ **User Story Health** - Monitor completion and status alignment834- โ **Bug Fix** - Resolved SQL error in get_project_configuration835- โ **Full Test Coverage** - All 60 tools tested and verified (96.7% success)836837### v2.0.0 (2025-10-03)838- โ **Rebranded to Orchestro** - "Your AI Development Conductor"839- โ **Pattern Analysis Tools** - 5 new MCP tools for failure detection840- โ **Pattern Frequency** - Automatic tracking with database triggers841- โ **Risk Assessment** - detect_failure_patterns & check_pattern_risk842- โ **Task Metadata** - assignee, priority, tags fields843- โ **PM-focused Documentation** - Updated for product owners844845### v1.5.0 (2025-10-02)846- โ New workflow: MCP orchestrates, Claude Code analyzes847- โ 3 execution tools: prepare, save_analysis, get_execution_prompt848- โ tasks.metadata JSONB column849- โ Event queue updated (8 event types)850- โ Guardian verification passed851852### v1.0.0853- Initial MCP implementation854- Basic task management855- AI story decomposition856- Knowledge base integration857858---859860## ๐ Success Stories861862> *"As a PM, I finally understand what developers are building in real-time. Orchestro bridges the gap between product vision and technical implementation."*863> โ *Your testimonial here*864865> *"Pattern learning saved us hours. The system warned about a risky approach before we wasted time on it."*866> โ *Your testimonial here*867868---869870## ๐ Support & Community871872- ๐ง **Issues**: [GitHub Issues](https://github.com/khaoss85/mcp-orchestro/issues)873- ๐ฌ **Discussions**: [GitHub Discussions](https://github.com/khaoss85/mcp-orchestro/discussions)874- ๐ **Docs**: Comprehensive guides in the repo875- ๐ **Dashboard**: http://localhost:3000876- ๐ฆ **Twitter**: [@orchestro_ai](https://twitter.com/orchestro_ai) *(Coming Soon)*877878---879880## ๐ License881882MIT License - See [LICENSE](LICENSE) file for details883884---885886## ๐ Acknowledgments887888- **[Claude Code](https://claude.ai)** - MCP platform & AI development889- **[Supabase](https://supabase.com)** - Database & real-time infrastructure890- **[Next.js](https://nextjs.org)** - React framework for dashboard891- **[React Flow](https://reactflow.dev)** - Beautiful dependency graphs892- **[shadcn/ui](https://ui.shadcn.com)** - Gorgeous UI components893894---895896<div align="center">897898## ๐ญ Ready to Conduct Your Development Symphony?899900Transform product ideas into production code with AI orchestration901902**[Get Started](QUICK_START.md)** ยท **[PM Guide](PM_GUIDE.md)** ยท **[Dev Guide](DEV_GUIDE.md)** ยท **[See Examples](EXAMPLES.md)**903904---905906**Status**: โ Production Ready (96.7% Test Coverage)907**Version**: 2.1.0908**NPM**: [@khaoss85/orchestro](https://www.npmjs.com/package/@khaoss85/orchestro)909**Registry**: [MCP Registry](https://registry.modelcontextprotocol.io/v0/servers?search=io.github.khaoss85/orchestro)910**MCP Tools**: 60911**Made for**: PMs ยท Developers ยท Claude Code912913---914915**๐ผ Conducting development, one task at a time**916917Made with โค๏ธ by developers who care about product918919**โญ Star us on GitHub to support the project!**920921</div>922
Full transparency โ inspect the skill content before installing.