MCP Orchestro

Trello para Claude Code: gerenciamento de tarefas com IA, 60 ferramentas MCP, quadro Kanban visual e orquestração inteligente para equipes de produto e desenvolvedores

Documentação

🎭 Orchestro

Seu Maestro de Desenvolvimento com IA - Da Visão do Produto ao Código em Produção

Transforme ideias de produtos em realidade com um sistema de orquestração inteligente que conecta Gerentes de Produto, Desenvolvedores e IA. O Orchestro conduz toda a sinfonia do desenvolvimento: decomposição de tarefas, rastreamento de dependências, aprendizado de padrões e visualização de progresso em tempo real.

Status MCP Registry NPM Package TypeScript MCP Tools License


🎯 Por que o Orchestro?

O Problema:

  • Gerentes de Produto perdem o controle do progresso do desenvolvimento
  • Desenvolvedores enfrentam dificuldades com mudança de contexto e dependências
  • O conhecimento se perde entre as sessões do Claude Code
  • Não existe uma fonte única de verdade sobre o que está sendo construído

A Solução: O Orchestro orquestra todo o ciclo de vida do desenvolvimento:

  • 👔 Para GPs: Quadro Kanban visual, decomposição de histórias de usuário, rastreamento de progresso
  • 👨‍💻 Para Desenvolvedores: Análise de tarefas com IA, gráficos de dependências, aprendizado de padrões
  • 🤖 Para o Claude Code: Fluxos de trabalho estruturados, contexto enriquecido, retenção de conhecimento
  • 📊 Para Todos: Painel em tempo real, progresso transparente, trilha de auditoria completa

Pense em Trello × Jira × IA - mas projetado especificamente para desenvolvimento assistido por IA.


✨ Principais Recursos

👔 Para Gerentes de Produto e Proprietários

  • Decomposição de Histórias de Usuário - Escreva uma história, a IA cria tarefas técnicas automaticamente
  • Quadro de Progresso Visual - Visão Kanban com atualizações em tempo real
  • Nenhum Conhecimento Técnico Necessário - Gerencie o desenvolvimento sem programar
  • Transparência Completa - Veja exatamente o que está sendo construído, quando e por quê
  • Consciência de Riscos - Riscos sinalizados automaticamente com explicações em linguagem simples

👨‍💻 Para Desenvolvedores

  • Análise Inteligente de Tarefas - A IA analisa a base de código e sugere a implementação
  • Rastreamento de Dependências - Gráficos visuais mostram o que depende do quê
  • Aprendizado de Padrões - O sistema aprende com sucessos e falhas
  • Prevenção de Conflitos - Detecta quando tarefas alteram os mesmos arquivos
  • Retenção de Contexto - Nunca perca o contexto entre sessões

🤖 Para o Claude Code

  • 60 Ferramentas MCP - Kit de ferramentas completo para desenvolvimento orquestrado
  • Fluxos de Trabalho Estruturados - prepare → analyze → implement → learn
  • Prompts Enriquecedores - Orientação de implementação ciente do contexto
  • Base de Conhecimento - Modelos, padrões e aprendizados persistem para sempre

📊 Para Todos

  • Painel em Tempo Real - Atualizações ao vivo via Socket.io
  • Histórico Completo - Linha do tempo de todas as decisões e mudanças
  • Capacidade de Reversão - Desfaça erros com segurança
  • Exporte Tudo - Relatórios em Markdown para as partes interessadas

🎼 A Sinfonia do Desenvolvimento

Como o Orchestro Conduz o Seu Desenvolvimento

┌─────────────────────────────────────────────────────┐
│  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              │
    └──────────────────────────────────────────┘

🚀 Início Rápido

Opção 1: Pelo Registro MCP ⭐ (Recomendado)

O Orchestro agora está no Registro Oficial MCP!

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

Ou adicione à configuração do Claude Code:

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

Opção 2: Instalação com Um Comando ⚡

npx @orchestro/init

É isso! O instalador irá:

  • ✅ Baixar e configurar o Orchestro
  • ✅ Aplicar migrações de banco de dados no Supabase
  • ✅ Configurar o Claude Code automaticamente
  • ✅ Configurar a conexão com o Supabase
  • ✅ Iniciar o painel
  • ✅ Verificar se tudo funciona

Prompts interativos:

🎭 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"

Opção 2: Instalação Manual (5 Minutos)

1. Pré-requisitos

# Node.js 18+
node --version

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

2. Configuração do Banco de Dados no Supabase

Crie seu projeto no Supabase:

  1. Acesse https://supabase.com e crie um novo projeto
  2. Aguarde o provisionamento do banco de dados (~2 minutos)
  3. Vá em Configurações → Banco de Dados e copie a String de Conexão (modo Transação)

Aplique o esquema do banco de dados:

# 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

Verifique a configuração do banco de dados:

# 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

Obtenha suas credenciais:

# 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. Script de Configuração Rápida

# 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. Configure o 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. Inicie o Painel

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

6. Verifique a Instalação

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

# You should see 60 tools! 🎭

Opção 3: Adicionar a um Projeto Existente

Já tem um projeto no Claude Code? Adicione o Orchestro:

# In your project directory
npx @orchestro/add

# Or via Claude Code config:
claude mcp add orchestro

Consulte o Guia de Integração para configurar em projetos existentes.


Opção 4: Plugin do Claude Code 🎁 (Mais Fácil!)

Novidade! Instale o Orchestro como um plugin do Claude Code com um comando:

# 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

O que você recebe:

  • ✅ Servidor MCP do Orchestro - 60 ferramentas via npx @khaoss85/orchestro@latest (sem necessidade de instalação global)
  • ✅ 5 Agentes Guardiões - banco de dados, API, arquitetura, mantenedor de testes, pronto para produção
  • ✅ Auto-configurado - Servidor MCP e agentes prontos para uso
  • ✅ Documentação Completa - Guia de configuração incluído

Pré-requisitos:

  • Conta no Supabase (veja a Opção 2 para configuração)
  • Variáveis de ambiente definidas:
    export SUPABASE_URL="https://your-project.supabase.co"
    export SUPABASE_SERVICE_KEY="your-service-key"
    export ANTHROPIC_API_KEY="your-key"
    

Verifique a instalação:

# 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

O plugin inclui:

  • Configuração do servidor MCP (.mcp.json)
  • 5 agentes guardiões especializados
  • README completo com exemplos de uso
  • Guia de solução de problemas

Consulte plugins/orchestro-suite/README.md para documentação detalhada do plugin.


🎭 Casos de Uso

📱 Para Gerentes de Produto

Cenário: Nova solicitação de recurso de uma parte interessada

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

💻 Para Desenvolvedores

Cenário: Implementando um recurso complexo

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

🤝 Para Equipes

Cenário: Colaboração multifuncional

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

🛠️ Todas as 60 Ferramentas MCP ✅ Testadas em Produção

📋 Gerenciamento de Projetos (3 ferramentas)

  • get_project_info - Metadados e status do projeto
  • get_project_configuration - Configuração completa do projeto
  • initialize_project_configuration - Configurar ferramentas e guardiões padrão

📝 Gerenciamento de Tarefas (7 ferramentas)

  • create_task - Criar com responsável, prioridade, tags, categoria
  • list_tasks - Filtrar por status/categoria/tags
  • update_task - Modificar qualquer campo com validação
  • delete_task - Exclusão segura com verificações de dependência
  • get_task_context - Contexto completo com dependências (obsoleto, use prepare_task_for_execution)
  • get_execution_order - Ordenação topológica por dependências
  • safe_delete_tasks_by_status - Exclusão em massa com verificações de segurança

⚙️ Execução e Análise de Tarefas (3 ferramentas)

  • prepare_task_for_execution - Gerar prompt de análise da base de código
  • save_task_analysis - Armazenar resultados de análise
  • get_execution_prompt - Contexto de implementação enriquecido

📖 Histórias de Usuário (4 ferramentas)

  • decompose_story - Decomposição de história → tarefas com IA e análise automática (autoAnalyze=true padrão)
  • get_user_stories - Listar todas as histórias de usuário
  • get_tasks_by_user_story - Obter todas as tarefas filhas
  • get_user_story_health - Monitorar o status de conclusão da história

🔗 Dependências e Conflitos (4 ferramentas)

  • save_dependencies - Registrar dependências de recursos da tarefa
  • get_task_dependency_graph - Visualizar gráfico de dependências
  • get_resource_usage - Encontrar tarefas que usam um recurso
  • get_task_conflicts - Detectar uso conflitante de recursos

📚 Conhecimento e Modelos (5 ferramentas)

  • list_templates - Modelos de prompt/código disponíveis
  • list_patterns - Biblioteca de padrões de codificação
  • list_learnings - Registros de experiências passadas
  • render_template - Gerar a partir de modelo com variáveis
  • get_relevant_knowledge - Sugestões cientes do contexto

🧠 Feedback e Aprendizado (7 ferramentas)

  • add_feedback - Registrar sucesso/falha/melhoria
  • get_similar_learnings - Encontrar experiências relacionadas
  • get_top_patterns - Padrões mais usados com frequência
  • get_trending_patterns - Padrões populares recentemente
  • get_pattern_stats - Métricas detalhadas de padrões
  • detect_failure_patterns - Detectar automaticamente abordagens arriscadas
  • check_pattern_risk - Avaliação de risco antes de usar o padrão

⚙️ Configuração do Projeto (14 ferramentas)

Stack de Tecnologia:

  • add_tech_stack - Adicionar framework/biblioteca
  • update_tech_stack - Atualizar versão/configuração
  • remove_tech_stack - Remover tecnologia

Subagentes (Guardiões):

  • add_sub_agent - Registrar agente guardião
  • update_sub_agent - Modificar configuração do agente
  • sync_claude_code_agents - Sincronizar de .claude/agents/
  • read_claude_code_agents - Ler arquivos do agente
  • suggest_agents_for_task - Recomendações de agentes com IA
  • update_agent_prompt_templates - Atualizar modelos de prompt

Gerenciamento de Ferramentas MCP:

  • add_mcp_tool - Registrar ferramenta MCP
  • update_mcp_tool - Atualizar configuração da ferramenta
  • suggest_tools_for_task - Recomendações de ferramentas com IA

Diretrizes e Padrões:

  • add_guideline - Adicionar diretriz de codificação
  • add_code_pattern - Adicionar padrão reutilizável

📊 Histórico e Eventos de Tarefas (13 ferramentas)

  • get_task_history - Linha do tempo completa de eventos
  • get_status_history - Registro de transição de status
  • get_decisions - Registros de decisões
  • get_guardian_interventions - Registro de atividades do guardião
  • get_code_changes - Histórico de modificações de código
  • record_decision - Registrar uma decisão com justificativa
  • record_code_change - Registrar modificações de código
  • record_guardian_intervention - Registrar ação do guardião
  • record_status_transition - Registrar mudança de status
  • get_iteration_count - Contar iterações da tarefa
  • get_task_snapshot - Estado da tarefa em um momento específico
  • rollback_task - Restaurar estado anterior
  • get_task_stats - Estatísticas agregadas

📊 Recursos do Painel

Quadro Kanban - Para Todos

Kanban Board

Visão do GP:

  • Arraste e solte histórias de usuário
  • Veja o progresso de relance
  • Indicadores de risco em linguagem simples
  • Exporte relatórios para as partes interessadas

Visão do Desenvolvedor:

  • Detalhes técnicos da tarefa
  • Indicadores de dependência
  • Selos de complexidade de código
  • Links diretos para arquivos

Página de Detalhes da Tarefa - Insights Profundos

Aba: Visão Geral (amigável para GP)

  • Descrição da história de usuário
  • Requisitos técnicos
  • Responsável e prioridade
  • Dependências explicadas

Aba: Histórico (Trilha de auditoria)

  • Linha do tempo completa de eventos
  • Registros de decisões com justificativa
  • Mudanças de código (com diffs)
  • Capacidade de reversão

Aba: Dependências (Foco do desenvolvedor)

  • Gráfico visual de dependências
  • Análise de impacto de recursos
  • Avaliação de risco
  • Detecção de conflitos

🏗️ Arquitetura

┌─────────────────────────────────────────┐
│         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                    │
└─────────────────────────────────────────┘

💡 Exemplo do Mundo Real

História: Fluxo de Checkout de E-commerce

GP escreve no painel:

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

O Orchestro decompõe (com IA):

  1. ✅ Projetar esquema do banco de dados do checkout (2h) - Sem dependências
  2. ✅ Implementar integração do serviço de pagamento (4h) - Depende de: #1
  3. ✅ Criar endpoints da API de checkout (3h) - Depende de: #2
  4. ✅ Construir componentes de UI do checkout (4h) - Depende de: #3
  5. ✅ Adicionar serviço de notificação por e-mail (2h) - Depende de: #3
  6. ✅ Implementar fluxo de confirmação de pedido (3h) - Depende de: #4, #5

Total: 18 horas, 6 tarefas, dependências mapeadas automaticamente

Fluxo do desenvolvedor (com 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"
})

Melhoria principal: O Passo 1 agora prepara a análise automaticamente, reduzindo etapas manuais do fluxo de trabalho!

O GP vê:

  • ✅ Tarefa 1 → Concluída (atualização em tempo real)
  • 🟡 Tarefa 2 → Em Andamento (Claude trabalhando)
  • ⏳ Tarefas 3-6 → Bloqueadas (aguardando dependências)
  • 📊 Progresso: 17% (1/6 tarefas concluídas)

🧪 Aprendizado de Padrões em Ação

Detecção Automática de Falhas (Economiza Tempo!)

// 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."

Resultado: Tarefas futuras de regex são concluídas mais rápido e com menos erros!


🎨 Stack de Tecnologia

Backend (Servidor MCP)

  • TypeScript 5.0
  • @modelcontextprotocol/sdk
  • Supabase (PostgreSQL)
  • Socket.io para tempo real

Frontend (Painel)

  • Next.js 14 (App Router)
  • React 18 + TypeScript
  • TailwindCSS + shadcn/ui
  • React Flow (gráficos)
  • react-markdown (renderização)

Banco de Dados (Supabase/PostgreSQL)

  • Núcleo: projects, tasks, task_dependencies
  • Conhecimento: learnings, patterns, templates, pattern_frequency
  • Recursos: resource_nodes, resource_edges, code_entities, code_dependencies
  • Sistema: event_queue, file_history, codebase_analysis
  • Tecnologia: Metadados JSONB, índices GIN, Segurança em nível de linha (RLS)

Integração com IA

  • Claude Code (protocolo MCP)
  • Decomposição de tarefas com IA
  • Reconhecimento de padrões
  • Avaliação de risco

📈 Desempenho e Escala

  • ⚡ Velocidade de Consulta: <10ms com índices GIN
  • 🔄 Tempo Real: Intervalo de polling de 1s
  • 🗄️ Armazenamento: Limpeza automática de eventos processados (24h)
  • 📊 Escalabilidade: Testado com mais de 100 tarefas
  • 🚀 Análise: Não bloqueante (delegada ao Claude)
  • 👥 Usuários: Pronto para múltiplos GPs e desenvolvedores

🔐 Segurança e Conformidade

  • ✅ Variáveis de Ambiente - Sem segredos codificados
  • ✅ Supabase RLS - Políticas de segurança em nível de linha
  • ✅ Trilha de Auditoria Completa - Cada decisão registrada
  • ✅ Processamento de Eventos - Evita ações duplicadas
  • ✅ Local Primeiro - Todos os dados na sua instância Supabase
  • ✅ Pronto para GDPR - Recursos de exportação e exclusão

📚 Documentação

Primeiros Passos

Aprofundamento


🗺️ Roadmap

✅ Fase 1: Orquestração Principal (CONCLUÍDA)

  • 60 ferramentas MCP totalmente funcionais e testadas
  • Painel em tempo real com Kanban
  • Decomposição de histórias com IA e dependências
  • Aprendizado de padrões e detecção de falhas
  • Rastreamento de dependências e detecção de conflitos
  • Metadados de tarefas (responsável, prioridade, tags, categoria)
  • Trilha de auditoria completa com histórico de tarefas
  • Gerenciamento de configuração de projetos
  • Sincronização de agentes Claude Code
  • Sugestões de agentes e ferramentas com IA

🚧 Fase 2: Empoderamento do PM (Atual)

  • Visualização do painel para PMs não técnicos
  • Modelos de histórias para recursos comuns
  • Relatórios de progresso e exportações
  • Notificações para partes interessadas
  • Explicações de riscos em linguagem simples

🔮 Fase 3: Inteligência de Equipe

  • Espaços de trabalho para múltiplas equipes
  • Compartilhamento de padrões entre projetos
  • Rastreamento de velocidade e estimativas
  • Atribuição automática com base em expertise
  • Integração com Slack/Teams

🚀 Fase 4: IA Avançada

  • Auto-orquestração com LangGraph
  • Detecção preditiva de riscos
  • Resolução automática de conflitos
  • Automação de revisão de código
  • Geração de documentação

🤝 Contribuindo

Aceitamos contribuições de PMs, Desenvolvedores e entusiastas de IA!

Para Gerentes de Produto:

  • 📝 Compartilhe modelos de histórias de usuário
  • 💡 Sugira recursos voltados para PMs
  • 📊 Relate problemas de UX

Para Desenvolvedores:

  • 🔧 Envie correções de bugs
  • ✨ Adicione novas ferramentas MCP
  • 📈 Melhore a detecção de padrões

Como contribuir:

  1. Faça um fork do repositório
  2. Crie uma branch de recurso (git checkout -b feature/amazing-feature)
  3. Faça commit das alterações (git commit -m 'Add amazing feature')
  4. Envie para a branch (git push origin feature/amazing-feature)
  5. Abra um Pull Request

📝 Changelog

v2.1.0 (2025-10-10) - Atual 🎉

  • ✅ Publicado no Registro MCP - Agora no Registro Oficial MCP
  • ✅ Pacote NPM - Publicado como @khaoss85/orchestro no npm
  • ✅ 60 Ferramentas MCP - Expandido de 27 para 60 ferramentas prontas para produção
  • ✅ Análise Automática de Tarefas - decompose_story agora prepara automaticamente prompts de análise (autoAnalyze=true padrão)
  • ✅ Sistema de Configuração de Projetos - Gerenciamento completo de stack tecnológico, agentes e ferramentas
  • ✅ Sincronização de Agentes Claude Code - Sincronização automática com o diretório .claude/agents/
  • ✅ Sugestões de Agentes/Ferramentas com IA - Recomendações inteligentes para tarefas
  • ✅ Histórico de Tarefas e Eventos - Trilha de auditoria completa com 13 ferramentas de histórico
  • ✅ Saúde da História de Usuário - Monitoramento de conclusão e alinhamento de status
  • ✅ Correção de Bug - Erro SQL resolvido em get_project_configuration
  • ✅ Cobertura Completa de Testes - Todas as 60 ferramentas testadas e verificadas (96,7% de sucesso)

v2.0.0 (2025-10-03)

  • ✅ Renomeado para Orchestro - "Seu Maestro de Desenvolvimento com IA"
  • ✅ Ferramentas de Análise de Padrões - 5 novas ferramentas MCP para detecção de falhas
  • ✅ Frequência de Padrões - Rastreamento automático com gatilhos de banco de dados
  • ✅ Avaliação de Riscos - detect_failure_patterns & check_pattern_risk
  • ✅ Metadados de Tarefas - campos de responsável, prioridade e tags
  • ✅ Documentação Focada em PM - Atualizada para gerentes de produto

v1.5.0 (2025-10-02)

  • ✅ Novo fluxo de trabalho: MCP orquestra, Claude Code analisa
  • ✅ 3 ferramentas de execução: prepare, save_analysis, get_execution_prompt
  • ✅ Coluna JSONB tasks.metadata
  • ✅ Fila de eventos atualizada (8 tipos de eventos)
  • ✅ Verificação Guardian aprovada

v1.0.0

  • Implementação inicial do MCP
  • Gerenciamento básico de tarefas
  • Decomposição de histórias com IA
  • Integração com base de conhecimento

🌟 Histórias de Sucesso

"Como PM, finalmente entendo o que os desenvolvedores estão construindo em tempo real. O Orchestro preenche a lacuna entre a visão do produto e a implementação técnica." — Seu depoimento aqui

"O aprendizado de padrões nos economizou horas. O sistema alertou sobre uma abordagem arriscada antes de perdermos tempo com ela." — Seu depoimento aqui


📞 Suporte e Comunidade


📜 Licença

Licença MIT - Consulte o arquivo LICENSE para detalhes


🙏 Agradecimentos

  • Claude Code - Plataforma MCP e desenvolvimento com IA
  • Supabase - Banco de dados e infraestrutura em tempo real
  • Next.js - Framework React para o painel
  • React Flow - Belos gráficos de dependências
  • shadcn/ui - Componentes de UI deslumbrantes

🎭 Pronto para Conduzir Sua Sinfonia de Desenvolvimento?

Transforme ideias de produto em código de produção com orquestração por IA

Começar · Guia PM · Guia Dev · Ver Exemplos


Status: ✅ Pronto para Produção (96,7% de Cobertura de Testes) Versão: 2.1.0 NPM: @khaoss85/orchestro Registro: Registro MCP Ferramentas MCP: 60 Feito para: PMs · Desenvolvedores · Claude Code


🎼 Conduzindo o desenvolvimento, uma tarefa de cada vez

Feito com ❤️ por desenvolvedores que se importam com o produto

⭐ Dê uma estrela no GitHub para apoiar o projeto!