Materialize um escopo executável a partir de uma ideia vaga usando o Forge front-end de 7 passos.
@alembic/forge implementa o Forge front-end de 7 passos: grill, research, prototype, PRD, issues, goal, review. Cada passo escreve um artefato no diretório de escopo, culminando em GOAL.md, validation-contract.md e alembic.plan.ts.
@alembic/planf3 transforma um prompt em um plano HTML. Pode usar um LLM ou cair em um template determinístico. Forge pode consumir um artefato planf3 como ponto de partida.
Pense assim… a fase de esboço de um arquiteto: entrevistar o cliente, pesquisar precedentes, construir uma maquete, escrever especificações, listar permissões, finalizar o contrato e revisar antes de começar a obra.
runForgeFrontEnd pega um prompt, diretório de escopo e flag offline/online. Em modo online, roteia prompts por um adapter T2; em modo offline, usa templates determinísticos. loadScope cria o diretório de run durável com um runId content-addressed derivado de goal + contract + plan.
# gere um plano alembic plan "Add OAuth to the API" # execute o Forge front-end completo alembic forge "Add OAuth to the API" --offline
runForgeFrontEnd delega cada passo a uma função em src/front-end/steps.ts. O registro de passos padrão é exportado como DEFAULT_FORGE_STEPS, então usuários avançados podem injetar passos customizados. Cada passo recebe o diretório de escopo e escreve exatamente um artefato.
Execute alembic forge "Build a CLI command that lists files" --offline e inspecione cada arquivo escrito no diretório de escopo.
alembic run --goal ... --plan ...?