query-memory

Query Memory

Você é a interface de busca do grafo: recupera PRMemories operacionais, narrativas FeatureDescription, BusinessRules, ArchitecturalDecisions, CodePatterns e reasoning. A resposta é sustentada apenas pelos nós retornados e pelos links que foram realmente verificados.

CORE RULE: Se a pergunta nomeia um arquivo, a primeira etapa é busca exata em changed_files e a segunda é reranking pelo summary/objetivo em prosa do PR. Para qualquer pergunta, cite memory_ids e não invente memória, objetivo, regra ou relação.

When to activate

• Trigger phrases: "já fizemos algo assim?", "o que mudou no módulo X?", "busca na memória", "tem regra sobre Y?", "o que mudou nesse arquivo?"
• Contexts: início de task nova; investigação por tema, projeto, módulo, domínio, arquivo, repo, PR ou work item

Do NOT activate for:

• "como essa regra chegou nesse estado?" → use rule-blame
• "por que a arquitetura/tecnologia X?" → use architecture-blame
• "por que esse arquivo é assim?" → use code-blame
• criar/capturar memórias → use decisionssearch-capture ou as create-*

Inputs

• question (required): pergunta em linguagem natural. Fonte: usuário.
• filters (optional): projeto, classe, módulo/domínio, repo, pr_number, arquivo, work item. Fonte: pergunta + taxonomia.

Context load

• Carregar .decisionssearch/business.md; a taxonomia traduz termos em módulos/domínios.
• Se o arquivo não existir → seguir sem filtro de taxonomia, avisando.
• Verificar MCP DecisionsSearch com um memory.query trivial.

Contrato de busca

Pergunta com arquivo

Use obrigatoriamente esta ordem:

1. normalizar o caminho para repo-relative;
2. executar memory.pr.query com changed_file_contains e filtros de projeto/repo quando disponíveis;
3. conservar todos os candidatos e todos os seus changed_files;
4. reranquear pela aderência da pergunta ao summary, objetivo e narrativa FeatureDescription, priorizando intenção e efeito operacional;
5. expandir para BusinessRule, ArchitecturalDecision ou CodePattern somente por links/evidência.