Menu
Captura e armazena licoes tecnicas de bug fixes ou decisoes arquiteturais
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Refina ideias atraves de perguntas antes de implementar
Revisao sistematica de codigo focada em qualidade, padroes e manutencao
Decomposição de tarefas complexas em Roadmaps e Sprints
Workflow sistemático para versionamento, atualização de documentação e tagueamento seguro de releases.
Processo de 4 fases para encontrar causa raiz de bugs
Ciclo RED-GREEN-REFACTOR obrigatorio para todo codigo de producao
| name | learned-lesson |
| description | Captura e armazena licoes tecnicas de bug fixes ou decisoes arquiteturais |
| triggers | ["licao","aprendi","memorizar","learned","concluimos","padrao","sucesso","excelencia","decisao"] |
| globs | [".aidev/memory/kb/*.md","docs/lessons/*.md"] |
| steps | 4 |
| checkpoints | ["context_captured","root_cause_identified","solution_documented","lesson_stored"] |
| artifact | .aidev/memory/kb/YYYY-MM-DD-<topic>.md |
| previous_skill | systematic-debugging |
.aidev/memory/kb/YYYY-MM-DD-<topic>.mdAtiva apos a conclusao de uma tarefa complexa, correcao de bug, implementacao de um padrao de sucesso ou decisao arquitetural importante. O objetivo e economizar tokens e tempo em sessoes futuras ao reutilizar solucoes de excelencia ou evitar erros repetidos.
Capturar conhecimento tacito (como resolvemos algo ou por que algo funcionou tao bem) e transforma-lo em conhecimento explicito reutilizavel.
Checkpoint: context_captured
Documentar o contexto do aprendizado:
## Contexto
**Stack**: [Ex: Laravel 10 + PHP 8.2]
**Ambiente**: [Ex: Producao, Docker]
**Frequencia**: [Ex: Intermitente, sempre]
**Impacto**: [Ex: Critico, Alto, Medio, Baixo]
### Sintoma Observado
[Descricao do comportamento errado]
### Comportamento Esperado
[Descricao do comportamento correto]
### Evidencia
[Stack trace, log, screenshot]
Checkpoint: root_cause_identified
Aplicar tecnica dos 5 Porques:
## Causa Raiz
### Analise (5 Whys)
1. **Por que falhou?** [Resposta]
2. **Por que?** [Resposta]
3. **Por que?** [Resposta]
4. **Por que?** [Resposta]
5. **Por que?** [Causa raiz]
### Causa Raiz Identificada
[Explicacao tecnica clara e concisa]
### Tipo de Problema / Padrao
- [ ] Bug de codigo
- [ ] Configuracao incorreta
- [ ] Padrao de Codificacao (Sucesso)
- [ ] Decisao Arquitetural
- [ ] Otimizacao de Performance
- [ ] Falta de validacao
- [ ] Outro: ___
Checkpoint: solution_documented
Documentar a correcao de forma reproduzivel:
## Solucao
### Correcao Aplicada
```[linguagem]
// Codigo que resolveu o problema
[Explicacao tecnica de por que essa solucao resolve a causa raiz]
| Alternativa | Por que nao escolhida |
|---|---|
| ... | ... |
path/to/test.spec.tsnpm test -- --grep "..."
### Criterios de Validacao
- [ ] Codigo/mudanca documentado
- [ ] Explicacao do porque funciona
- [ ] Teste de regressao adicionado
- [ ] Comando de verificacao funciona
---
## Step 4: Armazenar Licao
**Checkpoint**: `lesson_stored`
### Acoes
#### Memoria Local (Projeto)
Salvar em `.aidev/memory/kb/`:
```bash
# Nome do arquivo
YYYY-MM-DD-<slug-do-problema>.md
Se aplicavel a outros projetos:
# Usar basic-memory MCP
mcp__basic-memory__write_note
# Licao: [Titulo Curto e Descritivo]
**Data**: YYYY-MM-DD
**Stack**: [Tecnologias envolvidas]
**Tags**: [bug, success-pattern, arch-decision, performance, security, etc]
## Contexto
[Resumo do contexto - do Step 1]
## Problema
[Sintoma e evidencia - do Step 1]
## Causa Raiz
[Explicacao tecnica - do Step 2]
## Solucao
[Codigo/mudanca - do Step 3]
## Prevencao
Como evitar no futuro:
- [ ] Checklist item 1
- [ ] Checklist item 2
## Referencias
- [Link para PR/commit]
- [Link para documentacao]
| Categoria | Descricao | Exemplo |
|---|---|---|
bug | Correcao de erro | NPE em campo nullable |
success-pattern | Padrao de Excelencia | Implementacao limpa de Repository |
arch-decision | Decisao Arquitetural | Uso de Event Sourcing |
config | Configuracao | Timeout de conexao |
performance | Otimizacao | N+1 query |
security | Vulnerabilidade | SQL injection |
integration | Integracao | API externa |
deployment | Deploy/infra | Docker/K8s |
skill_add_artifact "learned-lesson" ".aidev/memory/kb/YYYY-MM-DD-<topic>.md" "lesson"
skill_complete "learned-lesson"
# Licao disponivel para consulta futura
skill_fail "learned-lesson" "Motivo da falha"
# Salvar estado parcial para retomar depois
skill_init "learned-lesson"
skill_set_steps "learned-lesson" 4
# Step 1: Capturar contexto
skill_advance "learned-lesson" "Capturar contexto"
# ... documentar contexto, sintoma, evidencia ...
skill_validate_checkpoint "learned-lesson"
# Step 2: Identificar causa raiz
skill_advance "learned-lesson" "Identificar causa raiz"
# ... aplicar 5 whys, classificar problema ...
skill_validate_checkpoint "learned-lesson"
# Step 3: Documentar solucao
skill_advance "learned-lesson" "Documentar solucao"
# ... registrar correcao, validar com teste ...
skill_validate_checkpoint "learned-lesson"
# Step 4: Armazenar licao
skill_advance "learned-lesson" "Armazenar licao"
# ... salvar arquivo, atualizar memoria ...
skill_add_artifact "learned-lesson" ".aidev/memory/kb/2024-01-15-timeout-api.md" "lesson"
skill_validate_checkpoint "learned-lesson"
skill_complete "learned-lesson"
Para consultar licoes em sessoes futuras:
# Listar e buscar (CLI Otimizado)
aidev lessons
aidev lessons --search "termo"
aidev lessons --read "nome-arquivo"
# Busca global (basic-memory)
mcp__basic-memory__search_notes query="palavra-chave"