Modulo 6.5: Memoria por agente e por projeto

🗂️ Por cwd: projeto = pasta

Deteccao automatica: nome do diretorio vira nome do projeto. Hook escolhe memoria correspondente.

📐 Routing por cwd

#!/usr/bin/env bash
# session_start.sh com routing por projeto

INPUT=$(cat)
CWD=$(echo "$INPUT" | jq -r '.cwd')
PROJ=$(basename "$CWD")

# Carregar base (identidade global) + overlay (projeto especifico)
BASE=$(cat ~/.memory/prime.md 2>/dev/null || echo '')
OVERLAY=''
if [[ -f "$HOME/.memory/projects/$PROJ/context.md" ]]; then
  OVERLAY=$(cat "$HOME/.memory/projects/$PROJ/context.md")
elif [[ -f ~/.memory/context.md ]]; then
  OVERLAY=$(cat ~/.memory/context.md)
fi

CONTEXT="$BASE\n\n$OVERLAY"

python3 -c "
import json
print(json.dumps({
  'hookSpecificOutput': {
    'hookEventName': 'SessionStart',
    'additionalContext': '''$CONTEXT'''
  }
}))
"

💡 Novo projeto = nova pasta

mkdir ~/.memory/projects/novo-proj + seed context.md. Hook pega automatico.

🌿 Por git branch

Features longas ganham com memoria por branch. Estado da feature isolado do main.

📐 Routing por branch

# Hook detecta branch atual
BRANCH=$(cd "$CWD" && git branch --show-current 2>/dev/null)
PROJ=$(basename "$CWD")

# Prioridade: branch especifico > projeto > global
BRANCH_CTX="$HOME/.memory/projects/$PROJ/branches/$BRANCH.md"
PROJ_CTX="$HOME/.memory/projects/$PROJ/context.md"
DEFAULT_CTX="$HOME/.memory/context.md"

if [[ -f "$BRANCH_CTX" ]]; then
  OVERLAY=$(cat "$BRANCH_CTX")
elif [[ -f "$PROJ_CTX" ]]; then
  OVERLAY=$(cat "$PROJ_CTX")
elif [[ -f "$DEFAULT_CTX" ]]; then
  OVERLAY=$(cat "$DEFAULT_CTX")
fi

# Trabalhando em feature/new-auth? Claude ja sabe estado daquela feature.
# Switch pra main? Memoria troca automaticamente.

💡 Uso em projetos de longo ciclo

Feature de 2 meses? Branch-scoped context registra decisoes da feature sem poluir main.

🧑‍💼 Por agente/papel

Um humano pode alternar papeis: comms, coder, writer. Cada papel com prime.md proprio.

📐 Profiles por role

~/.memory/
├── prime.md                    (base global)
└── profiles/
    ├── comms/
    │   └── prime.md            (estilo para emails, Slack)
    ├── coder/
    │   └── prime.md            (stack tecnica)
    └── writer/
        └── prime.md            (tom publico, evita jargao)

# Hook le env var CLAUDE_ROLE
ROLE="${CLAUDE_ROLE:-coder}"  # default coder
ROLE_PRIME="$HOME/.memory/profiles/$ROLE/prime.md"

if [[ -f "$ROLE_PRIME" ]]; then
  BASE=$(cat "$ROLE_PRIME")
else
  BASE=$(cat ~/.memory/prime.md)
fi

# Usar
$ CLAUDE_ROLE=comms claude
  → Claude carrega perfil comms
$ CLAUDE_ROLE=writer claude
  → Claude carrega perfil writer

💡 Alias pra fluidez

alias claude-comms='CLAUDE_ROLE=comms claude'. Um comando por papel.

🔀 Fallback e heranca

Base sempre, overlay quando existe. Identidade nao precisa repetir por projeto.

🧩 Cadeia de heranca

Ordem de merge:

•Nivel 0: ~/.memory/prime.md (identidade permanente)
•Nivel 1: profile/$ROLE/prime.md (se ROLE definido)
•Nivel 2: projects/$PROJ/context.md (se em projeto conhecido)
•Nivel 3: projects/$PROJ/branches/$BRANCH.md (se em feature branch)
•Resultado: concatenacao de todos existentes

🎛️ Override manual

Escape hatch para casos excepcionais. Forçar profile nao-inferido.

📐 Override via env var

# Forçar perfil especifico
$ CLAUDE_MEMORY_PROFILE=writer claude
  → ignora routing automatico, usa perfil writer

# Forçar projeto especifico
$ CLAUDE_MEMORY_PROJECT=legacy-system claude
  → usa memoria do projeto legacy mesmo se cwd for outro

# Combinar
$ CLAUDE_MEMORY_PROFILE=comms CLAUDE_MEMORY_PROJECT=payments claude
  → comms context + projeto payments

# No hook:
PROFILE="${CLAUDE_MEMORY_PROFILE:-$(infer_profile)}"
PROJECT="${CLAUDE_MEMORY_PROJECT:-$(infer_project "$CWD")}"

💡 Use com cautela

Override manual e poder. Abuse dele e voce perde o beneficio do routing automatico. Reserve pra casos reais.

🧪 Lab: multi-projeto

Exercicio ativo. Valide o routing antes de depender.

Setup

Crie 3 pastas em ~/projects/: {proj-a, proj-b, proj-c}. Crie 3 context.md diferentes em ~/.memory/projects/{proj-a,proj-b,proj-c}/.

Sessao em proj-a

cd ~/projects/proj-a && claude. Pergunte 'qual projeto ativo?'. Resposta deve mencionar proj-a.

Sessao em proj-b

Mesma coisa, outro projeto. Resposta deve trocar.

Proj-c (sem memoria especifica)

Deve cair no fallback do context.md global.

Validar isolamento

Pergunta sobre proj-a dentro de sessao de proj-b? Claude nao deve saber, provando isolamento.

💡 Teste real

Sem teste, voce acha que funciona. Com teste, voce sabe. Invista 15 minutos — vai usar diariamente.

📝 Resumo do Modulo

✓

Routing por cwd e padrao — detecta projeto pelo diretorio.

✓

Branch scope isola features — util em trabalhos longos.

✓

Role profiles — comms, coder, writer com style proprio.

✓

Heranca evita duplicacao — base + overlay.

Proximo:

6.6 — Metricas e evolucao continua

← Modulo anterior Proximo Modulo →