| name | senior-fullstack |
| description | Kit de desenvolvimento fullstack com scaffolding de projetos para stacks Next.js, FastAPI, MERN e Django, análise de qualidade de código com scoring de segurança e complexidade, e orientação na seleção de stack. Use quando o usuário pedir para 'criar scaffolding de um novo projeto', 'criar um app Next.js', 'configurar FastAPI com React', 'analisar qualidade de código', 'auditar minha base de código', 'qual stack devo usar', 'gerar boilerplate de projeto' ou mencionar desenvolvimento fullstack, configuração de projeto ou comparação de tech stack. |
| agents | ["claude-code"] |
Desenvolvedor Fullstack Sênior
Skill de desenvolvimento fullstack com scaffolding de projetos e ferramentas de análise de qualidade de código.
Sumário
Frases de Ativação
Use esta skill quando ouvir:
- "criar scaffolding de um novo projeto"
- "criar um app Next.js"
- "configurar FastAPI com React"
- "analisar qualidade de código"
- "verificar problemas de segurança na base de código"
- "qual stack devo usar"
- "configurar um projeto fullstack"
- "gerar boilerplate de projeto"
Ferramentas
Project Scaffolder
Gera estruturas de projeto fullstack com código boilerplate.
Templates Suportados:
nextjs - Next.js 14+ com App Router, TypeScript, Tailwind CSSfastapi-react - Backend FastAPI + Frontend React + PostgreSQLmern - MongoDB, Express, React, Node.js com TypeScriptdjango-react - Django REST Framework + Frontend React
Uso:
python scripts/project_scaffolder.py --list-templates
python scripts/project_scaffolder.py nextjs my-app
python scripts/project_scaffolder.py fastapi-react my-api
python scripts/project_scaffolder.py mern my-project
python scripts/project_scaffolder.py django-react my-app
python scripts/project_scaffolder.py nextjs my-app --output ./projects
python scripts/project_scaffolder.py nextjs my-app --json
Parâmetros:
| Parâmetro | Descrição |
|---|
template | Nome do template (nextjs, fastapi-react, mern, django-react) |
project_name | Nome para o novo diretório do projeto |
--output, -o | Diretório de saída (padrão: diretório atual) |
--list-templates, -l | Listar todos os templates disponíveis |
--json | Saída em formato JSON |
A saída inclui:
- Estrutura do projeto com todos os arquivos necessários
- Configurações de pacotes (package.json, requirements.txt)
- Configuração TypeScript
- Setup de Docker e docker-compose
- Templates de arquivo de ambiente
- Próximos passos para executar o projeto
Analisador de Qualidade de Código
Analisa bases de código fullstack em busca de problemas de qualidade.
Categorias de Análise:
- Vulnerabilidades de segurança (segredos hardcoded, riscos de injeção)
- Métricas de complexidade de código (complexidade ciclomática, profundidade de aninhamento)
- Saúde de dependências (pacotes desatualizados, CVEs conhecidos)
- Estimativa de cobertura de testes
- Qualidade de documentação
Uso:
python scripts/code_quality_analyzer.py .
python scripts/code_quality_analyzer.py /path/to/project
python scripts/code_quality_analyzer.py . --verbose
python scripts/code_quality_analyzer.py . --json
python scripts/code_quality_analyzer.py . --output report.json
Parâmetros:
| Parâmetro | Descrição |
|---|
project_path | Caminho para o diretório do projeto (padrão: diretório atual) |
--verbose, -v | Mostrar achados detalhados |
--json | Saída em formato JSON |
--output, -o | Escrever relatório em arquivo |
A saída inclui:
- Score geral (0-100) com nota em letra
- Problemas de segurança por severidade (crítico, alto, médio, baixo)
- Arquivos de alta complexidade
- Dependências vulneráveis com referências CVE
- Estimativa de cobertura de testes
- Completude de documentação
- Recomendações priorizadas
Exemplo de Saída:
============================================================
RELATÓRIO DE ANÁLISE DE QUALIDADE DE CÓDIGO
============================================================
Score Geral: 75/100 (Nota: C)
Arquivos Analisados: 45
Total de Linhas: 12.500
--- SEGURANÇA ---
Crítico: 1
Alto: 2
Médio: 5
--- COMPLEXIDADE ---
Complexidade Média: 8.5
Arquivos de Alta Complexidade: 3
--- RECOMENDAÇÕES ---
1. [P0] SEGURANÇA
Problema: Possível segredo hardcoded detectado
Ação: Remover ou proteger dados sensíveis na linha 42
Workflows
Workflow 1: Iniciar Novo Projeto
- Escolha a stack adequada com base nos requisitos (consulte a Matriz de Decisão de Stack)
- Crie o scaffolding da estrutura do projeto
- Verifique o scaffold: confirme que
package.json (ou requirements.txt) existe
- Execute verificação de qualidade inicial — resolva quaisquer problemas P0 antes de prosseguir
- Configure o ambiente de desenvolvimento
python scripts/project_scaffolder.py nextjs my-saas-app
ls my-saas-app/package.json
cd my-saas-app
npm install
cp .env.example .env.local
python ../scripts/code_quality_analyzer.py .
npm run dev
Workflow 2: Auditar Base de Código Existente
- Execute análise de qualidade de código
- Revise achados de segurança — corrija todos os problemas P0 (críticos) imediatamente
- Re-execute o analyzer para confirmar que os problemas P0 foram resolvidos
- Crie tickets para problemas P1/P2
python scripts/code_quality_analyzer.py /path/to/project --verbose
python scripts/code_quality_analyzer.py /path/to/project --json --output audit.json
python scripts/code_quality_analyzer.py /path/to/project --verbose
Workflow 3: Seleção de Stack
Use o guia de tech stack para avaliar opções:
- SEO Obrigatório? → Next.js com SSR
- Backend intenso em API? → FastAPI ou NestJS separado
- Funcionalidades em tempo real? → Adicionar camada WebSocket
- Expertise da equipe → Combine a stack com as habilidades da equipe
Veja references/tech_stack_guide.md para comparação detalhada.
Guias de Referência
Padrões de Arquitetura (references/architecture_patterns.md)
- Arquitetura de componentes frontend (Atomic Design, Container/Presentational)
- Padrões backend (Clean Architecture, Repository Pattern)
- Design de API (convenções REST, design de schema GraphQL)
- Padrões de banco de dados (connection pooling, transações, read replicas)
- Estratégias de cache (cache-aside, HTTP cache headers)
- Arquitetura de autenticação (JWT + refresh tokens, sessions)
Workflows de Desenvolvimento (references/development_workflows.md)
- Configuração de desenvolvimento local (Docker Compose, configuração de ambiente)
- Workflows Git (trunk-based, conventional commits)
- Pipelines CI/CD (exemplos GitHub Actions)
- Estratégias de testes (unit, integration, E2E)
- Processo de revisão de código (templates de PR, checklists)
- Estratégias de implantação (blue-green, canary, feature flags)
- Monitoramento e observabilidade (logging, métricas, health checks)
Guia de Tech Stack (references/tech_stack_guide.md)
- Comparação de frameworks frontend (Next.js, React+Vite, Vue)
- Frameworks backend (Express, Fastify, NestJS, FastAPI, Django)
- Seleção de banco de dados (PostgreSQL, MongoDB, Redis)
- ORMs (Prisma, Drizzle, SQLAlchemy)
- Soluções de autenticação (Auth.js, Clerk, JWT customizado)
- Plataformas de implantação (Vercel, Railway, AWS)
- Recomendações de stack por caso de uso (MVP, SaaS, Enterprise)
Referência Rápida
Matriz de Decisão de Stack
| Requisito | Recomendação |
|---|
| Site crítico para SEO | Next.js com SSR |
| Painel interno | React + Vite |
| Backend API-first | FastAPI ou Fastify |
| Escala enterprise | NestJS + PostgreSQL |
| Protótipo rápido | Next.js API routes |
| Dados orientados a documento | MongoDB |
| Queries complexas | PostgreSQL |
Problemas Comuns
| Problema | Solução |
|---|
| Queries N+1 | Use DataLoader ou eager loading |
| Builds lentas | Verificar tamanho do bundle, lazy load |
| Complexidade de auth | Use Auth.js ou Clerk |
| Erros de tipo | Habilitar strict mode no tsconfig |
| Problemas de CORS | Configurar middleware corretamente |
