Passo 13 · Guia & casos de uso · O monólito · Loop Engineering ENPT
Módulo 6 · Guia & casos de uso · Tudo em uma skill

O monólito: cada módulo, internalizado

Uma skill agora carrega o harness inteiro — o loop mais oito módulos embutidos — então instalá-la e distribuí-la significa entregar tudo de uma vez. O que antes era uma gaveta de skills separadas que você encontrava e instalava uma a uma agora é uma única coisa autossuficiente: você instala loop-engineering, e o resto viaja dentro dela.

Leia a versão simples ou abra a camada técnica em qualquer seção.
1

Uma skill, tudo por dentro


Mais cedo neste curso você conheceu as partes do harness uma de cada vez — o loop, o Forge, o fusion, o Council, as ferramentas, o visual-teach. É fácil imaginá-las como uma gaveta de skills separadas: você abre a gaveta, encontra a que precisa, a instala e mantém as demais em seus compartimentos. Isso já foi verdade. Não é mais — e esta é a única mudança recente mais importante.

Hoje existe exatamente uma skill: loop-engineering. Todo o resto vive dentro dela. Cada capacidade que um dia foi sua própria skill agora é um módulo embutido dentro do loop-engineering. Você instala uma coisa; ela carrega o resto. Quando o harness é distribuído a um agente de IA, o agente registra uma única skill — e o loop, o Forge, o fusion, o Council, o visual-teach, o ultragoal, a ferramenta web, a ferramenta de desktop e o brief legível por máquina viajam todos junto com ela, automaticamente.

É isso que "monólito" significa aqui: não grande e emaranhado, mas autossuficiente e inteiro. A única skill carrega seu próprio método (o loop e os portões), seu próprio ensino (este mesmo motor de curso) e sua própria instalação (um script que a instala e distribui). Ela não depende de nenhuma outra skill. Nada do que precisa vive em outro lugar.

Pense nisso como… a diferença entre uma gaveta de ferramentas soltas e uma única canivete multiuso. Com a gaveta, cada tarefa significa caçar a chave certa, e qualquer uma delas pode sumir ou ficar desatualizada. A multiuso tem o alicate, a lâmina, a chave de fenda, a lixa — todas dobradas em um único corpo que você guarda em um bolso. Você carrega um objeto; cada ferramenta já está com você. O harness é essa multiuso: uma skill, oito ferramentas dobradas dentro.

Por que os módulos se chamam MODULE.md, não SKILL.md

O carregador de skills de um agente varre por manifestos de skill e registra cada um como uma skill de nível superior, invocável separadamente. Se cada capacidade embutida ainda carregasse um SKILL.md, o carregador registraria oito skills extras — exatamente a situação de gaveta-de-ferramentas-soltas que estamos deixando para trás. As entradas embutidas são, portanto, nomeadas MODULE.md de propósito: o carregador não as registra como skills próprias, então ele vê precisamente uma skill — loop-engineering — e os módulos viajam junto dentro dela.

Autossuficiente por design

O SKILL.md afirma sem rodeios: "Esta skill é autossuficiente: ela carrega o método, o ensino e a instalação." Ela "não depende de nenhuma outra skill". O método é o loop e seus portões; o ensino é o motor embutido visual-teach; a instalação é o setup.sh. Instale apenas o loop-engineering e todo o resto vem com ele — não há uma segunda skill para manter em sincronia.

2

Em uma imagem


Aqui está a forma inteira em uma só tela. A única skill é o contêiner grande; os oito módulos embutidos ficam dentro dela. Um script — setup.sh — distribui esse único contêiner, por symlink, para o diretório de skills de cada agente de uma vez. Instale uma vez; ele chega a todo lugar, com módulos e tudo.

loop-engineering — uma skill autossuficiente o loop + portões · carrega método + ensino + instalação · não depende de outra skill forge front-end de 7 passos fusion do painel ao juiz council conselho multi-modelo visual-teach motor de curso ultragoal objetivo verificável brightdata-cli a ferramenta web computer-use-cli UI do macOS harness-brief curso de máquina oito MODULE.md embutidos (não SKILL.md) — o carregador registra UMA skill, o resto viaja junto setup.sh — distribuir (symlink) Claude Code Codex Kimi Grok Cursor ~12 agentes
Uma skill autossuficiente contendo oito módulos; o setup.sh faz symlink do contêiner inteiro em ~12 diretórios de agentes — os módulos embutidos viajam junto.
3

Os oito módulos


Aqui estão os oito módulos dobrados na única skill. Clique em qualquer chip para abrir o detalhe — para que serve, o que faz, onde fica seu arquivo e como o harness o alcança. (Esta é uma demonstração ao vivo: o primeiro módulo está aberto por padrão; clicar em outro troca o painel.)

explorador de módulos · clique em um chip

forge

papel · o front-end da ideia-bruta → escopo-mensurável

O caminho de entrada quando o pedido é um vago "eu quero…" em vez de uma especificação. Ele roda sete passos — grill → research → prototype → PRD → issues + /goal → implement → review — transformando uma ideia difusa em uma linha de chegada contra a qual o loop pode testar. É o módulo mais internalizado: nativo desde o início, nunca uma skill separada; seus submétodos (grill, research, prototype e o resto) vivem nas palavras do próprio harness dentro de forge/.

faz
afia uma ideia bruta em um escopo mensurável ao longo de 7 passos AFK (o humano apenas observa)
arquivo
forge-flow.md + forge/
alcançado
automaticamente quando o prompt é uma ideia bruta; grill / research / prototype alcançáveis em QUALQUER passagem

fusion

papel · do painel ao juiz para bifurcações difíceis ou de alto risco

Distribui um prompt a N modelos em paralelo, cada um cego aos demais; então o Opus 4.8 julga as respostas em consenso, contradições e pontos cegos, mais um final fundamentado. Para código, ele faz roda-os-dois-e-mescla — roda ambos os candidatos e mescla o resultado verificado. Use-o numa bifurcação de decisão genuinamente difícil, ou como Validador de alta confiança no Proof Gate em vez de uma única checagem.

faz
painel multi-modelo cego, então um final julgado e fundamentado; roda-os-dois-e-mescla para código
arquivo
fusion/MODULE.md (+ fusion/scripts/run_*.sh)
alcançado
qualquer comando /fusion-*, ou a partir da etapa ANALYZE / VERIFY do loop

council

papel · o conselho multi-modelo de peso

O conselho configurado para decisões de nível doutrina — os membros votam → pontuam → sintetizam → veredito. É o irmão mais pesado do fusion: onde o fusion é um painel cego e rápido, o Council é um conselho definido de membros com papéis e pesos, usado para as maiores decisões ou como Validador de consenso.

faz
roda um conselho de membros por votação, pontuação, síntese, veredito
arquivo
council/ (engine + config); método em forge/council/METHOD.md
alcançado
o engine do council (carrega os caminhos ao vivo — rode-o lá); esta cópia embutida é a referência

visual-teach

papel · o motor do curso (o Course Gate)

O motor que construiu este mesmo curso. Ele produz HTML interativo autossuficiente — um shell compartilhado byte-idêntico em todas as lições, modo escuro embutido, 20 tipos de demo, um alternador Simples↔Técnico em cada seção — tanto em EN quanto em PT-BR (prosa traduzida; código e comandos mantidos ao pé da letra). É o que dispara na convergência para ensinar o resultado.

faz
constrói cursos HTML interativos e autossuficientes, EN + PT-BR, modo escuro, 20 tipos de demo
arquivo
visual-teach/MODULE.md
alcançado
o loop o chama de mão única como sua etapa de ensino quando o trabalho converge

ultragoal

papel · a disciplina de objetivo durável e verificável

A disciplina por trás de um objetivo que se sustenta por uma execução longa: uma linha de chegada observável, um verificador que pode falhar no boundary real, anti-trapaça, portões de aprovação e uma passagem de red-team antes de o objetivo ser ativado. Ele compila o GOAL.md — o contrato contra o qual o loop testa — e a etapa /goal do Forge o aplica inline.

faz
desenhar → criticar → red-team → ativar um objetivo durável; compila o GOAL.md
arquivo
ultragoal/MODULE.md
alcançado
forge/forge-goal o aplica inline na etapa /goal

brightdata-cli

papel · a ferramenta web

Como o harness alcança a web ao vivo: search / scrape / browser / pipelines, com mais de 40 datasets estruturados por trás dos pipelines. A regra é absoluta — quando o harness precisa de evidência web real e atual, ele usa esta, sempre; nunca WebSearch, WebFetch ou um MCP.

faz
brightdata search / scrape / browser / pipelines (mais de 40 datasets)
arquivo
brightdata-cli/MODULE.md
alcançado
qualquer passagem que precise de evidência web — o único caminho web autorizado

computer-use-cli

papel · automação nativa de UI do macOS

Como o harness conduz um app de desktop quando uma tarefa vive na UI nativa do macOS. Ele funciona pela árvore de acessibilidade — clicar, digitar, arrastar, mover o cursor — e prova suas ações relendo o estado do app. Recorra a ele quando o trabalho não puder ser feito pela web ou por uma CLI.

faz
conduz apps nativos do macOS pela árvore de acessibilidade (clicar / digitar / arrastar / cursor)
arquivo
computer-use-cli/MODULE.md
alcançado
uma tarefa que vive em um programa de desktop; cu list-apps | state | click | type

harness-brief

papel · o gêmeo legível por máquina deste curso

Um brief denso, somente em inglês, de cima a baixo, do harness inteiro para uma LLM ou agente ler e obter contexto completo rápido — delegação, fusion, Council, as ferramentas, os portões de publicação. É a contraparte de máquina deste curso humano: mesmo harness, dois públicos, dois artefatos.

faz
dá a um agente contexto completo do harness em uma leitura (conciso, em inglês, de cima a baixo)
arquivo
harness-brief/MODULE.md (+ 6 lições)
alcançado
um agente/LLM o lê diretamente para se orientar; humanos leem este curso em vez disso
4

Por que um monólito


Dobrar tudo em uma skill não é arrumação por arrumação — isso remove uma classe inteira de problemas que uma gaveta de skills separadas cria. As razões são claras:

Você instala uma coisa. A única skill é autossuficiente — ela carrega o método, o ensino e o setup.sh que a instala, então não há mais nada para buscar. Há uma única fonte de verdade: nenhuma cópia por skill saindo de sincronia, nenhum descompasso de versão entre uma skill e a ferramenta da qual ela depende. Não há dependências entre skills para quebrar — o monólito não depende de nenhuma outra skill. E porque viaja como uma unidade única, ele chega intacto a cada agente: o mesmo conjunto de capacidades está em todo lugar, então uma unidade que roda no Claude Code pode rodar identicamente no Codex, Kimi ou Grok. Dois módulos merecem uma nota especial: o Forge é nativo — foi internalizado desde o início, nunca uma skill separada — e o harness-brief é o gêmeo legível por máquina do mesmo curso que você está lendo.

instale UMA coisa autossuficiente (método + ensino + instalação) uma única fonte de verdade sem dependências entre skills viaja intacto a cada agente Forge nativo · harness-brief = o gêmeo

O renome para MODULE.md é estrutural

Se as entradas embutidas mantivessem os nomes SKILL.md, o carregador do agente registraria oito skills extras de nível superior — recriando a gaveta de ferramentas soltas que o monólito existe para remover. Nomeá-las MODULE.md é exatamente o que impede o carregador de registrá-las como skills próprias, então ele vê uma skill: loop-engineering.

Um symlink, os módulos viajam junto

O setup.sh faz symlink da única skill monólito em cerca de doze diretórios de agentes a partir do canônico ~/.claude/skills/. Como os módulos ficam aninhados dentro do diretório da skill, o symlink os carrega automaticamente — distribuir a skill é distribuir cada módulo. O script é idempotente (só faz symlinks e leituras), então re-executá-lo após adicionar um agente ou editar um módulo é seguro.

5

O que levar consigo


O harness já foi um conjunto de skills separadas. Agora é um monólito autossuficienteloop-engineering — com tudo embutido dentro dele. Você instala uma coisa; ela carrega o método, o ensino, a instalação e oito módulos, e se distribui como uma unidade única a cada agente de uma vez.

A regra única

Uma skill, oito módulos embutidos (forge · fusion · council · visual-teach · ultragoal · brightdata-cli · computer-use-cli · harness-brief), distribuídos como uma unidade. Instale loop-engineering e o harness inteiro viaja com ele.

Seu agente é seu professor. Quer ver qual módulo uma dada tarefa realmente toca, ou como o setup.sh coloca todos os oito na sua máquina? Pergunte. A seguir — o guia, e cada caso de uso mapeado a seus módulos e comandos: O guia, e cada caso de uso mapeado.