FORGE // OPERATOR MANUAL 01

Da ideia ao app no ar.
Sem perder o controle.

O Forge orquestra agentes, artefatos, testes e deploy. Você entra apenas onde gosto, risco ou dinheiro tornam a decisão humana.

pipeline/doki-call PAUSED_GATE

$ forge status

job
L0/P0
player
grok-solo
verify
PASS
gate
p0-go

Mercado provado. Avançar para build?

03gates humanos
Npipelines paralelas
0quota no dry-run
02caminhos de ship

01 / MAPA

A fábrica é um loop, não uma sequência de prompts

Cada etapa tem entrada, dono, artefato e verificação. O modelo é só o motor daquela volta.

Agente executa Humano decide Evidência fica no repo
    Depois do ship, o loop continua.

    Feedback volta por ITERATE. P4 mede comportamento real. P5 mata o que não paga ou escala o que provou sinal.

    02 / START

    Primeiros 15 minutos

    Aprenda com uma pipeline completa usando o executor fake. Mesmos artefatos, mesmos gates, zero quota.

    1. 01

      Instale o workspace

      Use Node 20 ou superior. Rode apenas quando dependências estiverem ausentes.

      npm install
    2. 02

      Abra o Maestro

      O helper sobe o server e abre a interface local. Se a página mostrar só “Running”, você acertou o Docker, não o Maestro.

      npm run maestro:open
    3. 03

      Defina a fábrica

      Nicho, stack, contexto e idiomas viram instruções persistentes para todos os jobs.

      npm run forge -- profile init
    4. 04

      Monte o time

      Escolha provedor, modelo, esforço e função sem editar o roster à mão.

      npm run forge -- team
    5. 06

      Veja o estado

      Confirme job, player, gate e histórico de cada pipeline.

      npm run forge -- status
    6. 07

      Decida com evidência

      Leia o scorecard e só então responda ao gate.

      npm run forge -- decide p0-go go --app meu-app

    03 / GATES

    O Forge sabe trabalhar. Você sabe quando parar.

    Simule uma decisão. Nada aqui executa comandos; o laboratório mostra o efeito antes de você agir no terminal.

    Simule uma decisão humana
    Escolha uma decisão para ver efeito e comando.
    p0-goDinheiro

    Quem compra, por qual canal, por quanto e com qual recorrência?

    b3-visualGosto

    Escolha visual não se terceiriza para uma média estatística.

    deployIrreversível

    Publicar muda estado externo. A autorização é sua.

    04 / TIMES

    Escolha o menor time que entrega confiança

    Mais agentes não são automaticamente mais qualidade. Use especialização quando o job pede.

    Time próprio

    Monte por função, não por torcida.

    O wizard combina provedor, modelo, esforço e papéis. Fallbacks entram quando o player primário fica inelegível.

    npm run forge -- team

    05 / COMANDOS

    Mapa de comandos por intenção

    Você não precisa decorar a CLI. Comece pelo que quer fazer.

    06 / OPERATOR

    Modo operador: confiança vem do estado

    O Forge aguenta paralelismo, falha e restart porque o run vive em arquivos, não na memória de uma conversa.

    N PIPELINES

    Cada app tem estado e git próprios

    Os engines compartilham apenas o que precisa ser global, como cooldown de provider. O working tree de um app não disputa com o outro.

    anima-deckP4 · measure doki-calldeploy · gate nova-ideiaL1/B3 · running

    FAIL ≤ 3

    Retry não é loop infinito

    Verify objetivo, até três correções, rollback via git e L2 quando quota ou provedor bloqueiam.

    COOLDOWN

    Rate-limit atravessa pipelines

    Um provider saturado fica inelegível globalmente. O estado sobrevive a restart e o fallback assume.

    FORGE STATS

    Leia o que falhou

    player/jobPASS glm · B34/4 grok · P11/16
    npm run forge -- stats

    Ship matrix

    O target segue a capacidade do app

    Free pathTargetProva final
    Static / quizcf-pages · gh-pagesHTTP + assets
    API / chatvercel · cf-workersHealth + fluxo real

    07 / RECOVERY

    Algo parou. Qual comando usar?

    Comece pelo sintoma. O objetivo é preservar trabalho e reduzir blast radius.

    01
    Existe job vivo?

    Sim: pause antes de mexer no server.

    forge stop meu-app
    02A

    Código do Maestro mudou

    Recarregue. O restart recusa job vivo por padrão.

    forge restart
    02B

    Pipeline está parada

    Se não há gate pendente, continue do estado persistido.

    forge resume meu-app
    02C

    Provider saturou

    Não reinicie produto. Aguarde cooldown ou deixe fallback assumir.

    forge status
    03
    Run sem saída segura?

    kill encerra o run. Não apaga o app.

    forge kill meu-app

    08 / SHIP

    Build verde é o começo da prova

    Marque o que já foi verificado. O progresso fica apenas neste navegador.

    Prontidão de ship0 / 8

    VOCÊ AGORA OPERA O LOOP COMPLETO

    Comece seco. Prove sinal. Escale com evidência.

    Rodar o primeiro dry-run