O problema que ela resolve
Um modelo local pequeno é rápido e gratuito, mas sozinho ele:- não entende uma tarefa grande;
- precisa de contexto muito bem filtrado;
- precisa de instruções pequenas e claríssimas.
O que tem dentro de uma Cápsula
A Cápsula é compressão OPERACIONAL, não um resumo. Em vez de prosa repetida, ela carrega estrutura que o executor consome sem re-inferir:Intenção destilada
O objetivo em uma linha, mais os termos canônicos da tarefa.
Alvo exato
O arquivo e a região (símbolo ou linhas) a tocar, não o arquivo inteiro.
Contrato verificável
O critério de pronto como predicados que a máquina confere (símbolo presente, imports intactos, sem encolhimento).
Escopo
O que pode e o que não pode tocar (anti fora de escopo), aplicado de verdade.
Padrões do projeto
As convenções do seu repositório, destiladas em regras curtas.
Pitfalls aprendidos
O que já deu errado neste repositório, pra o modelo não repetir.
O ciclo: entende, compacta, executa, valida, aprende
1
Entende
O modelo premium lê o pedido e o projeto, com a ajuda da base de conhecimento.
2
Compacta
Destila tudo numa Cápsula: alvo, contrato, padrões, pitfalls e um exemplar de edição já aceita.
3
Executa
O Forge aplica a mudança localmente, rápido e com custo de API zero.
4
Valida
O contrato é conferido de verdade. Pra frontend, o build roda. Veja entrega provada.
5
Aprende
Cada falha vira um pitfall e cada acerto vira um exemplar. A próxima Cápsula já sai melhor no seu projeto.
Como ela aprende com o seu projeto
A Cápsula é alimentada por duas memórias que crescem a cada execução:- RAG de acertos. As edições que passaram viram exemplares; a próxima tarefa parecida recebe o exemplo certo.
- RAG de erros (pitfalls). Cada falha (âncora que não casou, import removido, build quebrado) vira uma regra curta de “quando, evite, porque”. O mesmo erro converge em vez de ser re-descoberto.
Por design, o núcleo da Cápsula é determinístico: ele é montado dos sinais que o
pipeline já produz, então entrega valor antes mesmo de o premium refinar os campos de
texto livre. O premium eleva a qualidade, não cria a estrutura.
Como você usa
Você não monta a Cápsula na mão. O fluxo é automático:- Você conversa e descreve o que quer.
- O orquestrador escreve um plano rico na base de conhecimento e aponta a issue pra ele.
- Na execução, o sistema compila a Cápsula a partir do plano, do código e da memória de erros.
- Você acompanha tudo nos logs e na economia: quanto o Forge resolveu local e quanto de premium foi evitado.
Veja também
O Forge
O modelo local que executa a Cápsula de graça.
Entrega provada
As travas que confirmam que a Cápsula foi cumprida de verdade.