teqo-backup/.agents/skills/work-issue/engineering-brief.md
Francisco Ignácio Fontoura Solla 896d957497 chore: migrate .cursor/ references to .agents/ folder
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.
2026-08-05 00:09:09 -03:00

36 lines
2 KiB
Markdown

# Brief de engenharia (carregar antes do plano de implementação)
Leia o que for relevante **antes** de travar a abordagem no `*-impl.md`. Não invoque jornadas inteiras de skills — aplique o princípio no momento da decisão.
## Pinos do repo (sempre)
- `.agents/rules/codebase-map.mdc` — direção `lib/` → `utilities/` → `components/` → `app/`; dono da feature
- `.agents/rules/engineering-standards.mdc` — gates, type honesty, client boundary, caching ladder, access
- `.agents/rules/security-critical.mdc` — quando tocar access/Local API/overrideAccess
- `AGENTS.md` — auth campanha, Consent fail-closed, transactions, naming, DB local
- `docs/ARCHITECTURE.md` — se a mudança cruza verticais ou modelo de domínio
## Skills sob demanda (não tour)
| Situação | Skill / princípio |
| -------- | ----------------- |
| Onde colocar lógica / dependência | `clean-architecture` — Dependency Rule; core testável |
| Complexidade de módulo / API | `software-design-philosophy` — deep modules, anti-classitis |
| Escopo v1 / cortar especulação | `37signals-way` / `pragmatic-programmer` — build less, tracer bullet, DRY de conhecimento |
| Schema Payload | skill `payload-migrations` |
| DB local / Cloud sem Docker | skill `local-database` |
| KPI/mapa/série na UI | [data-presentation.md](../plan-issue/data-presentation.md) pergunta 3 no impl |
| Domínio `/campanha` específico | rules `projects/*` se o item tocar aquele projeto |
## Invariantes que o impl plan não pode violar
- Local API com `user` → `overrideAccess: false`
- Escrita multi-collection → transação + `req: { transactionID }`
- Pessoa → join com `Contact` (não collection paralela)
- Opt-in/PII → `Consent` por chave estável, fail-closed
- `leader` lockdown; sem `estimatedVotes` para liderança
- Copy pt-BR / identificadores em inglês
## Sistema de listas
Se a superfície for lista/tabela: reusar shells (`CampaignTable`, URL canônica, column visibility, pending boundary) — ver codebase-map. Não reinventar.