💪 Superpowers Framework

O obra/superpowers e o repositorio de skills mais popular do GitHub com mais de 27 mil stars. Ele define um framework completo de instrucoes que transforma agentes de codigo em desenvolvedores disciplinados, seguindo workflows estruturados com checkpoints de qualidade em cada etapa.

O sucesso do Superpowers vem da sua abordagem pragmatica: em vez de instrucoes vagas, ele define passos concretos que o agente deve seguir, com criterios claros de quando avancar para o proximo passo. Isso reduz drasticamente a incidencia de codigo mal estruturado ou bugs nao detectados.

O core do Superpowers e um workflow de 6 passos que o agente deve seguir para cada tarefa. Este workflow garante que o agente nao pule etapas criticas como analise, planejamento e testes, que sao frequentemente ignoradas quando se trabalha sem estrutura.

Uma das skills mais populares do Superpowers e a TDD Workflow. Ela forca o agente a seguir o ciclo classico red-green-refactor: primeiro escrever testes que falham, depois implementar o minimo necessario para passar, e finalmente refatorar mantendo testes verdes.

A skill define cobertura minima de 80%, requer testes para edge cases, e impede que o agente avance para implementacao sem testes escritos. Esse nivel de disciplina e dificil de manter manualmente, mas skills automatizam a consistencia.

# TDD Workflow

Para cada feature ou bugfix, siga rigorosamente:

## 1. RED - Escreva testes primeiro
- Crie testes que descrevem o comportamento esperado
- Execute e confirme que FALHAM (red)
- Cubra: happy path, edge cases, error cases

## 2. GREEN - Implemente o minimo
- Escreva apenas o codigo necessario para os testes passarem
- NAO otimize ainda - foco em corretude
- Execute testes e confirme que PASSAM (green)

## 3. REFACTOR - Melhore o codigo
- Refatore mantendo testes verdes
- Elimine duplicacao, melhore nomes, simplifique
- Execute testes apos cada mudanca

O Superpowers inclui skills especializadas para debugging sistematico e brainstorming estruturado. A skill de debugging guia o agente por um processo de investigacao que evita "shotgun debugging" (mudar coisas aleatoriamente esperando que funcione).

A skill de brainstorming utiliza tecnicas como "5 Whys", "First Principles" e "Inverse Brainstorming" para gerar solucoes criativas. Em vez de simplesmente pedir ideias, a skill estrutura o processo de pensamento do agente para explorar o espaco de solucoes sistematicamente.

Com 3000+ forks, o Superpowers gerou dezenas de variacoes especializadas para nichos especificos. Essas variacoes adaptam o framework base para dominios como DevOps, data science, mobile e frontend, mantendo a filosofia de workflow estruturado.

Estudar forks populares revela como adaptar um framework generico para contextos especificos sem perder a essencia. Cada fork adiciona regras de dominio, modifica prioridades dos passos e inclui checklists especificos da area.

O verdadeiro poder do Superpowers esta na adaptacao ao seu contexto. O framework base e um ponto de partida - voce deve customizar os passos, adicionar regras especificas do seu stack e definir prioridades alinhadas com sua equipe.

O processo de adaptacao envolve: identificar gaps no workflow base para seu dominio, adicionar checklists especificos, definir convencoes de codigo e ajustar o nivel de rigor baseado na criticidade do projeto. Comece com o framework base e itere.

# Meu Superpowers Customizado

## Stack: Next.js + Supabase + TypeScript
## Convencoes:
- Sempre use TypeScript strict mode
- Componentes em PascalCase, hooks com use prefix
- Testes com Vitest, coverage minima 85%

## Workflow Adaptado:
1. Analyze - inclui verificar types e schema Supabase
2. Plan - definir migrations necessarias
3. Implement - server components por padrao
4. Test - unit + integration + e2e com Playwright
5. Review - verificar RLS policies
6. Document - atualizar types exportados