oimpresso-team-onboarding

name: oimpresso-team-onboarding description: Configura ou valida acesso ao MCP server da empresa oimpresso (Wagner/Felipe/Maiara/Luiz/Eliana). Ativa quando dev novo abre Claude Code pela 1ª vez no projeto, ou quando user pede "setup MCP", "configurar acesso à memória do time", "entrar no MCP server oimpresso", "conectar Claude Code ao oimpresso". Também guia Wagner pra adicionar dev novo ao time. Gera/valida .claude/settings.local.json automaticamente. allowed-tools: Read, Write, Edit, Bash, WebFetch, mcp__oimpresso__* trust_level: L2 owner: wagner parent_mission: meta-skill-roi-erp-autonomo charter_adr: 0080 tier: C parent_adr: 0095

Skill — Onboarding Claude Code do time oimpresso

Quando ativar: dev abre Claude Code no repo D:\oimpresso.com (ou clone) e o MCP server "oimpresso" não está respondendo, ou o user pede explicitamente "configurar MCP/memória" / "setup oimpresso".

Contexto canônico

• MCP server URL: https://mcp.oimpresso.com/api/mcp
• Admin console: https://oimpresso.com/copiloto/admin/team (Wagner gera tokens)
• ADR: memory/decisions/0056-mcp-fonte-unica-memoria-copiloto-claude-code.md
• Doc longo: MEMORY_TEAM_ONBOARDING.md

1. Diagnóstico rápido (antes de tudo)

Quando ativar, primeiro verifique o estado atual:

# 1. Está em algum projeto oimpresso?
test -f CLAUDE.md && grep -l "oimpresso ERP" CLAUDE.md
# 2. Tem .mcp.json no root?
test -f .mcp.json && cat .mcp.json
# 3. Tem .claude/settings.local.json com token?
test -f .claude/settings.local.json && grep -c "Bearer mcp_" .claude/settings.local.json

Decida o caminho:

2. Modo A — Dev novo (primeira vez)

Olá! Você está abrindo o oimpresso pela primeira vez. Vou te conectar ao MCP server
do time em 3 passos rápidos.

PASSO 1 — Pegar seu token MCP pessoal
   Wagner já te enviou um token via Vaultwarden? (algo tipo "mcp_abc123...")
   - Se sim: cola aqui
   - Se não: avisa o Wagner pra gerar pra você em
     https://oimpresso.com/copiloto/admin/team

Se o user colar o token (mcp_<hex>):

1. Cria .claude/settings.local.json com Write tool:

   {
     "mcpServers": {
       "oimpresso": {
         "url": "https://mcp.oimpresso.com/api/mcp",
         "headers": { "Authorization": "Bearer mcp_<TOKEN_DO_DEV>" }
       }
     }
   }
   

2. Valida chamando o MCP:

   curl -s -X POST https://mcp.oimpresso.com/api/mcp \
     -H "Content-Type: application/json" \
     -H "Accept: application/json, text/event-stream" \
     -H "Authorization: Bearer <TOKEN>" \
     -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | head -c 200
   

3. Se HTTP 200 + tools listadas:

   ✅ Conectado! Você tem acesso a (entre outras):
   - cycles-active / cycle-goals-track → cycle vigente + goals
   - my-work / my-inbox / triage       → suas tasks + caixa de entrada
   - tasks-list / tasks-detail         → backlog filtrável + detalhe
   - tasks-create / tasks-update / tasks-comment → CRUD de tasks
   - decisions-search / decisions-fetch → ADRs (Nygard)
   - sessions-recent                    → últimos session logs
   - memoria-search                     → memória persistente Copiloto
   - claude-code-usage-self             → seu próprio uso/custo
   
   Pra começar, te recomendo:
   1. Ler CLAUDE.md (orientação geral)
   2. Ler memory/08-handoff.md (estado canônico)
   3. Pedir "my-work" pra ver suas tasks ativas
   
   Reinicia Claude Code pra carregar a config (Ctrl+C + abrir de novo).
   

4. Se HTTP 401: token errado — peça pra confirmar com Wagner

5. Se HTTP 403: token OK mas sem permissão — Wagner precisa atribuir copiloto.mcp.use na role do user

6. Se timeout/connection refused: MCP server pode estar com problema — checar status em https://mcp.oimpresso.com/api/mcp/health

3. Modo B — Token errado (placeholder não substituído)

User esqueceu de colar token real:

Vi que seu .claude/settings.local.json ainda tem o placeholder.
Cola aqui o token que o Wagner te enviou (começa com "mcp_")

Edita o arquivo com Edit tool, troca mcp_COLE_SEU_TOKEN_AQUI pelo real, valida.

4. Modo C — Validar/debugar

MCP não responde. Roda diagnóstico:

# 1. DNS resolve?
nslookup mcp.oimpresso.com
# 2. HTTPS responde?
curl -fsS https://mcp.oimpresso.com/api/mcp/health
# 3. Token tá correto no settings?
grep "Bearer mcp_" .claude/settings.local.json
# 4. Health autenticado funciona?
curl -fsS https://mcp.oimpresso.com/api/mcp/health/auth \
  -H "Authorization: $(grep -o 'Bearer mcp_[a-z0-9]*' .claude/settings.local.json)"

Reporta o que falhou + sugere fix.

5. Modo Wagner — adicionar dev novo ao time

Se o user é o Wagner (verificar via git config user.email == "wagnerra@gmail.com"):

Vou ajudar você a adicionar [Felipe/Maiara/Luiz/Eliana] ao time.

PASSO 1 — Gerar token MCP novo
  Eu posso gerar via comando? (sim/não)
  - sim: rodo `php artisan copiloto:mcp:system-token --user-email=<email>`
  - não: você abre /copiloto/admin/team manualmente, clica "+ Token" do dev,
         e me cola o token de volta

PASSO 2 — Entregar token via canal seguro
  - Vaultwarden (recomendado)
  - WhatsApp criptografado
  - NÃO: email plain, slack público

PASSO 3 — Comunicar setup pro dev
  Mando o link MEMORY_TEAM_ONBOARDING.md + token via VW. Dev:
    git clone https://github.com/wagnerra23/oimpresso.com
    cd oimpresso.com
    cp .claude/settings.local.json.example .claude/settings.local.json
    # edita o arquivo, cola token
    claude  # abre Claude Code

PASSO 4 — Validar (quando dev confirmar setup)
  Wagner abre /copiloto/admin/team — ver se "último uso MCP" do dev preenche

6. Quando watcher MEM-CC-1 estiver pronto (Sprint B)

Após Sprint A funcionar, oferece:

Quer também sincronizar suas memórias locais (~/.claude/projects/) com o servidor?
Isso permite que o Wagner consulte cross-dev "como Felipe resolveu X".

Pra ativar:
  cd scripts/cc-watcher
  npm install
  npm start &  # roda em background
  # ou instala como serviço (--service install)

7. Comandos úteis (reference card)

# Ver tools disponíveis no MCP
mcp tools list

# Pedir ADR específica
mcp call decisions-fetch --slug=0046-chat-agent-gap

# Pedir estado vivo do cycle
mcp call cycles-active

# Pedir minhas tasks
mcp call my-work

# Buscar memória semântica
mcp call memoria-search --query="meta de faturamento"

# Ver custo seu próprio uso
mcp call claude-code-usage-self

8. Troubleshooting

9. Confirmação final

Antes de finalizar a skill, verifica que:

• .claude/settings.local.json existe + token real (sem placeholder)
• tools/list retorna ≥6 tools
• tools/call cycles-active funciona (response não-vazio)
• Skills auto-ativáveis (multi-tenant-patterns, publication-policy) carregam
• Dev sabe que precisa reiniciar Claude Code 1× pra config carregar

Reporta:

✅ Setup completo. Você tem acesso ao MCP server do time.
Próximo: reinicia Claude Code e pergunta "cycles-active" + "my-work" pra ver o que tá rolando.

10. Setup ~/.claude/oimpresso-local/ — zona pessoal (ADR 0131)

Após o setup MCP completar (passos 1-9), orientar o dev a criar a zona pessoal dele — onde mora config de máquina, TODO pessoal e refs pro Vaultwarden.

Última coisa: você precisa de um lugar pra coisa SUA (path da sua máquina, monitor,
TODO pessoal, atalhos IDE) que não vai pro git nem pro MCP. ADR 0131 define isso.

PASSO 1 — Criar a pasta (PowerShell):
   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.claude\oimpresso-local"

PASSO 2 — Eu vou copiar pra você o README mínimo que explica o sistema 3-tiers:
   (Cópia de .claude/skills/oimpresso-team-onboarding/_oimpresso-local-readme-template.md
    pro destino acima, ajustando refs pro repo)

PASSO 3 — (opcional, recomendado) Backup via OneDrive/Dropbox:
   Wagner usa OneDrive. Felipe/Maiara/Luiz/Eliana — confirmem qual cloud já usam
   pra documentos pessoais e movam a pasta pra lá com symlink.

REGRA EM 1 LINHA:
   Segredo? → Vaultwarden (vault.oimpresso.com)
   Só meu? → ~/.claude/oimpresso-local/
   Time precisa ver? → memory/ no git → MCP

Após dev confirmar criação, valida com:

test -d "$HOME/.claude/oimpresso-local" && test -f "$HOME/.claude/oimpresso-local/README.md"

Atenção ao hook: .claude/hooks/block-automem.ps1 (ADR 0061 + 0131) bloqueia Write em ~/.claude/projects/*/memory/*.md (auto-mem legada) mas permite Write em ~/.claude/oimpresso-local/**. Se o dev tentar criar arquivo no path errado, hook explica os 3 tiers.

Referências:

• ADR 0131 — tiering canônico
• ADR 0061 — base proibindo auto-mem privada (refinada por 0131)

11. Setup Delphi/SVN READ-ONLY — OPCIONAL (Felipe atualmente)

Se o dev vai trabalhar com legacy Delphi WR Comercial / clientes Firebird (atualmente só Felipe, Wagner aprovou 2026-05-27):

Você vai precisar mexer com Delphi/SVN legacy? (Felipe = sim por default;
Maiara/Eliana/Luiz = perguntar Wagner antes)

Se sim:
  Runbook completo em memory/reference/setup-delphi-svn-time.md
  Passos resumidos:
    1. winget install Slik.Subversion  (svn.exe CLI)
    2. Resolver acesso à rede (3 opções no runbook):
       a) ir à empresa primeira vez (LAN resolve wr2.com.br direto), OU
       b) Tailscale (futuro, se Wagner aprovar setup), OU
       c) hosts file: `177.74.67.30  wr2.com.br` (cuidado: sobrescreve
          DNS público — confirmar com Wagner)
    3. svn checkout http://wr2.com.br:8777/svn/Programas/Trunk D:\Programas
       (pode demorar horas — overnight é seguro)
    4. Credenciais SVN: pegar com Wagner via Vaultwarden
  Regra de uso: READ-ONLY (Claude NÃO comita SVN — ver
  memory/reference/feedback-commits-delphi-svn.md)

Referência: setup-delphi-svn-time.md (Felipe roda passo-a-passo, ~horas de checkout inicial).