Conheça o AIPIM 2.0

Evolução para a Autonomia: Por que Reescrevi o AIPIM para a v2.0.0?

Desde a criação do AIPIM, meu objetivo tem sido preencher a lacuna entre desenvolvedores humanos e assistentes de código com IA. Eu queria uma maneira estruturada, reprodutível e rica em contexto de gerenciar o desenvolvimento de software auxiliado por IA. A versão 1.3.0 foi o ápice dessa visão inicial: um sistema robusto que dependia de arquivos Markdown como a fonte da verdade, um fluxo de trabalho de prompts baseado na área de transferência e uma integração profunda com ferramentas como o Cursor.

Mas à medida que agentes de IA como o Claude Code evoluíram, o modelo antigo começou a mostrar seus limites. Humanos não deveriam ser a camada de API entre um LLM e o sistema de arquivos.

Hoje, estou empolgado em anunciar o AIPIM v2.0.0 - uma reescrita arquitetural completa que faz a transição do AIPIM de um gerador de prompts semi-manual para um ecossistema nativo Model Context Protocol (MCP), totalmente autônomo e baseado em event sourcing.

Aqui está um mergulho profundo nas diferenças técnicas, nos motivos por trás dessa mudança massiva, nas vantagens que ela traz e como você pode aproveitá-la hoje.

AIPIM agora é mais poderoso:

$ aipim ui
AIPIM MCP server running at http://localhost:3141/mcp
REST API available at  http://localhost:3141/api/tasks
UI available at        http://localhost:3141/ui/
Add to Claude Code: claude mcp add aipim http://localhost:3141/mcp

Por que Mudar a Arquitetura v1.x?

O Paradigma da v1.3.0

No AIPIM 1.x, o estado do projeto vivia inteiramente em arquivos .md localizados no diretório .project/ (backlog/, in-progress/, completed/). O fluxo de trabalho dependia fortemente de comandos CLI como aipim start, aipim resume e aipim pause.

• O Fluxo: O humano executava um comando. A CLI lia os arquivos markdown, empacotava o contexto em um enorme prompt de texto e o copiava para a área de transferência do sistema operacional. O humano então colava isso em uma interface de chat com a IA.
• As Falhas:
  • Concorrência: Se vários membros da equipe (ou várias ramificações de IA) atualizassem os arquivos de backlog em Markdown simultaneamente, conflitos de mesclagem do Git eram inevitáveis e dolorosos de resolver.
  • Atrito: Os humanos atuavam como conduítes de API massivos e lentos, alternando constantemente as janelas para copiar e colar contexto.
  • Integridade do estado: Fazer o parse do Markdown para extrair dados estruturados (como status de tarefas ou bloqueios) era inerentemente frágil.

Percebi que à medida que os LLMs faziam a transição de "chat bots" para "agentes autônomos", nossas ferramentas precisavam suportar interações estruturadas e programáticas.

A Arquitetura Baseada em Event Sourcing & Nativa MCP

Para resolver esses gargalos, joguei fora a área de transferência e o frágil parse de Markdown. O AIPIM 2.0.0 é construído sobre três pilares técnicos fundamentais:

Event Sourcing

A fonte da verdade não é mais uma coleção de arquivos Markdown. Agora é um único arquivo JSON Lines apenas para adição (events.jsonl).

• Cada ação (criar uma tarefa, atualizar um status, adicionar um comentário, registrar uma decisão) é registrada como um evento imutável.
• Por que isso é revolucionário em relação à 1.x: Ao mudar para um log apenas de adição (append-only), eliminei os conflitos de mesclagem do Git. O AIPIM v2 configura automaticamente seu repositório Git com um driver union merge (.gitattributes). Se dois desenvolvedores concluem tarefas diferentes exatamente ao mesmo tempo, o Git simplesmente anexa ambas as linhas JSON. Sem conflitos, zero perda de dados.

Estado Derivado em SQLite

Embora um log apenas de adição seja ótimo para gravação, ele é terrível para consultas. Para resolver isso, o AIPIM 2.0 usa um banco de dados SQLite local para projetar o log de eventos em tabelas consultáveis (Tarefas, Comentários, Decisões).

• Esse estado é inteiramente efêmero e derivado. Você pode reconstruir o banco de dados inteiro do zero reproduzindo o arquivo events.jsonl em milissegundos. Isso garante consistência perfeita ao mesmo tempo em que fornece operações de leitura ultra-rápidas.

Servidor MCP Nativo

O Model Context Protocol (MCP) permite que ferramentas de IA leiam e gravem com segurança em seus ambientes locais. Na v2.0.0, o AIPIM sobe um servidor HTTP Hono local que atua como um servidor MCP.

• Chega de copiar e colar: Ferramentas como o Claude Code se conectam diretamente ao servidor MCP do AIPIM via porta 3141.
• O LLM pode chamar de forma independente as Ferramentas de Leitura (list_tasks, get_next_task, get_project_context) para entender o que precisa ser feito.
• Uma vez que o trabalho esteja concluído, o LLM chama as Ferramentas de Escrita (complete_task, log_decision) para atualizar o estado do projeto de forma autônoma. A própria IA conduz o sistema de gerenciamento de projetos.

A UI em Tempo Real com Svelte 5

Como os agentes de IA agora estão fazendo o trabalho pesado em segundo plano, os desenvolvedores humanos precisam de uma maneira melhor de visualizar o que a IA está fazendo.

O AIPIM 2.0 vem com uma interface de usuário incrivelmente rápida e bonita construída em Svelte 5 (Runes), Vite 6 e Tailwind CSS v4.

• Tudo em Tempo Real: A UI se conecta ao backend do AIPIM via Server-Sent Events (SSE). Quando um agente de IA conclui uma tarefa através do servidor MCP, seu quadro Kanban e dashboard são atualizados instantaneamente, sem recarregar a página.
• Recursos Ricos: Inclui um dashboard, um quadro Kanban interativo de arrastar e soltar em HTML5, uma linha do tempo cronológica de eventos e visualizações de detalhes de tarefas renderizadas em Markdown, com edição inline e threads de comentários.
• Incrivelmente Leve: O pacote inteiro da aplicação pesa menos de 40 KB quando compactado com gzip.

Como Usar o AIPIM 2.0?

Instale globalmente com npm install -g aipim e depois, em qualquer projeto, utilize aipim install.

A Migração é Indolor

Se você tem um projeto v1.x existente, construí um migrador robusto. Basta executar o comando de atualização da CLI para obter a nova versão, depois navegar até a raiz do seu projeto e executar:

aipim migrate

Isso inteligentemente faz o parse de todos os seus arquivos backlog/*.md e completed/*.md antigos e os sintetiza no novo formato events.jsonl.

O Novo Fluxo de Trabalho

1. Defina a Identidade da Sua Equipe: Execute aipim team add para configurar seu config.toml. Todo evento agora é atribuído a um ator (resolvido automaticamente via Git ou variáveis de ambiente). É ótimo saber quem (humano ou IA) concluiu uma tarefa.
2. Inicie o Servidor MCP: No seu terminal, execute:

   aipim mcp start

   Essa sequência de inicialização gerencia automaticamente a reconstrução do SQLite e expõe a interface MCP na porta 3141.
3. Conecte Seu Agente: Aponte seu cliente compatível com MCP (como o Claude Code) para o servidor.
4. Inicie a UI: Abra uma nova aba no terminal e digite:

   aipim ui

   Mantenha isso aberto em um segundo monitor. Observe seus agentes de IA pegarem tarefas, movê-las pelo quadro Kanban e registrarem decisões arquiteturais em tempo real.

A Verdadeira Mentalidade de "Dev Júnior" Realizada

Na v1.3.0, você estava gerenciando a IA. Na v2.0.0, a IA gerencia a si mesma através de restrições do MCP, enquanto você supervisiona o processo através da UI. Agora, você pode parar de atualizar manualmente os status das tarefas. Peça ao seu assistente de IA para avaliar a ferramenta get_next_task, escrever o código e usar a ferramenta complete_task. Seu trabalho muda completamente de copiar e colar contexto para revisar PRs e monitorar o quadro Kanban em Svelte.

A Próxima Era do AIPIM

O AIPIM v2.0.0 não é apenas uma atualização: é uma mudança de paradigma. Ao abraçar o Event Sourcing e o Model Context Protocol, removi o atrito entre a intenção da IA e o estado do projeto. Então... mal posso esperar para ver o quão rápido você e seus agentes de IA construirão com o novo AIPIM.

Atualize hoje, execute aipim migrate ou experimente com npm install -g aipim && aipim install, e dê um passo em direção ao futuro do desenvolvimento de software autônomo.