chore(meta): institutionalize PR ↔ Issue cross-reference pattern

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -58,6 +58,14 @@ body:
       label: Logs / Screenshots
       description: Cole logs relevantes ou anexe prints.
       render: shell
+  - type: input
+    id: origin_pr
+    attributes:
+      label: PR de origem (se aplicável)
+      description: |
+        Se este bug foi descoberto durante uma PR (ex: review, CI, smoke test), referencie aqui.
+        Padrão do projeto: toda issue tem cross-reference para a PR que a descobriu.
+      placeholder: "#152"
   - type: textarea
     id: context
     attributes:

.github/ISSUE_TEMPLATE/feature_request.yml

@@ -44,3 +44,9 @@ body:
         - Cloudflare
         - Frontend
         - Outro
+  - type: input
+    id: origin_pr
+    attributes:
+      label: PR de origem (se aplicável)
+      description: Se esta feature foi proposta durante uma PR, referencie aqui.
+      placeholder: "#152"

.github/ISSUE_TEMPLATE/tracking.yml

@@ -0,0 +1,69 @@
+name: 📌 Tracking / Discussion
+description: Issue de rastreamento — dívida técnica, decisão estratégica, follow-up de PR
+title: "[Tracking] "
+labels: ["tracking", "tech-debt"]
+body:
+  - type: textarea
+    id: summary
+    attributes:
+      label: TL;DR
+      description: Resumo em 2-3 frases do que está sendo rastreado e por quê
+    validations:
+      required: true
+  - type: input
+    id: origin_pr
+    attributes:
+      label: PR de origem
+      description: |
+        ⚠️ **OBRIGATÓRIO para tracking issues** — qual PR descobriu/criou este trabalho?
+        Padrão do projeto: tracking issues sempre têm cross-reference bidirecional com PR.
+      placeholder: "#152"
+    validations:
+      required: true
+  - type: textarea
+    id: context
+    attributes:
+      label: Contexto detalhado
+      description: O que foi descoberto, quais arquivos/sistemas afetados, evidências (logs, queries SQL, screenshots)
+    validations:
+      required: true
+  - type: textarea
+    id: options
+    attributes:
+      label: Opções estratégicas (se discussion)
+      description: |
+        Se for uma decisão a tomar, liste as opções com pros/contras:
+        - **Opção A** — Manter como está. Pros/Contras
+        - **Opção B** — ... 
+        - **Opção C** — ...
+      placeholder: "(opcional se for puramente tracking de tech-debt)"
+  - type: textarea
+    id: dod
+    attributes:
+      label: Definition of Done
+      description: |
+        Critérios objetivos para fechar esta issue. Use checkboxes:
+        - [ ] Decidir abordagem
+        - [ ] Implementar
+        - [ ] Validar em staging
+        - [ ] Remover workaround temporário
+    validations:
+      required: true
+  - type: dropdown
+    id: priority
+    attributes:
+      label: Prioridade
+      options:
+        - "🔴 Alta - bloqueia outras decisões"
+        - "🟠 Média - próximo ciclo"
+        - "🟢 Baixa - quando der"
+    validations:
+      required: true
+  - type: textarea
+    id: docs
+    attributes:
+      label: Documentação relacionada
+      description: Links para docs/, ADRs, ou outras issues que dão contexto
+      placeholder: |
+        - `docs/redeploy/REDEPLOY-T2.5-FOLLOWUP.md`
+        - Refs #155

.github/PULL_REQUEST_TEMPLATE.md

@@ -1,6 +1,6 @@
 ## 📋 Descrição
 
-<!-- O que muda e por quê. Seja conciso. -->
+<!-- O que muda e por quê. Seja conciso (1-3 frases). -->
 
 ## 🎯 Tipo de mudança
 
@@ -9,11 +9,29 @@
 - [ ] ♻️ refactor — refatoração (sem mudança de comportamento)
 - [ ] 🔧 chore — manutenção, deps, config
 - [ ] 📚 docs — documentação
+- [ ] ⚡ perf — performance
+- [ ] 🔒 security — segurança
 - [ ] 🚨 hotfix — correção urgente em produção
+- [ ] 💥 breaking change — quebra compatibilidade
 
-## 🌐 Sistemas afetados
+## 🔗 Issues relacionadas
+
+<!--
+Use uma das palavras-chave abaixo para conectar issues e fechá-las automaticamente ao merge:
+
+  Closes #123     → fecha #123 quando esta PR for mergeada
+  Fixes #456      → fecha #456 (sinônimo)
+  Refs #789       → apenas referencia (não fecha)
+  Part of #999    → indica que é parte de um trabalho maior
 
-<!-- Marque todos os que se aplicam -->
+Se esta PR DESCOBRIR uma issue nova (caso de tracking), abra-a ANTES e linke aqui.
+Padrão do projeto: issues sempre devem ter referência à PR que as criou.
+-->
+
+Closes #
+Refs #
+
+## 🌐 Sistemas afetados
 
 - [ ] Bitrix24 (CRM, SPAs, BizProc)
 - [ ] Supabase (DB, Edge Functions, RLS, migrations)
@@ -22,29 +40,50 @@
 - [ ] Bling (NFe, OAuth)
 - [ ] Cloudflare (Workers, Images, Tunnels)
 - [ ] Frontend (UI, dashboards)
+- [ ] CI / GitHub Actions
 - [ ] Outro: ____
 
 ## 🧪 Como testar
 
 <!-- Passo a passo para validar. Inclua dados de teste se necessário. -->
 
-1. 
-2. 
-3. 
+1.
+2.
+3.
 
 ## ✅ Checklist pré-merge
 
+### Qualidade
+- [ ] Código segue style guide (ESLint passa)
+- [ ] `npx tsc --noEmit` passa sem erros
+- [ ] Testes passam (`npm run test`)
+- [ ] Adicionei testes para novas funcionalidades quando aplicável
+- [ ] CodeRabbit revisou o PR (ou justificativa para skip)
+
+### Segurança
 - [ ] Sem secrets, tokens ou credenciais hardcoded
 - [ ] Variáveis de ambiente novas documentadas
+- [ ] Sem `console.log` com payloads sensíveis (usar `logger.*`)
+- [ ] RLS revisado se houve mudança em tabelas
+- [ ] Edge functions: input validado com Zod
+
+### Documentação
+- [ ] Atualizei docs (README / CHANGELOG / docs/) se necessário
+- [ ] Memória atualizada (`mem://`) se a mudança afetar arquitetura/regras
 - [ ] Migrations com backup em `_backup_*_YYYYMMDD` se destrutivas
-- [ ] Testado em ambiente local ou staging quando aplicável
-- [ ] Sem `console.log` com payloads sensíveis
-- [ ] CodeRabbit revisou o PR
+
+### UI
+- [ ] Componentes usam tokens semânticos (sem cores hardcoded)
+- [ ] Screenshots / vídeo anexados (se mudança visual)
+
+## 📸 Screenshots (se UI)
+
+<!-- Antes / Depois -->
 
 ## 🔄 Plano de rollback
 
 <!-- Como reverter se algo der errado em produção? -->
 
-## 🔗 Issues relacionadas
+## ⚠️ Notas para o reviewer
 
-<!-- Closes #123, Refs #456 -->
+<!-- Algo que mereça atenção especial -->