- Remove .claude/skills (symlinks) e a árvore .cursor (rules, hooks, skills) - Adiciona .agents/ com skills (+ references/), rules/, hooks/ e scripts - Adiciona .codex/hooks.json (hook do impeccable) - Corrige referências .cursor → .agents em environment.json, hooks.json e AGENTS.md
2.1 KiB
Qualidade de decisão (plano de implementação)
Aplique ao escrever docs/plans/<slug>-impl.md em work-issue / agent-work-issue. O plano de intenção já fixou o outcome — aqui se escolhe a engenharia. Decisão silenciosa é defeito.
Caro vs barato
Delibere e registre só o caro de reverter. O barato vira Não escopo, fill-in, ou “mais simples que funciona” com gatilho de revisitação.
| Caro (decidir agora + rejeitadas) | Barato (adiar / mais simples) |
|---|---|
| Collection nova, unicidade, access | Polish cosmético, 2º estilo de card |
Nova chave Consent / PII |
Copy, motion, a11y P3 |
| Semântica multi-collection / locks | Prefetch, ordem de colunas |
| URL pública / slug imutável | Rename de pureza |
| Fronteira de módulo em volatilidade real | Adapter com 1 call site |
Forma obrigatória
Toda decisão não trivial de engenharia:
Opções: A | B | C
Recomendação: B — porque …
Alternativas rejeitadas: A porque …; C porque …
No *-impl.md: Decisões de engenharia = decisão + por quê + rejeitadas.
Appetite e tracer bullet
Respeite o appetite do plano de intenção. Se a abordagem estoura → cortar rabbit holes, não inflar. Preferir tracer bullet cedo (schema mínimo → uma action → uma superfície) antes de polish paralelo.
Depth check
Antes de propor arquivo/utility/componente novo:
- Já existe módulo profundo? (
campaignAccess, shells de lista,withPayloadTransaction, …) → reusar - Pass-through raso? → não criar
- Conhecimento vazaria em N módulos? → encapsular uma vez
Rabbit holes Teqo
Layers/cerimônia sem volatilidade; cadastro paralelo a Contact; Consent por ID hardcoded; DRY <3 call sites; redesign de paleta fora de campaign.
Self-score (0–5, gate ≥4)
- Decisões caras têm rejeitadas?
- Abordagem cabe no appetite da intenção?
- Rabbit holes nomeados?
- Depth check: reusa shells/helpers existentes?
- Intenção (aceite de produto) permanece satisfeita — engenharia não reescreveu o outcome?