mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-21 02:35:20 +00:00
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.
36 lines
2 KiB
Markdown
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.
|