O que criar-pico-técnico faz?
Crie documentos de pico técnico com limite de tempo para pesquisar e resolver decisões críticas de desenvolvimento antes da implementação.
Visão Geral
Use esta skill para iniciar uma investigação focada e com prazo definido (pico técnico) sobre um desafio técnico, uma decisão arquitetural ou uma escolha de tecnologia. O documento gerado ajuda a equipe a:
- Explorar alternativas de forma estruturada
- Documentar descobertas e riscos
- Tomar decisões informadas
- Evitar retrabalho durante a implementação
Como usar
- Descreva o problema ou a decisão a ser investigada.
- A skill gerará um documento markdown com as seções:
- Objetivo
- Abordagem
- Resultados esperados
- Critérios de sucesso
- Plano de ação
- Revise e compartilhe o documento com sua equipe.
Exemplo
# Pico Técnico: Escolha do ORM para o novo serviço de usuários
**Duração:** 3 dias
**Autor:** Assistente IA
**Data:** 2025-04-08
## Objetivo
Avaliar Prisma, TypeORM e Drizzle para o novo microsserviço de usuários, considerando desempenho, escalabilidade e facilidade de manutenção.
## Abordagem
- Revisar documentação oficial e benchmarks públicos.
- Prototipar consultas CRUD básicas em cada ORM.
- Medir latência, uso de memória e facilidade de integração com PostgreSQL.
## Resultados esperados
- Tabela comparativa com prós e contras de cada opção.
- Recomendação final com justificativa.
- Riscos identificados (ex.: dependências externas, curvas de aprendizado).
## Critérios de sucesso
- Testes de integração bem-sucedidos para ao menos dois ORMs.
- Documentação clara o suficiente para um desenvolvedor júnior prosseguir.
## Plano de ação
1. Dia 1: Configuração dos projetos de teste e revisão da documentação do Prisma.
2. Dia 2: Prototipagem com TypeORM e Drizzle.
3. Dia 3: Comparação de métricas e redação do relatório final.
Integração com GitHub
A skill pode criar ou atualizar arquivos diretamente no repositório via GitHub API, versionando o pico técnico junto ao código. Use o caminho docs/spikes/ por convenção.
Notas
- Mantenha o pico com prazo definido (recomendado: 1-5 dias).
- O documento de saída deve ser auto-contido e claro para todo o time.
- Evite incluir código de produção no pico — o foco é investigação e documentação.