learn-capture

---
name: learn-capture-7dc2da045c8c
description: Captura sinais de aprendizado relevantes durante o fluxo do Superpowers para revisão futura
---

# learn-capture

Skill leve de captura. Registra um sinal em `docs/lorebase/learn/inbox.md` quando um aprendizado observado durante o trabalho pode afetar `docs/lorebase/*.md`.

## Quando usar

Use durante qualquer fase do Superpowers ao observar:

- Convenção real que contradiz ou complementa `docs/lorebase/CONVENTIONS.md`
- Padrão de arquitetura não documentado em `docs/lorebase/ARCHITECTURE.md`
- Integração externa não registrada em `docs/lorebase/INTEGRATIONS.md`
- Abordagem de teste diferente de `docs/lorebase/TESTING.md`
- Tecnologia ou lib não registrada em `docs/lorebase/STACK.md`
- Risco ou dívida não listada em `docs/lorebase/CONCERNS.md`
- Estrutura de diretório não refletida em `docs/lorebase/STRUCTURE.md`

### Gatilhos de momento no fluxo

O check é **por task**, não uma vez ao final. Execute imediatamente ao concluir cada task, antes de marcá-la como feita:

- Subagente reportou `DONE_WITH_CONCERNS`? Leia as preocupações agora. Se indicarem comportamento inesperado de biblioteca, ambiente ou divergência de design, capture antes de avançar.
- Code reviewer apontou comportamento não documentado de biblioteca, API ou ambiente nesta task? Capture antes de avançar.
- A implementação desta task divergiu do que estava especificado no plano? Capture a divergência e o motivo.

Se nenhum desses se aplicar, avance sem capturar.

## Filtro de relevância

**Capture:**
- Aprendizado que pode corrigir ou complementar `docs/lorebase/*.md`
- Padrão verificável no código atual

**Não capture:**
- Bug pontual sem impacto na documentação
- Tarefa ou TODO pendente
- Preferência pessoal do desenvolvedor
- Decisão ainda não implementada ou validada
- Anotação genérica sem evidência no código

## Processo

1. Identifique qual arquivo de `docs/lorebase/*.md` seria afetado.
2. Localize a evidência no código (arquivo, linha, configuração, teste).
3. Se não houver evidência verificável, não capture — apenas avise o desenvolvedor.
4. Adicione ao final de `docs/lorebase/learn/inbox.md`:

```markdown
## [YYYY-MM-DD] Captura durante [fase]

- **Arquivo afetado**: docs/lorebase/NOME.md
- **Seção**: nome da seção
- **Observação**: o que foi encontrado
- **Evidência**: caminho/arquivo e trecho que comprova
- **Ação sugerida**: corrigir / complementar / adicionar
- **Confiança**: HIGH / MEDIUM / LOW
```

Critérios de confiança: [`criteria.md`](criteria.md).

5. Confirme ao desenvolvedor que o sinal foi registrado com a localização da evidência.

## Regras

- Só escreve em `docs/lorebase/learn/inbox.md`.
- Nunca altera `docs/lorebase/*.md` diretamente.
- Um sinal por observação distinta — não agrupe múltiplas observações em um sinal.
- Sempre inclua evidência verificável. Sem evidência, não capture.