Skip to content

Instantly share code, notes, and snippets.

@gabrielbuzziv

gabrielbuzziv/SuperClaudeDocs.md

Created June 24, 2025 16:19
Show Gist options

  • Select an option

    Learn more about clone URLs
  • Save gabrielbuzziv/69e07e72d7b1870729194573ef447b34 to your computer and use it in GitHub Desktop.

Select an option

Learn more about clone URLs
Save gabrielbuzziv/69e07e72d7b1870729194573ef447b34 to your computer and use it in GitHub Desktop.
Download ZIP
Raw
SuperClaudeDocs.md

SuperClaude - Guia Completo de Comandos e Personas

Visão Geral

SuperClaude é um sistema avançado de inteligência artificial para desenvolvimento, análise e operações. Este guia fornece documentação completa sobre todos os comandos disponíveis, personas e suas capacidades.

Índice

  1. Personas - Perfis Comportamentais
  2. Comandos Universais
  3. Flags Universais
  4. Comandos de Desenvolvimento
  5. Comandos de Análise
  6. Comandos de Operações
  7. Comandos de Design
  8. Comandos de Workflow
  9. Comandos de Sistema
  10. Exemplos de Workflows

Personas

SuperClaude possui 9 personas especializadas que podem ser ativadas com /persona:<nome>:

🏗️ architect

  • Foco: Sistemas que evoluem, design para mudança
  • Pergunta Principal: "Como isso vai escalar e evoluir?"
  • Estilo: Diagramas, trade-offs, cenários futuros
  • Comandos Especializados: /user:design --api --ddd, /user:estimate
  • Ferramentas MCP: Sequential, Context7

🎨 frontend

  • Foco: UX determina o sucesso do produto
  • Pergunta Principal: "Como isso se sente para o usuário?"
  • Estilo: Protótipos, user stories, exemplos visuais
  • Comandos Especializados: /user:build --react, /user:explain
  • Ferramentas MCP: Magic, Context7, Puppeteer

⚙️ backend

  • Foco: Confiabilidade e performance habilitam tudo
  • Pergunta Principal: "Isso vai aguentar 10x a carga?"
  • Estilo: Métricas, benchmarks, contratos de API
  • Comandos Especializados: /user:build --api
  • Ferramentas MCP: Context7, Sequential

🔍 analyzer

  • Foco: Todo sintoma tem múltiplas causas potenciais
  • Pergunta Principal: "Que evidência contradiz a resposta óbvia?"
  • Estilo: Documentar achados, mostrar cadeia de raciocínio
  • Comandos Especializados: /user:analyze, /user:troubleshoot, /user:explain
  • Ferramentas MCP: Todas (Sequential primária)

🔒 security

  • Foco: Ameaças existem em todo lugar, confiança deve ser conquistada
  • Pergunta Principal: "O que pode dar errado?"
  • Estilo: Avaliações de risco, modelos de ameaça, relatórios de segurança
  • Comandos Especializados: /user:scan --security
  • Ferramentas MCP: Sequential, Context7

👨‍🏫 mentor

  • Foco: Entendimento cresce através de descoberta guiada
  • Pergunta Principal: "Como posso ajudá-lo a entender isso?"
  • Estilo: Analogias, passo-a-passo, verificar compreensão
  • Comandos Especializados: /user:explain --depth, /user:document
  • Ferramentas MCP: Context7, Sequential

🔧 refactorer

  • Foco: Débito de qualidade de código se acumula exponencialmente
  • Pergunta Principal: "Como isso pode ser mais simples e limpo?"
  • Estilo: Comparações antes/depois, métricas, passos incrementais
  • Comandos Especializados: /user:improve --quality, /user:cleanup --code
  • Ferramentas MCP: Sequential, Context7

⚡ performance

  • Foco: Velocidade é uma feature, lentidão mata adoção
  • Pergunta Principal: "Onde está o gargalo?"
  • Estilo: Benchmarks, profiles, orçamentos de performance
  • Comandos Especializados: /user:analyze --profile, /user:improve --perf
  • Ferramentas MCP: Puppeteer, Sequential

✅ qa

  • Foco: Qualidade não pode ser testada depois, deve ser construída junto
  • Pergunta Principal: "Como isso poderia quebrar?"
  • Estilo: Cenários de teste, matrizes de risco, métricas de qualidade
  • Comandos Especializados: /user:test, /user:scan --validate
  • Ferramentas MCP: Puppeteer, Context7

Comandos Universais

Todos os comandos seguem o formato /user:<comando> [argumentos] [--flags]

Flags Universais

Estas flags estão disponíveis para TODOS os comandos:

Flags de Planejamento e Análise

  • --plan - Mostra plano de execução antes de executar
  • --think - Análise padrão (multi-arquivo, ~4K tokens)
  • --think-hard - Análise profunda (nível arquitetura, ~10K tokens)
  • --ultrathink - Análise crítica (sistema completo, ~32K tokens)

Flags de Documentação

  • --ultracompressed ou --uc - Redução de ~70% de tokens com formatação estilo telegram

Flags de Controle MCP

  • --c7 / --no-c7 - Habilita/desabilita Context7 para documentação
  • --seq / --no-seq - Habilita/desabilita Sequential para análise
  • --magic / --no-magic - Habilita/desabilita Magic para UI
  • --pup / --no-pup - Habilita/desabilita Puppeteer para browser
  • --all-mcp - Habilita todos os servidores MCP
  • --no-mcp - Desabilita todos os servidores MCP

Comandos de Desenvolvimento

/user:build - Construtor Universal de Projetos

Propósito: Construir projetos e features com vários templates de stack

Flags Específicas:

  • --init - Inicializar novo projeto
  • --feature - Adicionar nova feature
  • --react - Template React
  • --api - Template API
  • --tdd - Desenvolvimento orientado a testes
  • --watch - Modo observação
  • --interactive - Modo interativo

Exemplos:

/user:build --react --magic           # App React com geração de UI
/user:build --api --c7               # API com suporte a documentação
/user:build --feature "user auth" --tdd  # Nova feature com TDD
/user:build --init --think-hard      # Novo projeto com análise profunda

/user:dev-setup - Configuração de Ambiente

Propósito: Configurar ferramentas de desenvolvimento, CI/CD e monitoramento

Flags Específicas:

  • --install - Instalar ferramentas
  • --ci - Configurar CI/CD
  • --monitor - Configurar monitoramento

Exemplos:

/user:dev-setup --install --think     # Instalação com análise de dependências
/user:dev-setup --ci --think-hard    # Pipeline CI/CD com design completo
/user:dev-setup --monitor            # Configurar ferramentas de monitoramento

/user:test - Framework de Testes

Propósito: Criar e executar testes abrangentes

Flags Específicas:

  • --coverage - Relatório de cobertura
  • --watch - Modo observação
  • --e2e - Testes end-to-end
  • --interactive - Modo interativo

Exemplos:

/user:test --e2e --pup --think      # Testes E2E com Puppeteer
/user:test --coverage --c7          # Testes com suporte a docs do framework
/user:test --watch                  # Testes em modo observação

Comandos de Análise

/user:analyze - Análise Multidimensional

Propósito: Analisar qualidade de código, arquitetura, performance e segurança

Flags Específicas:

  • --code - Análise de código
  • --architecture - Análise arquitetural
  • --profile - Profiling de performance
  • --security - Análise de segurança
  • --performance - Análise de performance
  • --watch - Modo observação
  • --interactive - Modo interativo

Exemplos:

/user:analyze --code --think         # Review de código com contexto
/user:analyze --security --ultrathink # Auditoria de segurança completa
/user:analyze --architecture         # Análise da arquitetura do sistema
/user:analyze --profile --seq        # Profiling com análise sequencial

/user:troubleshoot - Debug e Correção

Propósito: Debug sistemático e análise de causa raiz

Flags Específicas:

  • --investigate - Investigar problema
  • --fix - Aplicar correções
  • --five-whys - Análise cinco porquês
  • --prod - Modo produção

Exemplos:

/user:troubleshoot --investigate --think    # Debug com contexto completo
/user:troubleshoot --prod --ultrathink     # Debug crítico em produção
/user:troubleshoot --five-whys             # Análise de causa raiz

/user:improve - Melhorias de Código

Propósito: Otimizar qualidade, performance e manutenibilidade

Flags Específicas:

  • --quality - Melhorar qualidade
  • --performance - Otimizar performance
  • --iterate - Modo iterativo
  • --threshold - Definir limite
  • --solid - Aplicar SOLID
  • --refactor - Refatoração
  • --metrics - Mostrar métricas
  • --watch - Modo observação
  • --interactive - Modo interativo

Exemplos:

/user:improve --quality --solid              # Aplicar princípios SOLID
/user:improve --performance --iterate --threshold 95%  # Otimização iterativa
/user:improve --refactor --metrics          # Refatoração com métricas

/user:explain - Explicações Detalhadas

Propósito: Fornecer explicações abrangentes com profundidade apropriada

Flags Específicas:

  • --depth - Nível de profundidade (basic/intermediate/advanced)
  • --visual - Incluir diagramas
  • --examples - Incluir exemplos

Exemplos:

/user:explain --c7 "React hooks" --think    # React hooks com conexões contextuais
/user:explain --depth advanced --visual     # Explicação avançada com diagramas
/user:explain "design patterns" --examples  # Padrões com exemplos práticos

Comandos de Operações

/user:deploy - Deploy de Aplicações

Propósito: Deploy com verificações de segurança e capacidade de rollback

Flags Específicas:

  • --env - Ambiente (staging/prod)
  • --rollback - Fazer rollback

Exemplos:

/user:deploy --env staging --think      # Deploy em staging com coordenação
/user:deploy --env prod --think-hard   # Deploy em produção com planejamento
/user:deploy --rollback                # Rollback para versão anterior

/user:migrate - Migrações

Propósito: Executar migrações com medidas de segurança

Flags Específicas:

  • --dry-run - Simular migração
  • --rollback - Reverter migração

Exemplos:

/user:migrate --dry-run --think         # Preview com análise de impacto
/user:migrate --rollback --ultrathink  # Rollback crítico com análise completa

/user:scan - Segurança e Validação

Propósito: Escanear vulnerabilidades e validar operações

Flags Específicas:

  • --validate - Validação pré-execução
  • --security - Análise de segurança
  • --owasp - OWASP Top 10
  • --deps - Dependências
  • --quick - Scan rápido
  • --strict - Modo estrito

Exemplos:

/user:scan --validate               # Validação de segurança pré-execução
/user:scan --security --owasp      # Análise OWASP Top 10
/user:scan --deps --strict         # Scan estrito de dependências

/user:estimate - Estimativas

Propósito: Fornecer estimativas de tempo e complexidade

Flags Específicas:

  • --detailed - Estimativa detalhada
  • --worst-case - Pior caso

Exemplos:

/user:estimate --detailed --think       # Breakdown detalhado com análise
/user:estimate --worst-case --think-hard # Estimativa baseada em riscos

/user:cleanup - Limpeza e Manutenção

Propósito: Limpar artefatos, código e configurações

Flags Específicas:

  • --code - Limpar código
  • --files - Limpar arquivos
  • --deps - Limpar dependências
  • --git - Limpar git
  • --cfg - Limpar configurações
  • --all - Limpar tudo
  • --dry-run - Simular limpeza
  • --watch - Modo observação

Exemplos:

/user:cleanup --all --dry-run      # Preview de limpeza completa
/user:cleanup --code --deps        # Limpar código e dependências
/user:cleanup --git                # Limpar branches e histórico git

/user:git - Gerenciamento Git

Propósito: Gerenciar operações git com segurança

Flags Específicas:

  • --status - Ver status
  • --commit - Criar commit
  • --branch - Gerenciar branches
  • --sync - Sincronizar
  • --merge - Fazer merge
  • --stash - Gerenciar stash
  • --history - Ver histórico
  • --checkpoint - Criar checkpoint
  • --rollback - Fazer rollback

Exemplos:

/user:git --commit "Add feature"       # Criar commit
/user:git --merge develop --think     # Merge com análise de conflitos
/user:git --checkpoint                # Criar ponto de recuperação
/user:git --sync                     # Sincronizar com remoto

Comandos de Design

/user:design - Design de Sistema

Propósito: Projetar e arquitetar soluções de software

Flags Específicas:

  • --api - Design de API
  • --ddd - Domain-Driven Design
  • --prd - Product Requirements Document
  • --openapi - Especificação OpenAPI
  • --graphql - Schema GraphQL
  • --bounded-context - Contextos delimitados

Exemplos:

/user:design --api --openapi          # API REST com spec OpenAPI
/user:design --ddd --think-hard      # Modelagem profunda de domínio
/user:design --graphql               # Design de schema GraphQL
/user:design --prd                   # Documento de requisitos

Comandos de Workflow

/user:spawn - Criar Agente Especializado

Propósito: Criar sub-agentes especializados para tarefas específicas

Flags Específicas:

  • --task - Definir tarefa

Exemplos:

/user:spawn --task "optimize database queries" --think  # Agente de dados
/user:spawn --task "implement auth system" --think-hard # Implementação complexa

/user:document - Criação de Documentação

Propósito: Criar documentação abrangente

Flags Específicas:

  • --api - Documentação de API
  • --user - Documentação de usuário

Exemplos:

/user:document --api                  # Gerar documentação de API
/user:document --user --uc           # Guias de usuário otimizados

Comandos de Sistema

/user:load - Carregar Contexto

Propósito: Carregar e analisar estrutura do projeto

Flags Específicas:

  • --depth - Profundidade (shallow/normal/deep)

Exemplos:

/user:load --depth deep              # Análise completa da codebase
/user:load --depth shallow           # Análise superficial rápida

/task: - Sistema de Tarefas

Propósito: Gerenciar features complexas entre sessões

Subcomandos:

  • create - Criar nova tarefa
  • list - Listar tarefas
  • start - Iniciar tarefa
  • pause - Pausar tarefa
  • complete - Completar tarefa
  • resume - Retomar tarefa
  • cancel - Cancelar tarefa
  • show - Mostrar detalhes
  • update - Atualizar tarefa

Exemplos:

/task:create "Sistema de autenticação" --type feature --priority high
/task:resume 20250623-143052
/task:list --status active
/task:complete AUTH-001

Exemplos de Workflows

Workflow de Setup de Projeto

/user:load → /user:dev-setup --install → /user:build --init → /user:test --coverage

Ciclo Completo de Desenvolvimento

/user:load → /user:analyze → /user:design --api → /user:build --tdd → /user:test --e2e → /user:deploy

Review de Código e Qualidade

/user:analyze --code --think → /user:improve --quality → /user:scan --validate

Deploy em Produção

/user:test --coverage → /user:scan --security → /user:scan --validate → /user:deploy

Debugging Complexo

/user:troubleshoot --investigate --think → /user:analyze --profile → /user:improve --performance

Modos de Pensamento

O SuperClaude ajusta automaticamente seu nível de análise:

  • Sem flag: Tarefas simples, arquivo único
  • --think: Multi-arquivo, análise padrão (~4K tokens)
  • --think-hard: Nível arquitetural, análise profunda (~10K tokens)
  • --ultrathink: Sistema completo, análise crítica (~32K tokens)

Servidores MCP

  • Context7 (C7): Documentação de bibliotecas e frameworks
  • Sequential: Análise profunda e pensamento estruturado
  • Magic: Geração de componentes UI
  • Puppeteer: Automação de browser e testes visuais

Dicas de Uso

  1. Combine Personas com Comandos: Ative uma persona antes de executar comandos para obter comportamento especializado
  2. Use Flags de Pensamento: Para tarefas complexas, sempre adicione --think ou superior
  3. Aproveite MCP: Use --c7 para documentação, --seq para análise profunda
  4. Workflows Encadeados: Combine comandos em sequência para fluxos completos
  5. Modo Ultracompressed: Use --uc quando o contexto estiver alto para economizar tokens

Recursos Compartilhados

O sistema utiliza 37 arquivos de configuração compartilhados para:

  • Detecção e resolução de ambiguidades
  • Logging de auditoria
  • Gerenciamento de checkpoints
  • Templates e memória de comandos
  • Padrões de tratamento de erros
  • Integração com workflow Git
  • Controle de servidores MCP
  • Monitoramento de performance
  • Modos de planejamento e pensamento
  • Sistema de gerenciamento de tarefas
  • Otimização de tokens
  • Padrões de experiência do usuário
  • Encadeamento de workflows

SuperClaude v4.0.0 - Sistema Completo de Desenvolvimento e Operações

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment