teqo-backup/.cursor/skills/work-issue/engineering-brief.md
Francisco Ignácio Fontoura Solla 8bca9d8e82 Separate intention plans from engineering execution in agent skills.
plan-issue now shapes product intent only; agent-work-issue (pool) and
work-issue (human gate) deliberate the implementation plan before coding.
2026-08-02 14:02:18 -03:00

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)

  • .cursor/rules/codebase-map.mdc — direção lib/ → utilities/ → components/ → app/; dono da feature
  • .cursor/rules/engineering-standards.mdc — gates, type honesty, client boundary, caching ladder, access
  • .cursor/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 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.