ZeroToRepo: Criei um Agente de IA que Transforma Ideias do Notion em Repos do GitHub Antes do Seu Café Esfriar
Esta é uma submissão para o Desafio Notion MCP
O que eu construí
Eu tenho um banco de dados no Notion com mais de 30 ideias de startups. Cada uma seguiu o mesmo padrão: ficar empolgado, anotar a ideia, me dizer "começarei amanhã"… e então passar as próximas 3 horas configurando um repositório, pesquisando concorrentes, criando issues no GitHub e perdendo todo o ímpeto antes de escrever uma única linha de código real.
Na ideia #15, percebi que o problema não era motivação. Era a lacuna de inicialização, aquele tempo morto entre ter uma ideia e fazer o primeiro commit. Então, eu construí a coisa que teria me salvado todas aquelas horas desperdiçadas.
ZeroToRepo é um agente autônomo de IA. Você marca uma única caixa de seleção no Notion e, em 2 minutos, ele:
- Pesquisou seu mercado : 5-8 consultas ao Brave Search ao vivo, analisadas por IA para extrair concorrentes, lacunas e tendências
Nomeou sua startup : nome de marca gerado por IA + slogan fundamentado na pesquisa
Escreveu uma Análise de Mercado : salva como uma subpágina formatada no Notion com títulos apropriados e texto em negrito
Construiu uma estratégia de 4 semanas : cada tarefa mapeia para uma lacuna competitiva: "Concorrentes carecem de X → Semana 2: Construir Y"
Estruturou um repositório privado no GitHub : README com tabela de concorrentes, package.json, src/index.js, tudo via commits fantasmas (zero git local)
Abriu Issues rotuladas no GitHub : cada uma refere-se à lacuna que aborda, com prioridade e responsável
Sintetizou um Resumo do Projeto : concorrentes, justificativa do roadmap, link do GitHub e timestamp, tudo de volta ao Notion
Aqui está a coisa que realmente a torna interessante: o LLM decide o que fazer. Isso não é um script codificado que executa passo 1, passo 2, passo 3. É um agente alimentado por Groq com 12 ferramentas e chamadas de função. A IA vê as descrições das ferramentas, escolhe o que chamar a seguir e, se algo falhar, decide como se recuperar. A IA é a orquestradora.
Dois comandos. É isso.
npm run setup # Assistente interativo: coleta chaves, testa todas as 4 conexões
npm start # Monitora o Notion. Verifique ☑️ Trigger. Pronto.
Demonstração
Mostre-nos o Código
GitHub: https://github.com/Abeera81/zerotorepo
Arquitetura
O Pipeline de 4 Fases
Registro de Ferramentas do Agente (12 Ferramentas)
| Ferramenta | Fase | O que faz |
|---|---|---|
update_notion_status |
Todas | Atualiza o status do Notion via MCP |
deep_search |
Pesquisa | 5-8 pesquisas no Brave (com fallback) |
analyze_market |
Pesquisa | IA → concorrentes, lacunas, insights |
generate_startup_name |
Pesquisa | Nome criativo + slogan |
save_market_analysis |
Pesquisa | Escreve no Notion via MCP |
generate_strategy |
Estratégia | Roadmap de 4 semanas visando lacunas |
save_strategy_to_notion |
Estratégia | Escreve no Notion via MCP |
create_github_repo |
Execução | Repositório privado + commit fantasma |
set_github_url |
Execução | Armazena URL no Notion via MCP |
create_github_issues |
Execução | Issues rotuladas do roadmap |
write_project_brief |
Síntese | Resumo do Projeto → Notion via MCP |
finalize_idea |
Síntese | Marcar como concluído, desmarcar trigger |
Estrutura do Projeto
zerotorepo/
├── src/
│ ├── index.js # CLI — loop de polling, @clack/prompts TUI
│ ├── agent.js # 🤖 Agente LLM — chamadas de função Groq, 12 ferramentas
│ ├── stateMachine.js # Rotas: ao vivo → agente, simulado → sequencial
│ ├── mcp-client.js # Cliente MCP — inicia o servidor Notion MCP (stdio)
│ ├── mcp-server.js # ZeroToRepo como servidor MCP — 7 ferramentas para assistentes de IA
│ ├── notion.js # Notion via MCP — conversor de markdown para blocos
│ ├── research.js # Pesquisa no Brave (5-8 consultas) + análise Groq
│ ├── scaffold.js # Commits fantasmas do GitHub + README rico
│ ├── roadmap.js # Estratégia de 4 semanas visando lacunas
│ └── brief.js # Síntese do Resumo do Projeto
├── scripts/
│ ├── setup.js # Assistente interativo de configuração
│ └── reset-db.js # Redefinir banco de dados do Notion
└── prompts/ # Prompts do sistema LLM
Como eu usei o Notion MCP
O Notion MCP é o sistema nervoso central do ZeroToRepo. Cada operação no Notion passa pelo MCP.
Consumindo o Servidor Notion MCP como Cliente MCP
O ZeroToRepo inicia @notionhq/notion-mcp-server (v2.2.1) como um processo filho via transporte stdio. Todas as 22 ferramentas MCP estão disponíveis. Usamos 5:
