From carbon-claude-brain
Salva aprendizado reutilizável em global/learnings.md. Use quando descobrir regra geral que vale para qualquer projeto.
How this skill is triggered — by the user, by Claude, or both
Slash command
/carbon-claude-brain:carbon-brain-learnThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Salva um aprendizado reutilizável em `_claude-brain/global/learnings.md`.
Salva um aprendizado reutilizável em _claude-brain/global/learnings.md.
Use quando descobrir conhecimento reutilizável:
❌ Não use para:
#!/usr/bin/env bash
source ~/.claude/hooks/lib-carbon-brain.sh
load_config
# Função: save_learning(category, learning)
# Categorias: Desenvolvimento, Arquitetura, Performance, Segurança, Testing, DevOps
CATEGORY="$1"
LEARNING="$2"
if [ -z "$CATEGORY" ] || [ -z "$LEARNING" ]; then
echo "❌ Uso: /brain-learn \"Categoria\" \"Aprendizado\""
echo ""
echo "Categorias disponíveis:"
echo " - Desenvolvimento"
echo " - Arquitetura"
echo " - Performance"
echo " - Segurança"
echo " - Testing"
echo " - DevOps"
exit 1
fi
if save_learning "$CATEGORY" "$LEARNING"; then
echo "✅ Aprendizado salvo em global/learnings.md"
else
echo "❌ Erro ao salvar aprendizado"
exit 1
fi
# Performance
/brain-learn "Performance" "Sempre adicionar índice em colunas usadas em WHERE/JOIN"
# Segurança
/brain-learn "Segurança" "Validar e sanitizar TODOS os inputs do usuário, mesmo internos"
# Arquitetura
/brain-learn "Arquitetura" "Preferir composição a herança - mais flexível e testável"
# Testing
/brain-learn "Testing" "Mockar apenas dependências externas, não lógica interna"
# Desenvolvimento
/brain-learn "Desenvolvimento" "Usar async/await ao invés de .then() - código mais legível"
# DevOps
/brain-learn "DevOps" "Sempre ter health check endpoint para load balancers"
Práticas gerais de código, patterns, convenções
Exemplos:
Decisões estruturais, organização de código
Exemplos:
Otimizações, caching, eficiência
Exemplos:
Vulnerabilidades, validação, autenticação
Exemplos:
Estratégias de teste, patterns, cobertura
Exemplos:
Deploy, CI/CD, infraestrutura, monitoramento
Exemplos:
---
updated: 2026-03-22
tags: [learnings, knowledge-base]
---
# Aprendizados Globais
## Desenvolvimento
- **2026-03-22:** Usar async/await ao invés de .then() - código mais legível
- **2026-03-20:** Preferir const sobre let, nunca usar var
- **2026-03-18:** Single Responsibility: uma função faz uma coisa só
## Arquitetura
- **2026-03-21:** Feature folders > type folders para escalabilidade
- **2026-03-19:** Dependency injection facilita testes
- **2026-03-15:** Separar lógica de negócio de framework
## Performance
- **2026-03-22:** Usar debounce em inputs de busca (300ms)
- **2026-03-20:** Sempre adicionar índice em colunas WHERE/JOIN
- **2026-03-17:** Cache queries caras com TTL 5min
## Segurança
- **2026-03-21:** Validar TODOS os inputs, mesmo internos
- **2026-03-19:** Hash passwords com bcrypt (min 10 rounds)
- **2026-03-16:** Rate limiting: 100 req/min por IP
## Testing
- **2026-03-20:** AAA pattern (Arrange-Act-Assert)
- **2026-03-18:** Testar comportamento, não implementação
- **2026-03-15:** Mínimo 80% coverage em lógica de negócio
## DevOps
- **2026-03-21:** Blue-green deployment para zero downtime
- **2026-03-19:** Sempre ter rollback plan antes de deploy
- **2026-03-17:** Logs estruturados (JSON) facilitam parsing
/brain-learn → Aprendizado geral e reutilizável (learnings.md)/brain-error → Erro específico resolvido (errors-solved.md)/brain-save → Resumo da sessão atual (journals/)/brain-plan → Contexto específico do projeto (project-context.md)Definida em lib-carbon-brain.sh:
save_learning() {
local category="$1"
local learning="$2"
local date=$(date '+%Y-%m-%d')
local file="$OBSIDIAN_VAULT/_claude-brain/global/learnings.md"
# Criar arquivo se não existir
if [ ! -f "$file" ]; then
cat > "$file" << 'EOF'
---
updated: {{DATE}}
tags: [learnings, knowledge-base]
---
# Aprendizados Globais
## Desenvolvimento
## Arquitetura
## Performance
## Segurança
## Testing
## DevOps
EOF
sed -i.bak "s/{{DATE}}/$date/" "$file"
rm "$file.bak" 2>/dev/null
fi
# Adicionar aprendizado na categoria
sed -i.bak "/## $category/a\\
- **$date:** $learning
" "$file"
rm "$file.bak" 2>/dev/null
# Atualizar data
sed -i.bak "s/^updated: .*/updated: $date/" "$file"
rm "$file.bak" 2>/dev/null
return 0
}
npx claudepluginhub marcoscarbonera/carbon-claude-brain --plugin carbon-claude-brainCaptures learnings from completed development sessions into reusable knowledge files organized by pattern, pitfall, decision, tool insight, and process improvement.
Saves, searches, recalls, digests, and prunes project learnings that persist across sessions. Use when the user wants to record knowledge or load prior learnings before starting work.
Logs errors, user corrections, missing features, API failures, knowledge gaps, and best practices to .learnings/ markdown files. Promotes key insights to CLAUDE.md and AGENTS.md for AI agent self-improvement.