claudiao 1.0.0

package/templates/skills/python-patterns/SKILL.md

@@ -0,0 +1,123 @@
+---
+name: python-patterns
+description: Patterns e boilerplates Python prontos — Repository Pattern, Settings, FastAPI estruturado, pytest fixtures. Use quando iniciar módulos ou precisar de referência.
+allowed-tools: Read, Write, Edit, Grep, Glob, Bash
+model: sonnet
+---
+
+# Python Patterns
+
+Patterns e boilerplates Python prontos para uso.
+
+## Quando ativar
+
+Ative quando o usuário estiver:
+- Criando novo módulo/serviço Python
+- Configurando projeto FastAPI ou Django
+- Implementando Repository Pattern com SQLAlchemy
+- Criando fixtures de teste com pytest
+- Configurando settings com Pydantic
+
+## Patterns
+
+### Repository Pattern (SQLAlchemy 2.0 + async)
+
+```python
+from sqlalchemy import select
+from sqlalchemy.ext.asyncio import AsyncSession
+
+class BaseRepository[T]:
+    def __init__(self, session: AsyncSession, model: type[T]) -> None:
+        self._session = session
+        self._model = model
+
+    async def get_by_id(self, id: int) -> T | None:
+        stmt = select(self._model).where(self._model.id == id)
+        result = await self._session.execute(stmt)
+        return result.scalar_one_or_none()
+
+    async def list_all(self, *, offset: int = 0, limit: int = 100) -> list[T]:
+        stmt = select(self._model).offset(offset).limit(limit)
+        result = await self._session.execute(stmt)
+        return list(result.scalars().all())
+
+    async def create(self, entity: T) -> T:
+        self._session.add(entity)
+        await self._session.flush()
+        return entity
+```
+
+### Pydantic Settings
+
+```python
+from pydantic_settings import BaseSettings, SettingsConfigDict
+
+class Settings(BaseSettings):
+    model_config = SettingsConfigDict(env_file=".env", env_file_encoding="utf-8")
+
+    # App
+    app_name: str = "my-service"
+    debug: bool = False
+    log_level: str = "INFO"
+
+    # Database
+    database_url: str
+    db_pool_size: int = 5
+    db_max_overflow: int = 10
+
+    # Redis
+    redis_url: str = "redis://localhost:6379"
+
+    # Auth
+    jwt_secret: str
+    jwt_expiration_minutes: int = 60
+
+settings = Settings()
+```
+
+### FastAPI App Structure
+
+```python
+# app/main.py
+from contextlib import asynccontextmanager
+from fastapi import FastAPI
+
+@asynccontextmanager
+async def lifespan(app: FastAPI):
+    # startup
+    yield
+    # shutdown
+
+app = FastAPI(title="My Service", lifespan=lifespan)
+
+# app/api/deps.py
+from typing import Annotated
+from fastapi import Depends
+from sqlalchemy.ext.asyncio import AsyncSession
+
+async def get_session() -> AsyncSession:
+    async with async_session_maker() as session:
+        yield session
+
+SessionDep = Annotated[AsyncSession, Depends(get_session)]
+```
+
+### Pytest Fixtures
+
+```python
+# conftest.py
+import pytest
+from httpx import ASGITransport, AsyncClient
+
+@pytest.fixture
+async def client(app):
+    transport = ASGITransport(app=app)
+    async with AsyncClient(transport=transport, base_url="http://test") as ac:
+        yield ac
+
+@pytest.fixture
+async def db_session(engine):
+    async with async_session_maker(bind=engine) as session:
+        yield session
+        await session.rollback()
+```

package/templates/skills/security-checklist/SKILL.md

@@ -0,0 +1,80 @@
+---
+name: security-checklist
+description: Checklist de segurança pré-deploy — OWASP Top 10, headers, auth, secrets, dependências. Use antes de deploy ou review de segurança.
+allowed-tools: Read, Write, Edit, Grep, Glob, Bash
+model: sonnet
+---
+
+# Security Checklist
+
+Checklist de segurança para validar antes de deploy ou em review de segurança.
+
+## Quando ativar
+
+Ative quando o usuário estiver:
+- Preparando deploy para produção
+- Fazendo review de segurança
+- Auditando um módulo ou API
+- Pedindo checklist de segurança
+
+## Checklist: Pré-Deploy
+
+### Autenticação e Autorização
+- [ ] Endpoints protegidos com auth (JWT, session, API key)
+- [ ] Autorização por role/permission verificada no backend (não só no frontend)
+- [ ] Tokens com expiração adequada (access: 15min, refresh: 7d)
+- [ ] Rate limiting em endpoints de login/register/forgot-password
+- [ ] Logout invalida token/session no backend
+
+### Input Validation
+- [ ] Todos inputs validados no backend (Zod, class-validator, Pydantic)
+- [ ] Queries parametrizadas (sem string concatenation)
+- [ ] File upload: validação de tipo, tamanho e nome
+- [ ] Sanitização de HTML/markdown (se renderizado)
+
+### Secrets e Configuração
+- [ ] Sem secrets no código (API keys, passwords, tokens)
+- [ ] `.env` no `.gitignore`
+- [ ] Secrets em secrets manager (AWS SSM, Azure Key Vault, GCP Secret Manager)
+- [ ] Variáveis de ambiente diferentes por ambiente (dev/staging/prod)
+
+### Headers e CORS
+- [ ] CORS restrito aos domínios necessários (não `*` em APIs autenticadas)
+- [ ] `Content-Security-Policy` configurado
+- [ ] `X-Content-Type-Options: nosniff`
+- [ ] `Strict-Transport-Security` (HSTS)
+- [ ] `X-Frame-Options: DENY` (ou CSP frame-ancestors)
+
+### Dependências
+- [ ] `npm audit` / `pip audit` sem vulnerabilidades críticas
+- [ ] Lockfile commitado (package-lock.json, yarn.lock)
+- [ ] Dependências com versões fixas (não `^` ou `*` em produção)
+
+### Database
+- [ ] Migrations reversíveis
+- [ ] Sem dados sensíveis em plaintext (passwords hashed com bcrypt/argon2)
+- [ ] Backups configurados e testados
+- [ ] Conexão via SSL
+
+### Logging e Monitoring
+- [ ] Sem PII em logs (email, CPF, cartão, senhas)
+- [ ] Audit trail para ações críticas (login, pagamento, delete)
+- [ ] Alertas configurados para erros 5xx e latência
+- [ ] Error tracking (Sentry, Bugsnag)
+
+### Infra
+- [ ] HTTPS obrigatório (redirect HTTP → HTTPS)
+- [ ] Firewall/security groups restritivos
+- [ ] Containers rodando como non-root
+- [ ] Imagens Docker com base slim e sem ferramentas de debug
+
+## Comando rápido de auditoria
+
+```bash
+# Node.js
+npm audit --production
+npx eslint --config .eslintrc.js --rule '{"no-eval": "error"}' src/
+
+# Buscar secrets no código
+grep -rn "password\|secret\|api_key\|token" --include="*.ts" --include="*.js" src/ | grep -v node_modules | grep -v ".test."
+```

package/templates/skills/sql-templates/SKILL.md

@@ -0,0 +1,93 @@
+---
+name: sql-templates
+description: Templates SQL prontos para diagnóstico de performance, migrations zero-downtime, e operações comuns em PostgreSQL
+allowed-tools: Read, Grep, Glob, Bash, Write, Edit
+model: sonnet
+---
+
+# SQL Templates
+
+Templates SQL prontos para uso em diagnóstico e operações de banco PostgreSQL.
+
+## Quando ativar
+
+Ative quando o usuário estiver:
+- Investigando query lenta ou problema de performance
+- Criando migration que altera tabelas em produção
+- Precisando de templates para operações comuns de banco
+
+## Templates
+
+### Diagnóstico de Query Lenta
+
+```sql
+-- 1. Analise o plano de execução
+EXPLAIN (ANALYZE, BUFFERS, FORMAT TEXT) SELECT ...;
+
+-- 2. Verifique estatísticas da tabela
+SELECT schemaname, relname, seq_scan, idx_scan, n_live_tup, n_dead_tup
+FROM pg_stat_user_tables WHERE relname = 'sua_tabela';
+
+-- 3. Liste indexes existentes
+SELECT indexname, indexdef FROM pg_indexes WHERE tablename = 'sua_tabela';
+
+-- 4. Queries mais lentas (requer pg_stat_statements)
+SELECT query, calls, mean_exec_time, total_exec_time
+FROM pg_stat_statements ORDER BY mean_exec_time DESC LIMIT 20;
+
+-- 5. Locks ativos
+SELECT pid, usename, query, state, wait_event_type, wait_event
+FROM pg_stat_activity WHERE state != 'idle' ORDER BY query_start;
+```
+
+### Migration Zero-Downtime (Expand-Contract)
+
+```sql
+-- EXPAND: Adicione coluna sem NOT NULL (não trava tabela)
+ALTER TABLE users ADD COLUMN email_normalized VARCHAR(255);
+
+-- MIGRATE: Backfill em batches (evita lock longo)
+UPDATE users SET email_normalized = LOWER(TRIM(email))
+WHERE id BETWEEN $start AND $end;
+
+-- VALIDATE: Verifique consistência
+SELECT COUNT(*) FROM users WHERE email_normalized IS NULL;
+
+-- CONTRACT: Aplique constraints (após backfill completo)
+ALTER TABLE users ALTER COLUMN email_normalized SET NOT NULL;
+```
+
+### Criação Segura de Index
+
+```sql
+-- SEMPRE use CONCURRENTLY em produção (não bloqueia writes)
+CREATE INDEX CONCURRENTLY idx_users_email ON users (email);
+
+-- Verifique se o index foi criado com sucesso (CONCURRENTLY pode falhar silenciosamente)
+SELECT indexname, indexdef FROM pg_indexes
+WHERE tablename = 'users' AND indexname = 'idx_users_email';
+
+-- Se falhou, drope o index inválido e tente novamente
+DROP INDEX CONCURRENTLY IF EXISTS idx_users_email;
+```
+
+### Health Check Rápido
+
+```sql
+-- Tabelas maiores (espaço em disco)
+SELECT relname, pg_size_pretty(pg_total_relation_size(relid))
+FROM pg_catalog.pg_statio_user_tables ORDER BY pg_total_relation_size(relid) DESC LIMIT 10;
+
+-- Bloat de tabelas (dead tuples acumulados)
+SELECT relname, n_dead_tup, n_live_tup,
+  ROUND(n_dead_tup::numeric / GREATEST(n_live_tup, 1) * 100, 2) AS dead_pct
+FROM pg_stat_user_tables WHERE n_dead_tup > 1000 ORDER BY n_dead_tup DESC;
+
+-- Conexões ativas
+SELECT state, COUNT(*) FROM pg_stat_activity GROUP BY state;
+
+-- Cache hit ratio (deve ser > 99%)
+SELECT ROUND(
+  SUM(heap_blks_hit) / GREATEST(SUM(heap_blks_hit) + SUM(heap_blks_read), 1) * 100, 2
+) AS cache_hit_ratio FROM pg_statio_user_tables;
+```

package/templates/skills/ui-review-checklist/SKILL.md

@@ -0,0 +1,73 @@
+---
+name: ui-review-checklist
+description: Checklist completo para revisão de UI — hierarquia visual, acessibilidade, responsividade, estados interativos. Use antes de PR de frontend.
+allowed-tools: Read, Grep, Glob, Bash, Edit
+model: sonnet
+---
+
+# UI Review Checklist
+
+Checklist estruturado para revisão de interfaces antes de merge/deploy.
+
+## Quando ativar
+
+Ative quando o usuário estiver:
+- Revisando PR de frontend
+- Fazendo QA visual de componentes
+- Auditando acessibilidade
+- Verificando responsividade
+
+## Checklist
+
+### Hierarquia Visual
+- [ ] Hierarquia clara (títulos, subtítulos, corpo)
+- [ ] Espaçamento consistente (múltiplos de 4px ou 8px)
+- [ ] Tipografia com no máximo 2-3 tamanhos por tela
+- [ ] Alinhamento consistente (grid/flexbox)
+
+### Cores e Contraste
+- [ ] Contraste texto/fundo passa WCAG AA (4.5:1 para texto, 3:1 para UI)
+- [ ] Usa design tokens (sem cores hardcoded)
+- [ ] Dark mode funciona (se aplicável)
+- [ ] Informação não depende apenas de cor (use ícones/texto também)
+
+### Estados Interativos
+- [ ] Hover em elementos clicáveis
+- [ ] Focus ring visível para navegação por teclado
+- [ ] Active/pressed state
+- [ ] Disabled state (visual + funcional)
+- [ ] Loading state em botões durante requests
+- [ ] Cursor correto (pointer, not-allowed, etc.)
+
+### Estados de Conteúdo
+- [ ] Loading (skeleton screens > spinners)
+- [ ] Empty state (mensagem + CTA)
+- [ ] Error state (mensagem clara + ação de recuperação)
+- [ ] Success state (feedback de confirmação)
+
+### Responsividade
+- [ ] Mobile (320px) — sem scroll horizontal
+- [ ] Tablet (768px)
+- [ ] Desktop (1024px+)
+- [ ] Touch targets mínimo 44x44px em mobile
+
+### Acessibilidade
+- [ ] Semântica HTML correta (button, nav, main, article)
+- [ ] ARIA labels em elementos interativos
+- [ ] Alt text em imagens
+- [ ] Navegação completa por teclado (Tab, Enter, Escape)
+- [ ] Screen reader faz sentido (teste com VoiceOver/NVDA)
+- [ ] `prefers-reduced-motion` respeitado em animações
+
+### Forms
+- [ ] Labels associados a inputs
+- [ ] Validação inline (não apenas on submit)
+- [ ] Mensagens de erro específicas (não "campo inválido")
+- [ ] Autocomplete attributes corretos
+- [ ] Tab order lógico
+
+### Performance Visual
+- [ ] Imagens otimizadas (WebP/AVIF, lazy loading)
+- [ ] Fonts com `font-display: swap`
+- [ ] Nenhum layout shift visível (CLS)
+- [ ] Transições suaves (não abrutas)