developer-vector-db

name	developer-vector-db
description	Planejar e implementar mudanças na camada vetorial Qdrant (collections, distance metric, vector size, payload filters, upsert/delete e migração de schema); usar quando o pedido tocar modelagem ou operação de vetor e não usar para lógica do indexador, handlers MCP, infra geral ou documentação.

Developer Vector DB

1) Objetivo e Escopo

Projetar e manter o armazenamento vetorial em Qdrant com schema claro, filtros eficientes e operações seguras de evolução.

Trigger policy

• Disparar quando o pedido mencionar Qdrant, collection, métrica de distância, tamanho de vetor, filtros por payload, upsert/delete, snapshots, migração de schema ou versionamento de pontos.
• Disparar quando houver ajuste em contrato de payload que impacta busca semântica e filtros.
• Não disparar para lógica de chunking/embedding (developer-indexer), handlers MCP (developer-mcp-server), bootstrap docker/env (developer-infra) ou documentação (developer-docs).

2) Entradas esperadas

• Nome da collection e objetivo da mudança.
• vector_size, distance metric, índices de payload e filtros necessários.
• Estratégia de versionamento/migração de schema e compatibilidade.
• Política de retenção, delete lógico/físico e rollback.

3) Workflow (Discovery -> Plan -> Implement -> Validate -> Deliver)

1. Discovery
   • Mapear configuração atual de collection e contratos de payload consumidos.
   • Levantar consultas e filtros críticos para performance e precisão.
   • Consultar references/checklist.md para garantir segurança de migração.
2. Plan
   • Definir plano de migração (in-place, shadow collection ou backfill) com rollback.