teqo/.agents/skills/work-issue/execution-pipeline.md

3.2 KiB

Pipeline de execução compartilhada (work-issue / agent-work-issue)

Mecânica comum de execução → fechamento das duas skills do fluxo (humano e workers do pool). O corpo mora aqui; cada skill declara os deltas do seu ator e referencia este material — nenhuma é "base" da outra.

Executar

Ordem:

  1. Schema/server — migrations (payload-migrations), utilities, actions, testes de domínio. Invariantes do engineering-brief.
  2. UI — se Impeccable B/C/D: shape → craft → critique → polish. Tokens data-theme='campaign'; shells existentes.
  3. Gates — pnpm gate:fast na iteração; entrega com pnpm push (não git push nu).

Tracer bullet cedo se o item for grande. Inclua o *-impl.md no commit da entrega.

/simplify + débitos

  1. Rode o comando /simplify completo (3 reviewers paralelos via Task, read-only) no diff da sessão.
  2. Aplique fixes pontuais que preservem comportamento.
  3. Rode capture-review-debts no modo do ator (ver deltas). Nunca edite a Issue in-progress atual para absorver débitos.

Fechar em main

  1. Branch do ator (ver deltas) — nunca crie branch nova fora dela.
  2. Changelog da entrega (OPS44): escreva docs/changelog/<data>-<id>.md (ex. 2026-08-13-ops44.md) — uma entrada curta no formato do agregado — e rode pnpm changelog:build para regenerar docs/CHANGELOG-AGENTS.md (insert-only: entradas históricas nunca mudam; o diff será só a entrada nova + o agregado). Rode pnpm changelog:check para confirmar.
  3. pnpm push -u origin HEAD — origin é o GitHub (OPS71; o tracker de Issues continua no Forgejo por API).
  4. PR no GitHub via GITHUB_TOKEN=<PAT> node scripts/github-pr.mjs --head <branch> --title "<id> — <título>" --body-file <arquivo> — Ready (nunca draft; o script não tem flag draft), base main, body com Closes #<N> (ou Related #N em plans-only). Em Cursor Cloud: ManagePullRequest com draft: false.
  5. O safety net agent-pr-ready-automerge.yml arma o auto-merge nativo do GitHub (enablePullRequestAutoMerge, rebase) — o servidor mergea quando o required check CI (PR) / checks fica verde; nada a armar.
  6. No merge, o workflow issue-done-on-main-merge.yml flipa done/in-prod no Forgejo (lê o body do PR via API do GitHub, escreve no tracker por FORGEJO_API_TOKEN). Comente na Issue o desfecho em uma linha.

Deltas por ator

Ator Branch UI capture-review-debts Cloud
Humano (work-issue) <Code>-<slug> (worktree; nunca crie branch nova na sessão) shape → craft → critique → polish autônomo — decide o destino dos achados (registrar/absorver/deferir/descartar) pela triage da skill; sem pausa para o humano n/a (máquina do humano)
Pool (agent-work-issue) agent/<id>-<slug> (worktrees Cursor podem já ter criado) shape → craft → critique → polish (harden/optimize só sob gatilho) autônomo — só expensive_lock com score ≥4 (Issues novas com depends); score ≤3 / cheap_polish / defer_trigger → defer no *-impl.md ou descarte ManagePullRequest com draft: false; Prep Cloud no Passo 0