teqo-backup/docs/changelog/2026-08-23-ops47.md
Francisco Solla 038758eb81 docs(OPS47): alinha plano do agent-pool à política main-based pós-OPS71
- agent-pool-orchestrator.md: PR --base stage + issue-done-on-stage-merge.yml
  + promote stage→main viram --base main + issue-done-on-main-merge.yml
  + sem promote; migration-lock → countOpenSchemaPrs; model-selection →
  agent-pool-models.mjs; agent-github.mjs → agent-forgejo.mjs; workflow
  marcado removido OPS65 (caminho real .forgejo/workflows/agent-pool.yml)
- agent-pool/SKILL.md: L79 sem 'Antes do promote'; L105 agent-pool-github→forgejo
- comentário/label: agent-pool-state.mjs 'merge in stage'→main;
  agentPoolState.unit.spec.ts label 'on stage merge'→main
- changelog 2026-08-23-ops47.md (Closes #735)
2026-08-23 15:23:52 -03:00

2.3 KiB

OPS47 — agent-pool/SKILL.md aponta para plano com política pré-main obsoleta (--base stage + auto-merge) (2026-08-23): docs-only, zero mudança de comportamento. O .agents/skills/agent-pool/SKILL.md:18 cita docs/plans/agent-pool-orchestrator.md como referência viva de arquitetura ("Arquitetura e elegibilidade"), mas o plano (escrito 2026-07-30, era pré-main) ainda descrevia a política obsoleta: PR --base stage, issue-done-on-stage-merge.yml, promote stage→main, refresh-stage — realidade removida em 2026-08-01 (promote/refresh) e 2026-08-12 (migration-lock). Edição linha-a-linha do plano (dono do concern), frame histórico do pool dormente (OPS65) preservado: overview e resumo executivo passam a "workers PR direto para main" com nota do promote removido; diagrama mermaid pull_request closed em stage→em main e merge em main → issue-done-on-main-merge.yml; contrato de prompt do worker gh pr create --base stage→--base main (reflete o vivo: POOL_BASE_REF='main' em scripts/agent-pool.mjs:70 e prompt --base main em scripts/lib/agent-pool-prompt.mjs:40-41); gargalo de migrations reescrito de "job migration-lock" para countOpenSchemaPrs (scripts/lib/agent-pool-forgejo.mjs:83, com nota da remoção do job em 2026-08-12); referências à skill deletada model-selection → scripts/lib/agent-pool-models.mjs; scripts/lib/agent-github.mjs (inexistente) → agent-forgejo.mjs; .github/workflows/agent-pool.yml e gh workflow run agent-pool.yml marcados como removidos no OPS65 (dispatch falha 404); startingRef: 'stage'→POOL_BASE_REF (='main'); D7/D8/D1 e rabbit holes alinhados (sem refresh-stage, sem "slot ocupado até merge em stage"). SKILL.md: resíduo L79 "Antes do promote, use dispatch na branch" → nota histórica (promote removido 2026-08-01, workflow removido OPS65). Touch-ups de comentário/label (sem mudança de lógica): tests/unit/agentPoolState.unit.spec.ts:103 "CI flipped on stage merge"→"on main merge"; scripts/lib/agent-pool-state.mjs:131 "merge in stage"→"merge in main". Fora de escopo (órfão/histórico): docs/plans/paradigma-agentes-paralelos.md; código do pool e workflows (dormentes, não tocados). Impl plan: docs/plans/agent-pool-skill-md-aponta-para-plano-com-politica-pre-impl.md.