Alembic Complete Visual Course

Lab: Construir uma feature ponta a ponta

Use Forge, VM, Swarm, gates Coda e publique um curso para uma feature real.

Read the plain version, or open the technical layer on any section.

Um exercício de ciclo completo

Este lab conecta todas as camadas de execução. Escolha uma feature real e delimitada — por exemplo "adicione um endpoint /health à API" ou "crie um subcomando CLI que lista runs". Você irá:

Executar alembic doctor para verificar o ambiente.
Executar alembic forge "<feature>" --offline para gerar GOAL.md, validation-contract.md e alembic.plan.ts.
Inspecionar os artefatos de escopo e editar o plano se necessário.
Executar alembic run --goal GOAL.md --plan alembic.plan.ts --yes --offline.
Assistir a execução via alembic tui ou cockpit web.
Quando a execução terminar, verifique os quatro gates: proof, validator, course, publish.
Inspecione o curso gerado no diretório de run.

Pense assim… cozinhar uma refeição desde escrever a receita, fazer compras, cozinhar, provar, fotografar e postar o resultado.

Under the hood

O exercício o obriga a tocar @alembic/forge (geração de escopo), @alembic/vm (execução de plano), @alembic/swarm (drenagem de tarefas), @alembic/coda (gates), @alembic/loop-engineering (geração de curso) e apps/cli (a interface humana). O modo offline o mantém determinístico e gratuito; use --online apenas depois de confiar no fluxo.

In one picture

O lab de feature percorre todo o pipeline de execução e termina com um curso publicado.

In the code

# 1. verificar
alembic doctor

# 2. planejar + forjar
alembic forge "Add a /health endpoint" --offline

# 3. executar com gates
alembic run --goal GOAL.md --plan alembic.plan.ts --yes --offline

# 4. observar
alembic tui <run-id>

Implementation notes

A CLI valida os caminhos de goal e plano, carrega o escopo, chama runPlan, drena o swarm, executa gates coda e invoca o gerador de curso do loop-engineering. Se o proof gate falhar, o diretório de run contém proof-results.jsonl com exit codes e stdout/stderr para depuração.

Try it

Execute o lab de feature agora. Se falhar em um gate, leia o arquivo de falha e reexecute com --resume se suportado, ou inicie um novo escopo Forge após corrigir o plano.

Debug: Qual gate detectaria um teste falhando no comando de proof?

Quick check

Qual comando inicia o pipeline de execução completo neste lab?

alembic forge alembic doctor alembic run --goal GOAL.md --plan alembic.plan.ts alembic docs