teqo-backup/.agents/skills/work-issue/implementation-template.md
Francisco Ignácio Fontoura Solla a2fbcb9c00 chore(agents): reorganiza árvore de skills — .claude/.cursor → .agents
- 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
2026-08-03 21:24:11 -03:00

65 lines
2 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Template de plano de implementação (`docs/plans/<slug>-impl.md`)
Criado em Plan mode por `work-issue` / `agent-work-issue` a partir do plano de **intenção**. Aqui a engenharia é deliberada — Opções + Recomendação + rejeitadas ([decision-quality.md](decision-quality.md)).
O outcome de produto do plano de intenção é **inviolável**. A forma técnica é **livre** desde que mantenha aceite, appetite e invariantes do repo ([engineering-brief.md](engineering-brief.md)).
````markdown
# Impl: <mesmo título da intenção>
Status: rascunho | aprovado | em execução
Atualizado em: <YYYY-MM-DD>
Issue: #<N>
Intenção: docs/plans/<slug>.md
Appetite restante: <herdado / ajustado com corte explícito>
## Leitura da intenção
- **Outcome:** <1–2 frases, nas palavras do aceite de produto>
- **O que NÃO negociar:** <lockdowns de produto / access / LGPD citados na intenção>
- **O que reavaliar:** <hipóteses de “Direção no codebase” que podem estar erradas>
## Abordagem recomendada
\```mermaid
flowchart LR
…
\```
**Opções consideradas:** A | B | C
**Recomendação:** <…> — porque …
**Rejeitadas:** …
### Componentes / mudanças
- **`<símbolo>`** (`src/…`): <responsabilidade; o que reusa>
- **Migration:** <nome sugerido / “sem migration”>
- **Access / Consent:** <helpers; chave se houver; fail-closed>
- **UI:** <Impeccable A–D; shells a reusar; shape→craft→critique→polish se B/C/D>
### Dados → forma (se aplicável)
- Forma escolhida + por quê + rejeitadas (pergunta 3 de data-presentation)
## Fases verificáveis
1. **Tracer / schema+server** — <quota do appetite>
2. **UI** — <…>
3. **Gates** — `pnpm gate:fast`; push via `pnpm push`
## Rabbit holes / Não escopo (engenharia)
- …
## Riscos e mitigação
- …
## Aceite de engenharia
- [ ] Aceite de produto da intenção ainda coberto
- [ ] Invariantes AGENTS/engineering-standards
- [ ] Testes de domínio previstos (unit/int) onde access/write paths mudam
````
Self-score decision-quality ≥4 antes de marcar `aprovado` ou executar.