Claude Code Mastery — Orbitaapp
Você tem 169+ skills, 12 MCPs, 3 hooks e 80+ agentes configurados.
Está usando ~10% do poder disponível. Este sistema vai mudar isso em 10 dias.
0
MCPs Críticos Faltando
8
Skills de Alto Impacto não Usadas
12
MCPs Conectados
169+
Skills Disponíveis
🔴 Ação Imediata — CLAUDE.md do Orbitaapp não existe.
Este é o motivo #1 de você perder contexto toda sessão e gastar 15-20min se re-apresentando ao Claude. Crie hoje.
Este é o motivo #1 de você perder contexto toda sessão e gastar 15-20min se re-apresentando ao Claude. Crie hoje.
⚠️ Você gastou 2 dias na Fase 10 com erros repetidos.
/gsd-debug + /webapp-testing + Playwright MCP teriam resolvido em 2 horas. Estes 3 tools são o maior leverage que você tem agora.
🎯 Top 10 Ações — Maior ROI Agora
📅 Trilha de Treinamento — 10 Dias
30-45 minutos por dia. Foco no que gera resultado imediato no Orbitaapp.
📄 CLAUDE.md — Contexto Permanente
O CLAUDE.md é carregado automaticamente no início de CADA sessão. É como um briefing permanente para o Claude sobre quem você é e o que está construindo. Sem ele, você re-explica tudo toda sessão.
🔴 Orbitaapp não tem CLAUDE.md de projeto. Crie agora em
c:\aios-test\Orbitaapp\.claude\CLAUDE.md
Os 3 Níveis de CLAUDE.md
| Nível | Arquivo | O que define | Status |
|---|---|---|---|
| Global | C:\Users\vboxuser\.claude\CLAUDE.md |
Identidade do Renato, output routing XX_VM, regras de segurança, 1Password | ✓ Existe |
| Workspace | c:\aios-test\.claude\CLAUDE.md |
Framework Synkra AIOX, regras de agentes, git conventions | ✓ Existe |
| Projeto | c:\aios-test\Orbitaapp\.claude\CLAUDE.md |
Tech stack Orbitaapp, fase atual, URLs, padrões JWT, bugs conhecidos | 🔴 CRIAR AGORA |
O que colocar no CLAUDE.md do Orbitaapp
1
Tech Stack (para Claude nunca perguntar)
Next.js 14 App Router, Supabase, Clerk Auth, Cloudflare Workers, D1 Database, Stripe
2
URLs de produção e staging
app.orbitaapp.fit (prod), orbitaapp.fit (landing). Claude vai usar para testes automáticos.
3
Fase atual e status
Ex: "Fase 10 smoke test em andamento. Fase 14 (push notifications) é a próxima."
4
Padrões críticos de código
Ex: "JWT MUST use getToken(skipCache:true) após metadata write. Clerk JWT template tem couple_id."
5
Regras de deploy
Sequência correta de deploy: testes → wrangler deploy worker → pages deploy landing
Template Inicial — Cole no arquivo
# Orbitaapp — Contexto do Projeto
## Tech Stack
- Frontend: Next.js 14 App Router (TypeScript)
- Auth: Clerk (JWT template: couple_id em public_metadata)
- Database: Supabase (PostgreSQL + RLS)
- Edge: Cloudflare Workers + D1 (worker auth via Clerk JWT)
- Payments: Stripe
- Landing: Astro (orbitaapp.fit)
## URLs
- Prod app: https://app.orbitaapp.fit
- Prod landing: https://orbitaapp.fit
- Worker: verificar wrangler.toml
## Estado Atual (atualizar a cada fase)
- Fase 10: smoke test EMAIL-02 em andamento, EMAIL-03/04/05 pendentes
- Fase 14: push notifications — planejada, não iniciada
## Padrões Críticos
- JWT: SEMPRE usar getToken({skipCache:true}) após qualquer metadata write
- Clerk JWT template deve ter: {"couple_id":"{{user.public_metadata.couple_id}}"}
- Worker retorna 403 se JWT não tiver couple_id
## Workflow de Debug Padrão
1. /gsd-progress (entender o estado atual)
2. /gsd-debug (debugging científico)
3. /gsd-code-review (auditoria)
4. /gsd-verify-work (verificar objetivo)
## Workflow de Início de Sessão
- SEMPRE começar com: /gsd-progress
## Credenciais
- NUNCA pedir chaves no chat. Usar: op read "op://vault/item/field"
⚡ Skills — O Arsenal
Você tem 169+ skills. Os 8 abaixo geram 80% do resultado no Orbitaapp. Aprenda-os primeiro.
Insight chave: Skills são como "prompts pré-programados com agentes especializados". Em vez de você escrever um prompt longo toda vez, um skill já carrega o contexto certo, usa os agentes corretos e segue um processo validado.
🔌 MCPs — Ferramentas Externas
MCPs são integrações que dão ao Claude acesso a serviços externos: browser, banco de dados, Cloudflare, etc. Você tem 12. Os 3 críticos foram configurados na Phase 1.
✅ MCPs críticos instalados: context7 instalado (Phase 1). Acesso ao D1 via Cloudflare MCP + d1_database_query. GitHub via gh CLI patterns (gh issue list, gh run list, gh pr view).
Como Instalar MCPs Faltando
context7 — Documentação de Bibliotecas em Tempo Real
Elimina usar docs desatualizadas. O Claude vai saber exatamente como usar Next.js, Clerk, Supabase hoje.
claude mcp add context7 -- npx -y @upstash/context7-mcp@latest
Cloudflare D1 — Banco no Claude
Acesso ao banco D1 do Orbitaapp via Cloudflare MCP já instalado. Adicione a permissão d1_database_query no settings.json do projeto.
mcp__claude_ai_Cloudflare_Developer_Platform__d1_database_query
GitHub — gh CLI no Claude
PRs, issues e CI/CD via gh CLI pré-aprovado no settings.json do Orbitaapp. Sem MCP separado necessário.
gh issue list --state open
MCPs que Você Tem (e não está usando)
| MCP | O que faz | Como ativar | Prioridade |
|---|---|---|---|
| playwright | Testa UI no browser, tira screenshots, verifica console | mcp__playwright__browser_navigate |
CRÍTICO |
| Cloudflare | Deploy de Workers, D1 database, Pages | mcp__claude_ai_Cloudflare_Developer_Platform__* |
CRÍTICO |
| n8n | Criar e gerenciar workflows de automação | mcp__claude_ai_n8n__* |
ALTA |
| Make.com | Automações de marketing e vendas PROX | mcp__claude_ai_Make__* |
ALTA |
| Gmail | Ler emails, criar drafts, analisar suporte | mcp__claude_ai_Gmail__* |
MÉDIA |
| Slack | Alertas automáticos, comunicação equipe | mcp__claude_ai_Slack__* |
MÉDIA |
| Fathom | Transcrições de calls com clientes | mcp__claude_ai_Fathom__* |
MÉDIA |
| Google Drive | Criar e buscar arquivos no XX_VM | mcp__claude_ai_Google_Drive__* |
MÉDIA |
| Gamma | Apresentações e demos do Orbitaapp | mcp__claude_ai_Gamma__* |
MÉDIA |
🪝 Hooks — Automação Silenciosa
Hooks são scripts que executam automaticamente em eventos específicos do Claude. Você já tem 3 configurados. 2 faltam e seriam muito úteis.
ℹ️ Como hooks funcionam: Você não precisa fazer nada. Eles executam sozinhos. O synapse-engine injeta contexto antes de todo prompt. O code-intel injeta informações antes de editar arquivos. O digest captura o estado antes da compactação.
Hooks Ativos
🔄 synapse-engine
Ativo
Evento: UserPromptSubmit
O que faz: Injeta contexto de regras antes de todo prompt. Você nunca vê — funciona em background.
Valor: Consistência de comportamento entre sessões.
O que faz: Injeta contexto de regras antes de todo prompt. Você nunca vê — funciona em background.
Valor: Consistência de comportamento entre sessões.
🧠 code-intel-pretool
Ativo
Evento: PreToolUse (Write/Edit)
O que faz: Antes de editar qualquer arquivo, injeta contexto de dependências e entidades relacionadas.
Valor: Claude edita com mais precisão porque sabe o contexto do arquivo.
O que faz: Antes de editar qualquer arquivo, injeta contexto de dependências e entidades relacionadas.
Valor: Claude edita com mais precisão porque sabe o contexto do arquivo.
📸 session-digest
Ativo
Evento: PreCompact
O que faz: Captura resumo da sessão antes do contexto ser comprimido.
Valor: Evita perda de progresso em sessões longas (como suas sessões de debug da Fase 10).
O que faz: Captura resumo da sessão antes do contexto ser comprimido.
Valor: Evita perda de progresso em sessões longas (como suas sessões de debug da Fase 10).
Hooks para Criar (alto impacto)
Post-Commit Hook
CRIAR
Executa após
Como criar: Use o skill
git commit. Poderia rodar testes automaticamente, atualizar STATE.md, enviar notificação no Slack.Como criar: Use o skill
/update-config
Configurar um hook PostToolUse que execute
após Bash(git commit) para rodar npm test
e atualizar o STATE.md com o que foi feito.
Stop Hook (resumo de sessão)
CRIAR
Executa quando Claude termina de responder. Poderia gerar um resumo do que foi feito e próximos passos automaticamente.
Como criar: Use o skill
Como criar: Use o skill
/update-config
Configurar um Stop hook que gere um resumo
de 1 linha do que foi feito e salve no
STATE.md após cada resposta.
🤖 Agentes & Squads
Você tem 80+ agentes especializados. Cada um com persona, autoridade e foco específico. A maioria está sendo ignorada.
Como ativar um agente: Digite
/AIOX:agents:dev ou @dev no chat. O agente vai assumir o contexto da conversa e aplicar sua especialidade.
AIOX Core — Para o Orbitaapp
| Agente | Persona | Usa quando | Como ativar |
|---|---|---|---|
| @dev (Dex) | Implementador | Implementar stories, escrever código | @dev |
| @qa (Quinn) | QA | Revisar qualidade antes de declarar Done | @qa |
| @architect (Aria) | Arquiteto | Decisões de arquitetura, tech selection | @architect |
| @pm (Morgan) | Product Manager | Criar epics, definir requirements | @pm |
| @sm (River) | Story Manager | Criar stories a partir de epics/PRDs | @sm |
| @po (Pax) | Product Owner | Validar stories (10-point checklist) | @po |
| @ux-design-expert (Uma) | UX Designer | Design de interfaces, UX research | @ux-design-expert |
| @devops (Gage) | DevOps | git push, PR, CI/CD — EXCLUSIVO para push | @devops |
Squads de Alto Valor para o Orbitaapp
💰 Hormozi Squad
Framework $100M Offers aplicado ao Orbitaapp. Use para: pricing, offer design, estratégia de growth, retenção de usuários.
/squads:hormozi-squad:hormozi-advisor
🎨 Design Squad
Brad Frost, Dan Mall, design systems. Use para: decisões de UI/UX, design system do app, feedback em interfaces.
/squads:design-squad:design-chief
📝 Copy Squad
28 mestres do copywriting. Use para: onboarding copy, emails de retenção, landing page do Orbitaapp.
/squads:copy-squad:copy-chief
🏛️ Advisory Board
Naval, Dalio, Sivers, etc. Use para: decisões estratégicas sobre o futuro do Orbitaapp como produto.
/squads:advisory-board:board-chair
🔄 Workflows — Processos Padrão
Sequências de skills que resolvem problemas recorrentes. Você não tem nenhum documentado. Isso é por que os mesmos erros se repetem.
🔴 Root cause da Fase 10 (2 dias perdidos): Você não tinha um processo padrão de debug. Cada sessão reiniciava do zero sem metodologia. Os 3 workflows abaixo eliminam isso permanentemente.
Workflow 1 — Início de Sessão (obrigatório)
Use todo dia antes de qualquer coisa:
# 1. Ver estado atual do projeto
/gsd-progress
# 2. Ver o que está em memória (contexto persistente)
Ver MEMORY.md em C:\Users\vboxuser\.claude\projects\c--aios-test-Orbitaapp\memory\
# 3. Próximo passo
/gsd-next
Tempo: ~2 minutos. Elimina 15-20 minutos de re-contexto toda sessão.
Workflow 2 — Debug (quando travar)
Ative quando o mesmo erro se repetir por 30min:
# 1. Contexto atual
/gsd-progress
# 2. Debug científico (hipótese → teste → evidência)
/gsd-debug
# 3. Auditoria do código após o fix
/gsd-code-review
# 4. Verificar se o objetivo foi atingido
/gsd-verify-work
# 5. Se for bug de UI, testar no browser
/webapp-testing
Este workflow teria resolvido a Fase 10 em 2 horas em vez de 2 dias.
Workflow 3 — Deploy Seguro
# 1. Rodar testes
npm test (ou equivalente)
# 2. Testar UI com playwright
/webapp-testing
# 3. Code review antes de commitar
/gsd-code-review
# 4. Commit com mensagem convencional
/commit-push-pr
# 5. Deploy Cloudflare (worker)
npx wrangler deploy
# 6. Deploy landing (se mudou)
npx wrangler pages deploy
# 7. Verificar em produção com playwright
mcp__playwright__browser_navigate → https://app.orbitaapp.fit
📋 Cheatsheet — Referência Rápida
Tudo que você precisa em um lugar. Copie e cole.
🚀 Skills de Debug
/gsd-debug
/gsd-code-review
/gsd-code-review-fix
/gsd-verify-work
/systematic-debugging
/webapp-testing
📊 Skills de Projeto
/gsd-progress
/gsd-next
/gsd-health
/gsd-plan-phase
/gsd-execute-phase 10
/gsd-verify-work
🤖 Agentes AIOX
@dev — implementação
@qa — quality assurance
@architect — arquitetura
@devops — git push / PR
🔌 MCPs Configurados (Phase 1)
mcp__context7__resolve-library-id + get-library-docs
mcp__claude_ai_Cloudflare_Developer_Platform__d1_database_query
gh issue list --state open
✅ Checklist Diário — Hábitos de Alto Impacto
Use toda sessão de trabalho. Progresso salvo localmente.
🌅 Início de Sessão
🔨 Durante o Trabalho
🌙 Fim de Sessão