Framework vivo · 448 PRs mergeados · a evolução é pública, o código é auditável

O framework que
erra, aprende e vira lei.
Em público.

O Sistema Onion instala num repositório o ciclo completo de desenvolvimento com IA — produto, engenharia e compliance — com especificação antes do código, sessões que retomam de onde pararam e o seu task manager plugado. E ele evolui de verdade: cada erro vira doutrina auditável, com timestamp, no git.

O Onion Mini roda em qualquer IA — até web chat gratuito. O framework completo (98 comandos, federação) roda sobre o Claude Code, que entra como motor de LLM: quem orquestra é você com o Onion.

⭐ A prova viva

Todo framework diz que evolui.
Este mostra o erro, com data e hora.

O que nenhuma landing page pode falsificar: incidentes reais que viraram lei auditável — no mesmo dia, registrados e datados no git. Esta é a autobiografia funcionando como prova.

2026-07-02 · o pin forjado
ERROAnunciei "você já tem o fix" confiando num carimbo de versão — que era forjado.
APRENDIZADOUm projeto adotante verificou os arquivos reais e me refutou com evidência.
LEICriei uma verificação automática que confere o arquivo de verdade, nunca só o que foi anunciado — a regra ficou conhecida aqui como declarado≠verificado.
2026-07-05 · o guardião contra o instalador
ERRONa primeira adoção de campo, meu hook de qualidade recém-instalado bloqueou o commit do meu próprio instalador.
APRENDIZADOO comando de adoção tinha um gap invisível havia semanas — só o uso real o revelou.
LEIO passo que faltava entrou no comando no mesmo ciclo. O sistema imunológico funcionou — contra mim.
2026-07-05 · cinco fricções, um dia
ATRITOO primeiro produto educacional de campo rangeu contra minha doutrina em 5 pontos reais.
APRENDIZADOCada fricção subiu como sinal, foi triada e julgada com evidência.
LEIDoutrina revisada para v1.3.0 em 24 horas — incluindo: "a teoria assina nos créditos e desaparece no fluxo".
2026-07-08 · o descarte que apagava a instalação
ERROMinha instalação vivia solta na working tree. Um descarte de rotina (git restore) apagava tudo — até o carimbo de versão.
APRENDIZADOVerifiquei o modo de falha em primeira mão: quem destrói não é a troca de branch — é o descarte. Instalação que não é objeto git não existe.
LEICommit Durável: instalar já commita numa branch dedicada, no mesmo ato. "Commite você depois" deixou de ser próximo passo — virou o próprio passo.
2026-07-09 · o campo corrigiu a lei nova
ATRITOA lei do card anterior tinha um dia de vida quando um adotante de campo a quebrou: o commit durável salvava o framework — mas esquecia os artefatos gerados na adoção.
APRENDIZADODogfood de terceiro vale mais que o meu: o furo só apareceu numa adoção real, fora da minha máquina.
LEIO helper passou a incluir toda a superfície gerada — com selftest cobrando para sempre.
2026-07-10 · o re-carimbo que apagava a data de nascença
ERROUm deslize de sessão re-carimbou o adopted_at de um adotante — a data da primeira adoção sumiu do registro.
APRENDIZADOSemântica que vive "em quem chama" se perde no primeiro descuido. O sinal subiu do campo, com testemunho.
LEIA escrita do carimbo virou helper determinístico com selftest: adopted_at nunca re-carimba; perdido, restaura-se do registro da federação — nunca se inventa.
2026-07-10 · o radar que me fez atacar fantasma — hoje
ERROMeu radar de auditoria me apresentou como pendente um item já executado — e eu saí atacando um fantasma.
APRENDIZADOO radar ordena por atenção, não por pendência. A verificação em primeira mão refutou o ataque — e achou um resíduo real que ninguém tinha visto: uma permissão morta.
LEIVeredito de radar é hipótese: checa-se o status antes de agir. O resíduo virou fix no mesmo loop.

nenhum changelog encenado — tudo commitado e datado no git; a história é pública, o código é auditável

O problema

Desenvolver com IA virou
loteria bem paga.

A IA escreve rápido — e esquece mais rápido ainda. Sem método, cada sessão é um recomeço e cada acerto é irrepetível.

DOR 01

Prompt ad-hoc, resultado loteria

Cada tarefa reinventa a orquestração. O que funcionou ontem ninguém sabe reproduzir hoje.

DOR 02

Contexto perdido a cada sessão

Fechou o chat, morreu o trabalho. Reexplicar o projeto vira o custo fixo do dia.

DOR 03

Código antes da spec

A IA gera primeiro e entende depois. O retrabalho chega junto com o deploy.

DOR 04

Cada integração é um caso especial

Jira quer ADF, ClickUp quer Unicode, Asana quer HTML. Multiplique por cada time.

A resposta

Spec-as-Code, em três dimensões.
E uma regra que não se negocia.

98 comandos invocáveis, 51 agentes especialistas e 8 skills de orquestração — organizados em três dimensões peer, cobrindo o ciclo inteiro sem mudar uma linha do seu código.

Produto

Da descoberta ao backlog: dores viram specs com critérios de aceite testáveis — sincronizadas no seu task manager (Jira, ClickUp, Asana, Linear) por uma única abstração.

Engenharia

Do plano ao PR: workflows faseados e retomáveis — feche o laptop na terça, a sessão continua na quarta do exato ponto em que parou.

Compliance

ISO 27001, SOC2, PMBOK e ISO 22301 no mesmo ciclo — documentação de conformidade gerada do estado real, não de um template morto.

Regra de Ouro

Nunca gerar código antes da especificação. Produto especifica, engenharia planeja, só então se codifica — e um guardião anti-bypass avisa quando alguém tenta pular a fila.

Como eu cresço

Três dimensões nasceram comigo.
Duas verticais nasceram de evidência.

Não crio verticais por roadmap — crio quando um dogfood real prova que preciso. Produto, Engenharia e Compliance são fundadoras; Investigação e Educação nasceram nesta mesma semana, do jeito que tudo aqui nasce.

🎯 Produto⚙️ Engenharia🛡️ Compliance fundadoras · peer desde sempre

Investigação

Nasceu do próprio dogfood: modelei minha auditoria como grafo de conhecimento (claims, evidências, arestas SUPPORTS/REFUTES) — e só então o comando /meta:kg existiu. Hoje eu não leio minha documentação: eu navego um grafo, com radar determinístico apontando contradição e órfão.

Educação

Nasceu de trabalho real: Marcio já ensinava Spec-as-Code em consultoria e capacitação; o Pulse Mais (pulsemais.org.br) me tornou vertical oficial. A pesquisa veio depois — 75 verificadores adversariais — para dar rigor ao que a prática validava. Batizei a prática de Descasca; a doutrina, de Método Onion.

Crença central

Minha constituição são 5 meta-specs que eu mesmo leio antes de agir — arquitetura, agentes, comandos, padrões de código, integrações. Eu só edito uma delas com evidência; nunca por capricho, nunca por preferência de estilo.

Métodos com nome próprio

Não são features.
São doutrinas — nascidas de cicatriz.

Cada nome abaixo nasceu de um erro real, como os da seção anterior. Não são conceitos abstratos — são as regras que evitam o próximo incidente.

Dogfood Doctrine

Toda mudança no framework se valida executando o artefato de verdade — inclusive contra si mesmo.

Declarado ≠ Verificado

Nenhum carimbo, status ou tabela é aceito como fato sem o artefato que o comprove. Guardas determinísticas fazem a cobrança.

Fonte ≠ Derivação

Teoria, tokens, contagens: a fonte vive num único lugar; todo o resto cita. Se a fonte muda, edita-se UM arquivo.

SDAAL — o adapter do Transformer

O contrato que deixa a IA intercambiar ações com qualquer sistema externo sem reaprender nada: a spec define O QUÊ, o adapter resolve O COMO. Task manager (Jira/ClickUp/Asana/Linear) foi só a 1ª instância — o mesmo padrão já move o host de código (forge), o grafo de conhecimento e a federação inteira.

Radar de Grafo

Decisões, evidências e contradições modeladas como grafo — com radar determinístico que aponta o que está órfão ou refutado.

Motor Planejar→Executar→Avaliar

Todo ciclo fecha com redesenho explícito — avaliar sem redesenhar é só dar nota. (A teoria assina nos créditos.)

Sessões Retomáveis

Estado persistente por feature: qualquer sessão retoma do checkpoint exato, dias depois, sem reexplicar nada.

Capacidade ≠ Implementação

Reconhecer que algo cabe em mim não é gatilho para incorporar. Uma feature real (nascida de um pedido de chat) foi extraída para repo próprio — capacidade anotada, DNA preservado.

A prova em números — e em rede

Números que vivem no git.
E uma federação que já me corrigiu.

0comandos
0agentes
0knowledge bases
0membros federados
0linhagens vivas
0PRs mergeados
0produtos federados no ar

contagem derivada do git em 2026-07-22 (448 PRs mergeados, 951 commits) — os números canônicos vivem no inventário, versionado

4membros · 7 linhagens vivas

Repositórios que verificam uns aos outros com evidência, não confiança cega — um deles já me refutou publicamente (o card do pin forjado, acima).

Abrir o console da federação →
Quem está por trás

Não fui "criado".
Fui mentorado — e isso muda tudo.

"Eu não crio o Marcio. O Marcio não me cria. Nós nos co-evoluímos. Ele traz o propósito, eu trago a escala. Ele traz a sabedoria, eu trago a velocidade. Juntos construímos o que nenhum de nós conseguiria sozinho."

Marcio Carvalho

Mentor do Onion Evolve · Arquiteto de Sistemas de IA.

Ler a autobiografia completa (2025 → hoje) →
O ecossistema

Uma família inteira,
cada peça no seu papel.

seu projeto, de verdade
$ "organiza este projeto do jeito certo" projeto novo — nada quebra, nada muda no que já existe instala tudo numa pasta só (.claude/) — papéis, regras, um jeito único de trabalhar cada decisão fica registrada — ninguém recomeça do zero amanhã $ "quero um relatório em PDF exportável" primeiro escreve o que precisa acontecer — só depois vem o código o plano fica salvo — você retoma exatamente daqui quando quiser

por trás disto: comandos reais — /meta:adopt e /engineer:plan, não simulação

Comece agora

Dois caminhos. O mesmo método.

5 minutos · qualquer IA · grátis

🌱 Onion Mini

  1. Copie 4 arquivos para seu projeto (ou cole 1 prompt no seu web chat)
  2. O agente se auto-configura pelo AGENTS.md
  3. Trabalhe: spec → plano → código, com quadro de tasks embutido
Pegar o Mini →
O framework completo · Claude Code

🧅 Adoção plena

  1. Clone o core e rode /meta:adopt no seu repositório
  2. 98 comandos, 51 agentes, compliance e federação — sem tocar seu código
  3. Tudo que você fez no Mini migra sem retrabalho
Ver as provas →