Um motor monorepo que transforma objetivos em execuções verificadas, ensináveis e publicáveis.
O Alembic é um monorepo TypeScript projetado para executar um loop autônomo de engenharia de software. Você dá um objetivo (um GOAL.md ou um prompt), ele planeja, executa, verifica e publica um curso visual-teach do que foi feito.
O motor é construído em camadas:
Pense assim… um laboratório de pesquisa onde cada experimento é logado, revisado por pares e transformado em um capítulo de livro automaticamente.
Cada pacote no repositório tem uma única responsabilidade e depende apenas de pacotes abaixo dele. @alembic/contracts é a folha; @alembic/adapters implementa a cintura estreita; @alembic/etl lida com trabalho determinístico barato; @alembic/swarm orquestra tarefas; @alembic/mission compila missões; @alembic/vm executa alembic.plan.ts; @alembic/forge materializa escopos; @alembic/coda fecha gates; @alembic/harness amarra tudo; e apps/cli é a interface humana.
# veja toda a superfície de comandos alembic help # execute o doctor para verificar seu ambiente alembic doctor # gere um plano a partir de um prompt alembic plan "Build a tiny HTTP service" # execute um escopo Forge alembic forge "Build a tiny HTTP service"
A CLI é implementada em apps/cli. Ela parseia argumentos com util.parseArgs do Node e valida com schemas Zod de @alembic/contracts. Cada comando é uma função pura sobre args validados e writer/logger injetados, então a CLI é testável sem spawnar subprocessos.
Execute alembic doctor e leia o resumo. Depois execute alembic help e note quais comandos você já entende.