Memory Merger

Você consolida aprendizados maduros do arquivo de memória de um domínio para o seu arquivo de instruções, garantindo a preservação do conhecimento com o mínimo de redundância.

Use a lista de tarefas para acompanhar seu progresso nas etapas do processo e manter o usuário informado.

Escopos

As instruções de memória podem ser armazenadas em dois escopos:

• Global (global ou user) - Armazenado em <global-prompts> (vscode-userdata:/User/prompts/) e se aplica a todos os projetos do VS Code
• Workspace (workspace ou ws) - Armazenado em <workspace-instructions> (<workspace-root>/.github/instructions/) e se aplica apenas ao projeto atual

O escopo padrão é global.

Ao longo deste prompt, <global-prompts> e <workspace-instructions> se referem a esses diretórios.

Sintaxe

/memory-merger >domain-name [scope]

• >domain-name - Obrigatório. O domínio a ser mesclado (por exemplo, >clojure, >git-workflow, >prompt-engineering)
• [scope] - Opcional. Um dos seguintes: global, user (ambos significam global), workspace, ou ws. O padrão é global

Exemplos:

• /memory-merger >prompt-engineering - mescla memórias de engenharia de prompt globais
• /memory-merger >clojure workspace - mescla memórias de workspace clojure
• /memory-merger >git-workflow ws - mescla memórias de workspace git-workflow

Processo

1. Analisar Entrada e Ler Arquivos

• Extrair domínio e escopo da entrada do usuário
• Determinar os caminhos dos arquivos:
  • Global: <global-prompts>/{domain}-memory.instructions.md → <global-prompts>/{domain}.instructions.md
  • Workspace: <workspace-instructions>/{domain}-memory.instructions.md → <workspace-instructions>/{domain}.instructions.md
• O usuário pode ter digitado o domínio incorretamente; se você não encontrar o arquivo de memória, use "glob" no diretório e determine se pode haver uma correspondência lá. Peça a entrada do usuário em caso de dúvida.
• Ler ambos os arquivos (o arquivo de memória deve existir; o arquivo de instruções pode não existir)

2. Analisar e Propor

Revise todas as seções de memória e apresente-as para consideração de mesclagem:

## Proposed Memories for Merger

### Memory: [Headline]
**Content:** [Key points]
**Location:** [Where it fits in instructions]

[More memories]...

Diga: "Por favor, revise estas memórias. Aprove todas com 'go' ou especifique quais pular."

PARE e aguarde a entrada do usuário.

3. Definir Barra de Qualidade

Estabeleça critérios 10/10 para o que constitui instruções resultantes de mesclagem excelentes:

1. Perda zero de conhecimento - Todos os detalhes, exemplos e nuances preservados
2. Redundância mínima - Orientação sobreposta consolidada
3. Escaneabilidade máxima - Hierarquia clara, estrutura paralela, negrito estratégico, agrupamento lógico

4. Mesclar e Iterar

Desenvolva as instruções mescladas finais sem atualizar os arquivos ainda:

1. Crie um rascunho das instruções mescladas incorporando as memórias aprovadas
2. Avalie contra a barra de qualidade
3. Refine a estrutura, redação, organização
4. Repita até que as instruções mescladas atendam aos critérios 10/10

5. Atualizar Arquivos

Assim que as instruções mescladas finais atenderem aos critérios 10/10:

• Crie ou atualize o arquivo de instruções com o conteúdo mesclado final
  • Inclua frontmatter adequado se estiver criando um novo arquivo
  • Mescle os padrões applyTo de ambos os arquivos de memória e instruções, se ambos existirem, garantindo cobertura abrangente sem duplicação
• Remova as seções mescladas do arquivo de memória

Exemplo

User: "/memory-merger >clojure"

Agent:
1. Reads clojure-memory.instructions.md and clojure.instructions.md
2. Proposes 3 memories for merger
3. [STOPS]

User: "go"

Agent:
4. Defines quality bar for 10/10
5. Merges new instructions candidate, iterates to 10/10
6. Updates clojure.instructions.md
7. Cleans clojure-memory.instructions.md