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
Todos os comandos instalados com descrição. Copie e cole.
📊 GSD — Sessão & Projeto
/gsd-progress
Estado atual do projeto: feito, em andamento, bloqueado. Use sempre no início de sessão./gsd-next
Próxima ação prioritária: o que fazer agora com base no plano./gsd-health
Health check geral: testes, dívida técnica, blockers e riscos./gsd-new-project
Inicializa novo projeto do zero com roadmap, fases e estrutura .planning/./gsd-new-milestone
Cria novo milestone dentro de um projeto existente./gsd-do
Executa uma task específica diretamente sem criar fase ou plano./gsd-ship
Processo completo de ship: review → fix → commit → deploy → verify./gsd-discuss-phase
Discute abordagem e assumptions antes de planejar a fase. Evita planos errados./gsd-map-codebase
Mapeia e documenta a estrutura, arquitetura e padrões do codebase./gsd-docs-update
Atualiza documentação do projeto com base nas mudanças recentes.🗺️ GSD — Planejar & Executar
/gsd-plan-phase
Cria PLAN.md executável com tasks, dependências e critérios de sucesso./gsd-execute-phase [n]
Executa o PLAN.md com commits atômicos, checkpoints e gates de qualidade./gsd-ui-phase
Fase especializada para UI: gera UI-SPEC.md, valida design, implementa com padrões visuais./gsd-secure-phase
Fase especializada para segurança: STRIDE threat model + auditoria de mitigações./gsd-add-tests
Adiciona testes para código existente sem cobertura./gsd-research-phase
Pesquisa a abordagem técnica antes de criar o plano. Gera RESEARCH.md./gsd-discovery-phase
Discovery de projetos brownfield: mapeia débito técnico e codebase existente./gsd-validate-phase
Valida se a fase cumpriu os objetivos antes de fechar./gsd-audit-milestone
Audita o milestone: coverage, integração E2E e gaps antes de fechar./gsd-complete-milestone
Fecha o milestone com summary, atualiza ROADMAP.md e STATE.md.🔬 GSD — Debug & Qualidade
/gsd-debug
Debug científico multi-ciclo: hipótese → evidência → fix. Evita loops de 2 dias./gsd-code-review
Auditoria completa do código. Gera REVIEW.md com Critical / High / Medium / Low./gsd-code-review-fix
Aplica automaticamente os fixes do REVIEW.md com commits atômicos por finding./gsd-verify-work
Verifica se a fase entregou o objetivo real (análise goal-backward). Use antes de Done./gsd-ui-review
Auditoria de UI em 6 pilares: layout, cores, tipografia, acessibilidade, responsividade, UX./gsd-scan
Scan de issues, bugs e dívida técnica no codebase atual./gsd-forensics
Análise forense de bugs: git history, diff, side-effects e root cause./gsd-audit-fix
Auditoria + correção automática em sequência: detecta e resolve numa passagem./gsd-diagnose-issues
Diagnóstico estruturado de problemas: reproduz, isola e propõe fix./gsd-cleanup
Remove código morto, arquivos obsoletos e imports não usados.⚡ Superpowers Skills
/systematic-debugging
Framework de debug metódico: root-cause tracing, defense-in-depth, condition-based waiting./brainstorm
Brainstorming visual com artefatos estruturados. Ideal para explorar ideias antes de planejar./write-plan
Escreve plano de implementação detalhado com tasks, riscos e critérios./execute-plan
Executa um plano existente passo a passo com verificação após cada task./requesting-code-review
Prepara contexto e solicita code review de forma estruturada./receiving-code-review
Processa feedback de code review: triagem por severidade, plano de fix./test-driven-development
TDD guiado: red → green → refactor com anti-patterns e boas práticas./subagent-driven-development
Desenvolvimento com subagentes paralelos: spec → implement → quality review./verification-before-completion
Checklist de verificação antes de concluir qualquer task. Evita entregas incompletas./using-git-worktrees
Trabalha em múltiplas branches simultâneas sem stash/checkout constante./finishing-a-development-branch
Finaliza branch: cleanup, review, squash e merge com checklist completo./dispatching-parallel-agents
Despacha múltiplos agentes em paralelo para tasks independentes. Multiplica velocidade.🛠️ Skills Auto-Ativadas
Estas não são slash commands — Claude as ativa automaticamente quando você descreve a tarefa. Ex: "cria um Word doc" ativa a skill docx. Copie a frase de ativação para usar.
"testa o UI com playwright"
webapp-testing — golden path + edge cases + screenshots."cria um Word doc / .docx"
docx — cria, edita e extrai conteúdo de documentos Word com estilos."cria uma planilha Excel / .xlsx"
xlsx — planilhas com fórmulas, tabelas e gráficos."cria uma apresentação .pptx"
pptx — apresentações PowerPoint com layouts e temas."gera um PDF / lê este PDF"
pdf — extrai conteúdo e gera documentos PDF com formulários."cria um MCP server"
mcp-builder — constrói MCP servers (Node.js ou Python) com boas práticas."cria um skill personalizado"
skill-creator — analisa, escreve, testa e avalia novos skills."usa a Anthropic API / Claude API"
claude-api — streaming, tool use, batches, Agent SDK em Python/TS."faz um design de UI / frontend"
frontend-design — componentes, responsividade e padrões visuais."cria um artefato web HTML/CSS/JS"
web-artifacts-builder — artefatos web inline sem criar arquivos."faz um GIF para Slack"
slack-gif-creator — GIFs animados otimizados para Slack.⚙️ Comandos Rápidos
/commit-push-pr
Commit convencional + push + abre PR no GitHub em sequência. Um comando, tudo feito./commit
Commit convencional (feat/fix/chore) com mensagem estruturada. Sem push./code-review
Review rápido de código. Sem gerar artefatos — só feedback direto no chat./review-pr
Review de Pull Request existente no GitHub: diff, contexto e feedback./feature-dev
Ciclo completo de feature: spec → implement → test → commit./hookify
Cria e configura hooks do Claude Code (PreToolUse, PostToolUse, Stop, etc.)./hookify-configure
Edita configuração de um hook existente no settings.json./hookify-list
Lista todos os hooks configurados: escopo, evento, comando e status.🤖 Agentes AIOX
@dev
Implementação de código: features, bug fixes, refactoring. Pode commit mas não push.@qa
Quality assurance: testes, revisão de código, gates de qualidade. PASS / FAIL / CONCERNS.@architect
Arquitetura de sistema, decisões de tecnologia e padrões de integração.@pm
Product management: épicos, specs, requirements e orquestração de entregas.@po
Product Owner: valida stories com checklist de 10 pontos. GO (≥7) ou NO-GO.@sm
Scrum Master: cria stories a partir de épicos com acceptance criteria claros.@analyst
Pesquisa e análise: benchmarks, relatórios, dados de mercado e competitor research.@data-engineer
Banco de dados: schema DDL, queries otimizadas, RLS policies, migrations.@ux-design-expert
UX/UI design: flows, wireframes, design system, acessibilidade e usabilidade.@devops
EXCLUSIVO para git push, gh pr create, CI/CD e gerenciamento de MCPs.@aiox-master
Governança do framework AIOX. Pode executar qualquer task. Override de limites.🔌 MCPs Disponíveis
mcp__context7__resolve-library-id
Resolve o ID de uma biblioteca para usar no get-library-docs. Ex: "react", "supabase".mcp__context7__get-library-docs
Busca documentação atualizada de qualquer lib. Evita alucinações de API stale.mcp__claude_ai_Cloudflare_Developer_Platform__d1_database_query
Query direta no D1 do Orbitaapp sem abrir o dashboard Cloudflare.mcp__playwright__browser_navigate
Navega para uma URL no browser automatizado. Base do /webapp-testing.mcp__playwright__browser_take_screenshot
Screenshot da página atual. Claude vê visualmente o que está renderizando.mcp__claude_ai_Canva__generate-design
Gera design no Canva via IA a partir de descrição. Exporta pronto para usar.mcp__claude_ai_Gmail__search_threads
Busca threads de email no Gmail por query. Lê e cria rascunhos sem abrir browser.mcp__claude_ai_Google_Calendar__list_events
Lista eventos do calendário. Cria, atualiza e sugere horários disponíveis.mcp__claude_ai_Google_Drive__search_files
Busca, lê e cria arquivos no Google Drive. Acessa Docs, Sheets, Slides.mcp__claude_ai_Slack__slack_send_message
Envia mensagem no Slack. Lê canais, threads, perfis e agenda mensagens.mcp__claude_ai_n8n__create_workflow_from_code
Cria workflows de automação no n8n via código. Integra qualquer serviço.mcp__claude_ai_Gamma__generate
Gera apresentações, docs e páginas web no Gamma.app com IA.mcp__claude_ai_Make__scenarios_run
Executa cenários de automação no Make.com. Cria, edita e monitora fluxos.mcp__claude_ai_Fathom__get_meeting_summary
Resumo e transcrição de reuniões gravadas pelo Fathom. Busca por participante ou data.mcp__nano-banana__generate_image
Gera imagens com IA (Gemini). Edita e continua gerações existentes.gh issue list --state open
GitHub CLI: lista issues, cria PRs, vê CI status. Pré-aprovado no Orbitaapp.✅ 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