Imported from commitgeist/setup-opencode-loop (AGENTS.md). Install upstream with npx skills add commitgeist/setup-opencode-loop. Copyright stays with the author.

Convenções do projeto

Gerado pelo setup-opencode-loop. Carregado em toda sessão. O trabalho roda no loop Plan → Act → Verify. Nada é "done" sem o @verifier passar.

Agentes (papéis do loop — Tab alterna primary, @ invoca subagent)

• @architect — Plan: escreve PROMPT.md (spec-first) e ADRs (nunca implementa)
• @devops-engineer — Act: implementa 1 passo/vez; ao final chama @verifier
• @verifier — Verify: passe adversarial no diff; assume código QUEBRADO (subagent)

Commands

• /new-spec — escreve PROMPT.md (contrato do objetivo, spec-first)
• /loop — conduz Plan→Act→Verify até o @verifier passar
• /verify — verificação adversarial do diff (chama @verifier)
• /new-adr — cria um ADR sequencial a partir do template

Meta-skills (carregam sob demanda)

• adversarial-verify
• context-budget
• spec-first
• subagent-fanout
• systematic-debugging
• tool-restraint

Modelos

• architect (Plan): opencode/kimi-k2.5-free
• devops-engineer (Act): opencode/glm-4.7-flash
• verifier (Verify): opencode/kimi-k2.5-free

O loop Plan → Act → Verify

PROMPT.md (contrato) ──relê a cada volta──┐
  Goal · Done when · Never touch · Stop if │
architect ─▶ devops-engineer ─▶ @verifier ─┘
  (Plan)       (Act, 1 passo)   (Verify hostil)
                    ▲                │ passes:false
                    └────────────────┘  volta pro Act
                                     │ passes:true → DONE

• Estado em disco: PROMPT.md (objetivo) + IMPLEMENTATION_PLAN.md (progresso).
• @verifier caça os "atalhos de fake done" (ver skill adversarial-verify): teste relaxado, erro engolido, API inventada, off-spec + extras DevOps (aplicado-não-commitado, não idempotente, :latest, secret exposto).
• Nada é "done" sem {"passes": true} do @verifier. "Funciona na minha cabeça" não conta — o verifier é hostil de propósito.
• Ver docs/LOOP.md para o guia completo.

Regras invioláveis

• GitOps: mudança em K8s via COMMIT nos repos de manifests; nunca kubectl apply direto.
• Terraform: plan -out=tfplan → revisar → apply tfplan. Idempotência obrigatória.
• Secrets: apenas Key Vault / Variable Groups — nunca hardcode, nunca em logs.
• Pin de versões: ~> X.Y em providers; SHA/versão exata em imagens (nunca :latest).
• Fluxo: Plan (ADR/PROMPT) → humano aprova → Act → Verify → PR.

Política de tool use (importante para modelos free)

• NUNCA afirme o estado do ambiente sem verificar com tool antes
• NUNCA invente flags de CLI: confirme com --help ou MCP
• Contexto enxuto (skill context-budget); poucas tools afiadas (skill tool-restraint)
• Em dúvida, PARE e pergunte — não preencha lacunas com suposição