mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-17 21:03:06 +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.
2 KiB
2 KiB
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çãolib/→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/overrideAccessAGENTS.md— auth campanha, Consent fail-closed, transactions, naming, DB localdocs/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 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 →
Consentpor chave estável, fail-closed leaderlockdown; semestimatedVotespara 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.