# 🚀 Agent Orchestrator
**Transforme suas ideias em código automaticamente!** O Agent Orchestrator é uma ferramenta que usa IA para automatizar o desenvolvimento de software. Basta escrever o que você quer fazer e ele cuida do resto.
## 🎯 O que é?
Imagine ter dois desenvolvedores experientes trabalhando para você:
- **Claude** 🧠: O arquiteto pensador - planeja, analisa e resolve problemas complexos
- **Gemini** ⚡: O executor rápido - implementa, testa e entrega resultados
O Agent Orchestrator coordena esses dois "desenvolvedores IA" para transformar suas ideias em código real!
## 🎬 Demo Rápida
```bash
# Instalar
pip install agent-orchestrator
# Criar um arquivo com suas ideias
echo "Quero um sistema de blog com posts e comentários" > meu_projeto.md
# Deixar a mágica acontecer!
agent-orchestrator execute-backlog meu_projeto.md
```
Em minutos, você terá o código pronto! 🎉
## 📦 Instalação
### Pré-requisitos
Você precisa ter instalado:
- Python 3.10 ou superior
- Claude CLI ([instruções](https://claude.ai/claude-cli))
- Gemini CLI ([instruções](https://gemini.google.com/cli))
### Instalar o Agent Orchestrator
```bash
pip install agent-orchestrator
```
### Verificar instalação
```bash
agent-orchestrator --version
agent-orchestrator test-agents
```
## 🎮 Como Usar
### 1️⃣ Escreva suas ideias em Markdown
Crie um arquivo `projeto.md`:
```markdown
# Meu Sistema de Tarefas
## Funcionalidades
### TASK-001: Criar tarefas
Como usuário, quero criar novas tarefas com título e descrição
- Deve ter título (obrigatório)
- Deve ter descrição (opcional)
- Deve ter data de criação automática
### TASK-002: Listar tarefas
Como usuário, quero ver todas as minhas tarefas
- Mostrar em ordem de criação
- Mostrar título e status
- Permitir filtrar por status
### TASK-003: Marcar como concluída
Como usuário, quero marcar tarefas como concluídas
- Mudar status para "concluído"
- Registrar data de conclusão
```
### 2️⃣ Execute o comando mágico
```bash
# Opção 1: Executar tudo de uma vez
agent-orchestrator execute-backlog projeto.md
# Opção 2: Ver o que será feito primeiro
agent-orchestrator analyze-backlog projeto.md
# Opção 3: Executar uma tarefa específica
agent-orchestrator execute-task TASK-001
```
### 3️⃣ Acompanhe o progresso
O Agent Orchestrator mostra tudo que está fazendo:
```
🤖 Claude analisando TASK-001...
✅ Análise concluída em 2.3s
🤖 Gemini implementando código...
✅ Arquivo criado: task_manager.py
✅ Testes criados: test_task_manager.py
🎉 Tarefa TASK-001 concluída!
```
## 📚 Exemplos Práticos
### Exemplo 1: API REST Simples
```markdown
# API de Produtos
### TASK-001: Endpoint para listar produtos
Como desenvolvedor, preciso de um endpoint GET /products
- Retornar lista JSON
- Incluir id, nome e preço
### TASK-002: Endpoint para criar produto
Como desenvolvedor, preciso de um endpoint POST /products
- Receber nome e preço
- Validar dados
- Retornar produto criado
```
Comando:
```bash
agent-orchestrator execute-backlog api_produtos.md --agent claude
```
### Exemplo 2: Script de Automação
```markdown
# Automação de Backup
### TASK-001: Backup de arquivos
Como admin, quero fazer backup de uma pasta
- Copiar todos os arquivos
- Comprimir em ZIP
- Adicionar data no nome do arquivo
```
Comando:
```bash
agent-orchestrator execute-task TASK-001 --agent gemini
```
## 🛠️ Comandos Disponíveis
### Análise e Planejamento
```bash
# Analisar um backlog
agent-orchestrator analyze-backlog arquivo.md
# Gerar um sprint (conjunto de tarefas)
agent-orchestrator generate-sprint arquivo.md --points 20
```
### Execução
```bash
# Executar uma tarefa específica
agent-orchestrator execute-task TASK-001
# Executar um backlog completo
agent-orchestrator execute-backlog arquivo.md
# Executar com agente específico
agent-orchestrator execute-task TASK-001 --agent claude # ou gemini
```
### Configuração e Status
```bash
# Testar conexão com os agentes
agent-orchestrator test-agents
# Ver configurações
agent-orchestrator show-config
# Configurar agentes
agent-orchestrator configure-agents
```
## 📝 Formato do Backlog
O Agent Orchestrator entende markdown simples. Cada tarefa deve ter:
```markdown
### TASK-XXX: Título da tarefa
Descrição do que precisa ser feito
- Detalhe 1
- Detalhe 2
- Detalhe 3
```
**Dicas:**
- Use IDs únicos (TASK-001, FEAT-001, BUG-001)
- Seja claro e específico
- Liste critérios de aceite
- Adicione exemplos quando possível
## 🎯 Casos de Uso
### Para Desenvolvedores Solo
- **Prototipar rapidamente**: Transforme ideias em código funcional
- **Automatizar tarefas chatas**: Deixe a IA fazer o trabalho repetitivo
- **Aprender**: Veja como a IA implementa diferentes soluções
### Para Times
- **Acelerar desenvolvimento**: Complete sprints mais rápido
- **Padronizar código**: IA segue sempre as mesmas práticas
- **Documentar automaticamente**: Código vem com documentação
### Para Estudantes
- **Aprender programação**: Veja exemplos práticos
- **Fazer projetos**: Complete trabalhos mais rápido
- **Entender conceitos**: IA explica o que está fazendo
## 🔧 Configuração Avançada
### Escolher Agente Padrão
```bash
# Claude para tarefas complexas (padrão)
agent-orchestrator execute-task TASK-001 --agent claude
# Gemini para tarefas rápidas
agent-orchestrator execute-task TASK-001 --agent gemini
# Deixar o sistema escolher
agent-orchestrator execute-task TASK-001 --agent auto
```
### Configurar Limites
```bash
# Limitar pontos por sprint
agent-orchestrator generate-sprint backlog.md --points 30
# Definir prioridade mínima
agent-orchestrator generate-sprint backlog.md --priority high
```
## 🐛 Resolução de Problemas
### "Agente não encontrado"
```bash
# Verificar instalação
agent-orchestrator test-agents
# Instalar Claude CLI
npm install -g @anthropic-ai/claude-cli
# Instalar Gemini CLI
npm install -g @google/gemini-cli
```
### "Erro 429 - Muitas requisições"
- Aguarde alguns minutos
- Use `--agent claude` (geralmente tem limites maiores)
- Configure suas próprias API keys
### "Tarefa falhou"
- Verifique se a descrição está clara
- Adicione mais detalhes e exemplos
- Tente com outro agente
## 🤝 Contribuindo
Adoramos contribuições! Veja como ajudar:
1. Reporte bugs: [Issues](https://github.com/luhfilho/agent-orchestrator/issues)
2. Sugira melhorias: [Discussions](https://github.com/luhfilho/agent-orchestrator/discussions)
3. Envie código: [Pull Requests](https://github.com/luhfilho/agent-orchestrator/pulls)
## 📄 Licença
MIT - Use livremente em seus projetos!
## 🌟 Dicas Finais
1. **Comece simples**: Teste com uma tarefa antes de um backlog completo
2. **Seja específico**: Quanto mais detalhes, melhor o resultado
3. **Itere**: Se o resultado não ficou perfeito, refine a descrição
4. **Experimente**: Cada agente tem seus pontos fortes
5. **Divirta-se**: Deixe a IA trabalhar enquanto você foca no que importa!
---
**Feito com ❤️ pela comunidade Agent Orchestrator**
*Transformando ideias em código, uma tarefa por vez!* 🚀
Raw data
{
"_id": null,
"home_page": "https://github.com/luhfilho/agent-orchestrator",
"name": "agent-orchestrator",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": "Agent Orchestrator Team <team@agent-orchestrator.dev>",
"keywords": "ai, agents, orchestration, development, automation, claude, gemini, software-development, task-automation",
"author": "Agent Orchestrator Team",
"author_email": "Agent Orchestrator Team <team@agent-orchestrator.dev>",
"download_url": "https://files.pythonhosted.org/packages/f9/5a/1426139e1db4a9e2afbc9c36c86a88066d6a1bd3125482da37e60fecd387/agent_orchestrator-2.0.0.tar.gz",
"platform": null,
"description": "# \ud83d\ude80 Agent Orchestrator\n\n**Transforme suas ideias em c\u00f3digo automaticamente!** O Agent Orchestrator \u00e9 uma ferramenta que usa IA para automatizar o desenvolvimento de software. Basta escrever o que voc\u00ea quer fazer e ele cuida do resto.\n\n## \ud83c\udfaf O que \u00e9?\n\nImagine ter dois desenvolvedores experientes trabalhando para voc\u00ea:\n- **Claude** \ud83e\udde0: O arquiteto pensador - planeja, analisa e resolve problemas complexos\n- **Gemini** \u26a1: O executor r\u00e1pido - implementa, testa e entrega resultados\n\nO Agent Orchestrator coordena esses dois \"desenvolvedores IA\" para transformar suas ideias em c\u00f3digo real!\n\n## \ud83c\udfac Demo R\u00e1pida\n\n```bash\n# Instalar\npip install agent-orchestrator\n\n# Criar um arquivo com suas ideias\necho \"Quero um sistema de blog com posts e coment\u00e1rios\" > meu_projeto.md\n\n# Deixar a m\u00e1gica acontecer!\nagent-orchestrator execute-backlog meu_projeto.md\n```\n\nEm minutos, voc\u00ea ter\u00e1 o c\u00f3digo pronto! \ud83c\udf89\n\n## \ud83d\udce6 Instala\u00e7\u00e3o\n\n### Pr\u00e9-requisitos\nVoc\u00ea precisa ter instalado:\n- Python 3.10 ou superior\n- Claude CLI ([instru\u00e7\u00f5es](https://claude.ai/claude-cli))\n- Gemini CLI ([instru\u00e7\u00f5es](https://gemini.google.com/cli))\n\n### Instalar o Agent Orchestrator\n```bash\npip install agent-orchestrator\n```\n\n### Verificar instala\u00e7\u00e3o\n```bash\nagent-orchestrator --version\nagent-orchestrator test-agents\n```\n\n## \ud83c\udfae Como Usar\n\n### 1\ufe0f\u20e3 Escreva suas ideias em Markdown\n\nCrie um arquivo `projeto.md`:\n\n```markdown\n# Meu Sistema de Tarefas\n\n## Funcionalidades\n\n### TASK-001: Criar tarefas\nComo usu\u00e1rio, quero criar novas tarefas com t\u00edtulo e descri\u00e7\u00e3o\n- Deve ter t\u00edtulo (obrigat\u00f3rio)\n- Deve ter descri\u00e7\u00e3o (opcional)\n- Deve ter data de cria\u00e7\u00e3o autom\u00e1tica\n\n### TASK-002: Listar tarefas\nComo usu\u00e1rio, quero ver todas as minhas tarefas\n- Mostrar em ordem de cria\u00e7\u00e3o\n- Mostrar t\u00edtulo e status\n- Permitir filtrar por status\n\n### TASK-003: Marcar como conclu\u00edda\nComo usu\u00e1rio, quero marcar tarefas como conclu\u00eddas\n- Mudar status para \"conclu\u00eddo\"\n- Registrar data de conclus\u00e3o\n```\n\n### 2\ufe0f\u20e3 Execute o comando m\u00e1gico\n\n```bash\n# Op\u00e7\u00e3o 1: Executar tudo de uma vez\nagent-orchestrator execute-backlog projeto.md\n\n# Op\u00e7\u00e3o 2: Ver o que ser\u00e1 feito primeiro\nagent-orchestrator analyze-backlog projeto.md\n\n# Op\u00e7\u00e3o 3: Executar uma tarefa espec\u00edfica\nagent-orchestrator execute-task TASK-001\n```\n\n### 3\ufe0f\u20e3 Acompanhe o progresso\n\nO Agent Orchestrator mostra tudo que est\u00e1 fazendo:\n\n```\n\ud83e\udd16 Claude analisando TASK-001...\n\u2705 An\u00e1lise conclu\u00edda em 2.3s\n\ud83e\udd16 Gemini implementando c\u00f3digo...\n\u2705 Arquivo criado: task_manager.py\n\u2705 Testes criados: test_task_manager.py\n\ud83c\udf89 Tarefa TASK-001 conclu\u00edda!\n```\n\n## \ud83d\udcda Exemplos Pr\u00e1ticos\n\n### Exemplo 1: API REST Simples\n\n```markdown\n# API de Produtos\n\n### TASK-001: Endpoint para listar produtos\nComo desenvolvedor, preciso de um endpoint GET /products\n- Retornar lista JSON\n- Incluir id, nome e pre\u00e7o\n\n### TASK-002: Endpoint para criar produto\nComo desenvolvedor, preciso de um endpoint POST /products\n- Receber nome e pre\u00e7o\n- Validar dados\n- Retornar produto criado\n```\n\nComando:\n```bash\nagent-orchestrator execute-backlog api_produtos.md --agent claude\n```\n\n### Exemplo 2: Script de Automa\u00e7\u00e3o\n\n```markdown\n# Automa\u00e7\u00e3o de Backup\n\n### TASK-001: Backup de arquivos\nComo admin, quero fazer backup de uma pasta\n- Copiar todos os arquivos\n- Comprimir em ZIP\n- Adicionar data no nome do arquivo\n```\n\nComando:\n```bash\nagent-orchestrator execute-task TASK-001 --agent gemini\n```\n\n## \ud83d\udee0\ufe0f Comandos Dispon\u00edveis\n\n### An\u00e1lise e Planejamento\n```bash\n# Analisar um backlog\nagent-orchestrator analyze-backlog arquivo.md\n\n# Gerar um sprint (conjunto de tarefas)\nagent-orchestrator generate-sprint arquivo.md --points 20\n```\n\n### Execu\u00e7\u00e3o\n```bash\n# Executar uma tarefa espec\u00edfica\nagent-orchestrator execute-task TASK-001\n\n# Executar um backlog completo\nagent-orchestrator execute-backlog arquivo.md\n\n# Executar com agente espec\u00edfico\nagent-orchestrator execute-task TASK-001 --agent claude # ou gemini\n```\n\n### Configura\u00e7\u00e3o e Status\n```bash\n# Testar conex\u00e3o com os agentes\nagent-orchestrator test-agents\n\n# Ver configura\u00e7\u00f5es\nagent-orchestrator show-config\n\n# Configurar agentes\nagent-orchestrator configure-agents\n```\n\n## \ud83d\udcdd Formato do Backlog\n\nO Agent Orchestrator entende markdown simples. Cada tarefa deve ter:\n\n```markdown\n### TASK-XXX: T\u00edtulo da tarefa\nDescri\u00e7\u00e3o do que precisa ser feito\n- Detalhe 1\n- Detalhe 2\n- Detalhe 3\n```\n\n**Dicas:**\n- Use IDs \u00fanicos (TASK-001, FEAT-001, BUG-001)\n- Seja claro e espec\u00edfico\n- Liste crit\u00e9rios de aceite\n- Adicione exemplos quando poss\u00edvel\n\n## \ud83c\udfaf Casos de Uso\n\n### Para Desenvolvedores Solo\n- **Prototipar rapidamente**: Transforme ideias em c\u00f3digo funcional\n- **Automatizar tarefas chatas**: Deixe a IA fazer o trabalho repetitivo\n- **Aprender**: Veja como a IA implementa diferentes solu\u00e7\u00f5es\n\n### Para Times\n- **Acelerar desenvolvimento**: Complete sprints mais r\u00e1pido\n- **Padronizar c\u00f3digo**: IA segue sempre as mesmas pr\u00e1ticas\n- **Documentar automaticamente**: C\u00f3digo vem com documenta\u00e7\u00e3o\n\n### Para Estudantes\n- **Aprender programa\u00e7\u00e3o**: Veja exemplos pr\u00e1ticos\n- **Fazer projetos**: Complete trabalhos mais r\u00e1pido\n- **Entender conceitos**: IA explica o que est\u00e1 fazendo\n\n## \ud83d\udd27 Configura\u00e7\u00e3o Avan\u00e7ada\n\n### Escolher Agente Padr\u00e3o\n```bash\n# Claude para tarefas complexas (padr\u00e3o)\nagent-orchestrator execute-task TASK-001 --agent claude\n\n# Gemini para tarefas r\u00e1pidas\nagent-orchestrator execute-task TASK-001 --agent gemini\n\n# Deixar o sistema escolher\nagent-orchestrator execute-task TASK-001 --agent auto\n```\n\n### Configurar Limites\n```bash\n# Limitar pontos por sprint\nagent-orchestrator generate-sprint backlog.md --points 30\n\n# Definir prioridade m\u00ednima\nagent-orchestrator generate-sprint backlog.md --priority high\n```\n\n## \ud83d\udc1b Resolu\u00e7\u00e3o de Problemas\n\n### \"Agente n\u00e3o encontrado\"\n```bash\n# Verificar instala\u00e7\u00e3o\nagent-orchestrator test-agents\n\n# Instalar Claude CLI\nnpm install -g @anthropic-ai/claude-cli\n\n# Instalar Gemini CLI \nnpm install -g @google/gemini-cli\n```\n\n### \"Erro 429 - Muitas requisi\u00e7\u00f5es\"\n- Aguarde alguns minutos\n- Use `--agent claude` (geralmente tem limites maiores)\n- Configure suas pr\u00f3prias API keys\n\n### \"Tarefa falhou\"\n- Verifique se a descri\u00e7\u00e3o est\u00e1 clara\n- Adicione mais detalhes e exemplos\n- Tente com outro agente\n\n## \ud83e\udd1d Contribuindo\n\nAdoramos contribui\u00e7\u00f5es! Veja como ajudar:\n\n1. Reporte bugs: [Issues](https://github.com/luhfilho/agent-orchestrator/issues)\n2. Sugira melhorias: [Discussions](https://github.com/luhfilho/agent-orchestrator/discussions)\n3. Envie c\u00f3digo: [Pull Requests](https://github.com/luhfilho/agent-orchestrator/pulls)\n\n## \ud83d\udcc4 Licen\u00e7a\n\nMIT - Use livremente em seus projetos!\n\n## \ud83c\udf1f Dicas Finais\n\n1. **Comece simples**: Teste com uma tarefa antes de um backlog completo\n2. **Seja espec\u00edfico**: Quanto mais detalhes, melhor o resultado\n3. **Itere**: Se o resultado n\u00e3o ficou perfeito, refine a descri\u00e7\u00e3o\n4. **Experimente**: Cada agente tem seus pontos fortes\n5. **Divirta-se**: Deixe a IA trabalhar enquanto voc\u00ea foca no que importa!\n\n---\n\n**Feito com \u2764\ufe0f pela comunidade Agent Orchestrator**\n\n*Transformando ideias em c\u00f3digo, uma tarefa por vez!* \ud83d\ude80\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Orquestrador de Agentes de IA para Desenvolvimento de Software",
"version": "2.0.0",
"project_urls": {
"Bug Tracker": "https://github.com/luhfilho/agent-orchestrator/issues",
"Changelog": "https://github.com/luhfilho/agent-orchestrator/blob/main/CHANGELOG.md",
"Documentation": "https://github.com/luhfilho/agent-orchestrator/blob/main/README.md",
"Homepage": "https://github.com/luhfilho/agent-orchestrator",
"Repository": "https://github.com/luhfilho/agent-orchestrator.git"
},
"split_keywords": [
"ai",
" agents",
" orchestration",
" development",
" automation",
" claude",
" gemini",
" software-development",
" task-automation"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "ba7c257a81026cf41df7df6f2278fbb235b17385d14fadb0851b4b7fe293d5be",
"md5": "6b0cc3f6df634657540f987f2e35ddf4",
"sha256": "b30a35b16e03b0a42071ea86a980ad1e5a7af78da6f27c349d9923e0fded688c"
},
"downloads": -1,
"filename": "agent_orchestrator-2.0.0-py3-none-any.whl",
"has_sig": false,
"md5_digest": "6b0cc3f6df634657540f987f2e35ddf4",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 90335,
"upload_time": "2025-07-24T00:10:37",
"upload_time_iso_8601": "2025-07-24T00:10:37.447677Z",
"url": "https://files.pythonhosted.org/packages/ba/7c/257a81026cf41df7df6f2278fbb235b17385d14fadb0851b4b7fe293d5be/agent_orchestrator-2.0.0-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "f95a1426139e1db4a9e2afbc9c36c86a88066d6a1bd3125482da37e60fecd387",
"md5": "9c878d5b49870048334ad430e6cc776b",
"sha256": "7149a4f44e6ebe471fb18b08a4bb4aeaa627cb2c04f744f78c94804bb4728674"
},
"downloads": -1,
"filename": "agent_orchestrator-2.0.0.tar.gz",
"has_sig": false,
"md5_digest": "9c878d5b49870048334ad430e6cc776b",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 150570,
"upload_time": "2025-07-24T00:10:38",
"upload_time_iso_8601": "2025-07-24T00:10:38.719029Z",
"url": "https://files.pythonhosted.org/packages/f9/5a/1426139e1db4a9e2afbc9c36c86a88066d6a1bd3125482da37e60fecd387/agent_orchestrator-2.0.0.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-24 00:10:38",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "luhfilho",
"github_project": "agent-orchestrator",
"travis_ci": false,
"coveralls": false,
"github_actions": false,
"requirements": [
{
"name": "rich",
"specs": [
[
">=",
"13.0.0"
]
]
},
{
"name": "click",
"specs": [
[
">=",
"8.0.0"
]
]
},
{
"name": "pydantic",
"specs": [
[
">=",
"2.0.0"
]
]
},
{
"name": "pyyaml",
"specs": [
[
">=",
"6.0"
]
]
},
{
"name": "watchdog",
"specs": [
[
">=",
"3.0.0"
]
]
},
{
"name": "aiohttp",
"specs": [
[
">=",
"3.8.0"
]
]
},
{
"name": "pytest",
"specs": [
[
">=",
"7.0.0"
]
]
},
{
"name": "pytest-asyncio",
"specs": [
[
">=",
"0.21.0"
]
]
},
{
"name": "black",
"specs": [
[
">=",
"23.0.0"
]
]
},
{
"name": "flake8",
"specs": [
[
">=",
"6.0.0"
]
]
},
{
"name": "mypy",
"specs": [
[
">=",
"1.0.0"
]
]
}
],
"lcname": "agent-orchestrator"
}
JSON
