Replace all project-local .cursor/ path references with .agents/ across rules, skills, environment config, hooks, and ignore files. Keep Cursor editor paths (~/.cursor/, window.cursor, CURSOR_API_KEY) and vendored Impeccable editor-hook paths unchanged.
4.9 KiB
Política de agente — CI vermelho é do dono do PR até o merge
Status: entregue (2026-07-30 — executado em sessão única, fora do fluxo agent:register, a pedido do humano) Atualizado em: 2026-07-30 Issue: — Priority: P2 Model: cursor-grok-4.5-high Impeccable: A — N/A (sem superfície UI) Appetite: ~0,5 dia; docs em 3 arquivos Responsável: —
Dados → decisão → apresentação
Dados: N/A — política de fluxo em docs.
Contexto
Incidente (2026-07-30, PR #50): o agente em work-issue desistiu ao ver (a) migration-lock falhando por defeito de infra (job sem checkout) e (b) um teste int falhando fora do escopo nominal da feature (homeSearchLeaderships, confundido com e2e). A feature estava pronta; o PR ficou BLOCKED e ninguém era dono. Lacuna: nem work-issue nem engineering-standards dizem quem conserta CI quebrado "fora da feature".
Decisão de produto (2026-07-30, brief do lote CI): done = PR mergeado em stage com CI verde — corrigir qualquer falha de CI necessária ao merge, mesmo fora da feature.
Objetivos
work-issue,engineering-standards.mdcedocs/AGENT-OPS.mddeclaram a política com o mesmo texto-núcleo (uma fonte, duas citações).- Regra de triagem da falha de CI documentada: infra do workflow / teste pré-existente / regressão da feature — as três são do dono do PR; o que muda é o fix.
- Registro do incidente #50 como precedente em
docs/CHANGELOG-AGENTS.md(uma entrada curta, formato do arquivo).
Decisões travadas
- Dono do PR conserta, sem exceção por escopo. Racional: com agentes paralelos, "não é minha feature" vira deadlock (o #50 ficou parado por isso). O autor já tem branch, contexto e CI loop aberto. Rejeitado: abrir Issue separada e seguir (o PR apodrece BLOCKED — exatamente o incidente); esperar humano (derrota a autonomia do paradigma AGENT-OPS).
- Limite explícito: o fix colateral segue as mesmas regras de blast radius — migration/access/Consent continuam proibidos de "consertar de passagem" sem plano; nesses casos o agente para e escala (Opções documentadas). Rejeitado: carta branca para qualquer fix (contradiz as invariantes de segurança do AGENTS.md).
- Uma fonte de verdade (AGENT-OPS), citações nos outros dois — evita o drift que o pre-push sofreu (OPS6). Rejeitado: repetir o parágrafo inteiro nos três arquivos.
Questões em aberto
- Teste flaky (não determinístico) conta como "sua responsabilidade"? Opções: A) sim, repair ou quarentena com justificativa no PR | B) retry até passar. Recomendação: A — retry cega o CI para flakes reais; quarentena exige comentário + débito registrado via
capture-review-debts.
Abordagem proposta
Componentes (texto, não código):
docs/AGENT-OPS.md— novo bloco na seção "Fluxo": "Dono do PR, dono do CI" (definição de done, triagem das 3 classes de falha, limite de blast radius, flaky→quarentena+débito)..agents/skills/work-issue/SKILL.md— Passo 6.5 reforçado: falha no ci-pr → corrige na mesma branch qualquer que seja a origem, citando AGENT-OPS; "fora do escopo" não é critério de parada..agents/rules/engineering-standards.mdc— linha no "After every change": CI vermelho no seu PR é seu, mesmo pré-existente.docs/CHANGELOG-AGENTS.md— entrada do incidente PR #50 → esta política.
Texto-núcleo proposto (núcleo único citado nos três):
Done = PR mergeado em
stagecom CI verde. Falha de CI no teu PR — infra do workflow, teste pré-existente ou regressão da feature — é tua até o merge. "Fora do escopo da feature" não é motivo para parar: corrige na mesma branch. Exceção de blast radius: se o fix exigir migration, access control ou Consent, para e escala com Opções — esses nunca se corrigem "de passagem". Flaky não se resolve com retry: repair ou quarentena justificada + débito registrado.
Sem migration, sem código de app.
Dependências
Nenhuma dura. Sinérgica com OPS3 (que aplica a política na prática) e OPS6 (mesma família de arquivos — serializar para evitar conflito trivial).
Não escopo
- Mudança de gates/hooks → OPS6. Refatoração de workflows → OPS4/OPS5.
agent:file-missdo incidente: o incidente vira precedente documentado aqui; se o humano quiser também comokind:agent-misspara o harvest OPS2 (#43), registrar lá.
Rabbit holes
- Reescrever work-issue inteira "de passagem". A skill está estável; o delta é uma política. Mitigação: diff limitado ao Passo 6 + citação.
Adiado com gatilho
Nenhum neste item.
Referências
- Incidente: PR #50, run 30558184687 (migration-lock sem checkout; int fora da feature)
docs/AGENT-OPS.md— seção "Fluxo";.agents/skills/work-issue/SKILL.md— Passo 6.agents/rules/engineering-standards.mdc— "After every change"- Issue #43 (OPS2) — harvest agent-miss → guardrails