Skip to content

docs(backlog): Data Gaps Master Index — 20 catalogados, P0/P1/P2/structural#10

Open
nascimentolimaandre-cloud wants to merge 1 commit intomainfrom
feat/data-gaps-master-index
Open

docs(backlog): Data Gaps Master Index — 20 catalogados, P0/P1/P2/structural#10
nascimentolimaandre-cloud wants to merge 1 commit intomainfrom
feat/data-gaps-master-index

Conversation

@nascimentolimaandre-cloud
Copy link
Copy Markdown
Owner

Summary

Closes the loop on a audit completa de data quality (2026-04-30): todos os 20 gaps de dados conhecidos agora têm single source of truth em docs/backlog.md "Data Gaps Master Index", com cross-refs para INCs / FDDs / ingestion-spec / kanban-metrics-backlog.

Por que esta PR

Audit conduzido a pedido do usuário ("lista quais são os GAPs de dados que ainda temos") revelou que parte dos gaps estavam dispersos entre 4-5 docs sem visão unificada, e 4 gaps de schema-sem-normalizer-fill (INCs novos) descobertos durante FDD-OPS-001 L5 ainda não tinham entrada formal. Master Index resolve ambos.

What ships

4 novos INCs em metrics-inconsistencies.md

INC Descrição Quick-win?
INC-024 eng_deployments.trigger_type/trigger_ref/url NULL — Jenkins API tem dados, normalizer/connector não extraem S
INC-025 eng_pull_requests.url/closed_at NULL — connector tem, normalizer ignora 2 campos XS (2 linhas)
INC-026 eng_issues.priority NULL — connector mapeia, normalizer não copia XS (1 linha)
INC-027 eng_issues.linked_pr_ids vazio — reverso de linked_issue_ids, falta lógica S

Total: 27 INCs catalogados (11 P0 + 11 P1 + 5 P2).

Master Index em docs/backlog.md

Nova section "Data Gaps — Master Index" com:

  • Header de coverage atual: snapshot tenant-wide (54% trans, 3,7% effort, 0% priority, etc.)
  • 4 tiers de impacto:
    • 🔴 ALTO (6 itens): MTTR, Scope Creep, Per-team, BG short-fetch, deployed_at coverage, descriptions backfill
    • 🟡 MÉDIO (6 itens): INC-024..027 + link rate recovery + custom fields
    • 🟢 BAIXO (4 itens): edge cases aceitáveis para R1
    • ESTRUTURAL (4 itens): R2/R3 (blocked time, effort_source, AI fallbacks)
  • Top 5 quick-wins ranqueados por esforço/impacto
  • Update protocol explícito (sem duplicação entre docs)

Estratégia de não-duplicação

  • Conteúdo detalhado fica em INC catalog (file:line, fix recommended) ou FDD-OPS card (acceptance criteria, estimate, dependencies)
  • Master Index só agrega + ranqueia + linka — nunca duplica
  • Update protocol no rodapé garante future audits sigam o mesmo padrão

Para o agente (MEMORY.md)

Adicionado reminder_data_gaps_master_index.md + entry no MEMORY.md
"Active Reminders" para surface proativo quando usuário pergunta:

  • "próximos passos" / "what's next"
  • "data quality" / "qualidade dos dados"
  • "o que está faltando"
  • coverage de qualquer entidade

Stats

  • 2 arquivos, +90 linhas
  • 0 code changes (puramente documentação consolidada)
  • 20 gaps organizados (vs dispersos antes)

Test plan

  • Cross-refs em docs/backlog.md resolvem (links para INC/FDD/ingestion-spec)
  • Coverage numbers no header batem com queries SQL atuais
  • Top 5 quick-wins sequence tem dependencies claros
  • MEMORY.md reminder_data_gaps_master_index.md lido em próxima sessão (verifica protocol)

🤖 Generated with Claude Code

…ctural

Closes the loop on the data quality audit (2026-04-30): all 20 known data
gaps now have a single source of truth (`docs/backlog.md` Master Index),
cross-referencing INC catalog + FDD-OPS cards + ingestion-spec sections.

NEW INCs (4 — schema correto, normalizer não popula)

  - INC-024: eng_deployments.trigger_type/trigger_ref/url NULL
             → connector + normalizer não extraem; schema OK
  - INC-025: eng_pull_requests.url/closed_at NULL
             → connector tem dados, normalizer ignora 2 campos
  - INC-026: eng_issues.priority NULL
             → connector mapeia, normalizer não copia (1 linha fix)
  - INC-027: eng_issues.linked_pr_ids vazio
             → reverso de linked_issue_ids, falta lógica pós-link

Total: 11 P0 + 11 P1 + 5 P2 = 27 INCs catalogados.

NEW SECTION em docs/backlog.md

  Data Gaps Master Index — tabela em 4 tiers (🔴 ALTO / 🟡 MÉDIO /
  🟢 BAIXO / ⚪ ESTRUTURAL) com:
    - Header de coverage atual (54% trans, 3,7% effort, 0% priority, ...)
    - 20 gaps com cross-ref para fonte autoritativa
    - Top 5 quick-wins ranqueados (INC-026 1 linha → maior impacto)
    - Update protocol pra evitar drift entre os docs

ESTRATÉGIA DE NÃO-DUPLICAÇÃO

  - Conteúdo detalhado fica em INC catalog (file:line, fix recommended)
    ou FDD-OPS card (acceptance criteria, estimate, dependencies)
  - Master Index só agrega + ranqueia + linka
  - Update protocol explícito no rodapé pra futuras audits

MEMORY.md (separately) updated com reminder pointing to Master Index.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant