---
name: salvar-aprendizados
description: Revisa a conversa/tarefa atual em busca de informação estável e reutilizável sobre o projeto (não específica da tarefa) e propõe adicioná-la a um CLAUDE.md (raiz do Workspace2025, do projeto atual, ou global), pedindo permissão antes de escrever. Use quando o usuário pedir para "salvar aprendizados", "atualizar o CLAUDE.md", "revisar o que vale guardar" ou algo do tipo, ou ao encerrar uma tarefa/sessão de trabalho.
---

# Salvar aprendizados em CLAUDE.md

## Objetivo
Olhar para o que foi descoberto/decidido na conversa e separar o que é
conhecimento **estável e reutilizável** (vale guardar) do que é **específico
da tarefa e decai rápido** (não vale guardar). Só escrever em algum CLAUDE.md
com permissão explícita do usuário.

## O que VALE guardar
- Estrutura/relações entre os projetos do Portal ISO (ex: quais telas ou
  classes são compartilhadas entre GED e GED WORD).
- Convenções, particularidades de arquitetura ou armadilhas de código legado
  específicas de um projeto.
- Preferências de fluxo de trabalho do usuário que valem pra qualquer projeto
  (ex: como testar, como confirmar mudanças).
- Pontos sensíveis do código (bugs sutis já corrigidos, mas fáceis de
  reintroduzir se mexerem ali de novo).

## O que NÃO vale guardar
- Histórico de bugs já corrigidos com detalhes de uma tarefa específica
  (número de revisão SVN, data do commit, quem reprovou) — isso já fica no
  histórico do SVN.
- Decisões válidas só para a tarefa em andamento.
- Qualquer coisa que já esteja derivável lendo o código atual.

## Passos

1. **Revisar a conversa/tarefa atual** e listar candidatos a entrar em algum
   CLAUDE.md, aplicando os critérios acima.

2. **Decidir o escopo de cada candidato:**
   - **Global** (`~/.claude/CLAUDE.md`): preferências de trabalho válidas pra
     qualquer projeto do usuário, não só Portal ISO.
   - **Raiz do Workspace2025** (`~/Workspace2025/CLAUDE.md`): informação que
     atravessa mais de um dos portais (Requisitos, GED, GED WORD).
   - **CLAUDE.md do projeto atual**: informação específica só daquele
     projeto/tela/módulo.

3. **Se não houver nenhum candidato relevante, diga isso e pare** — não force
   uma entrada só para preencher a skill.

4. **Apresentar cada candidato ao usuário** com o texto proposto (curto, no
   estilo dos CLAUDE.md já existentes) e o arquivo de destino, e pedir
   permissão explícita antes de editar. Uma alteração de cada vez, seguindo a
   preferência já registrada no CLAUDE.md global do usuário (mostrar antes de
   aplicar).

5. **Só editar o(s) arquivo(s) após aprovação.** Se o arquivo de destino não
   existir ainda, pode criá-lo, mas confirme o caminho com o usuário antes.

## Observações
- Sempre responder em português brasileiro.
- Seja seletivo — poucas entradas realmente úteis valem mais que muitas
  entradas triviais ou óbvias.