Catálogo de Skills

# API and Interface Design

## Principios Fundamentales
1. **Contract First**: Define siempre la interfaz antes de escribir la implementación. El contrato es la especificación.
2. **Hyrum's Law**: Cualquier comportamiento observable de una API (incluidos formatos de error o tiempos) será asumido por alguien como contrato. No expongas detalles de implementación.
3. **The One-Version Rule**: Evita forzar al consumidor a lidiar con múltiples versiones en conflicto. Diseña contratos extensibles hacia adelante.
4. **Validación Temprana**: Valida esquemas y entradas en la frontera de la API, devolviendo respuestas de error tipadas y legibles.

# Frontend UI Engineering

## Objetivos
- Interfaz moderna con jerarquía tipográfica cuidada y paletas de color con contraste verificado.
- Totalmente accesible: etiquetas ARIA donde corresponda, soporte completo de navegación por teclado y respeto por prefers-reduced-motion.
- Arquitectura por componentes desacoplados con tokens de diseño CSS unificados.
- Eliminación de saltos de diseño (CLS) mediante dimensiones explícitas y skeleton loaders en cargas asíncronas.

# Incremental Implementation

## Estrategia de Trabajo
1. Divide tareas que afecten a más de 2 archivos en rebanadas verificables independientes.
2. Conserva la suite de tests en verde en cada paso intermedio.
3. Utiliza feature flags o patrones expand/contract para migraciones sin tiempo de inactividad ni roturas.
4. Valida cada incremento con pruebas unitarias antes de continuar al siguiente módulo.

# Test-Driven Development (TDD)

## Ciclo Red-Green-Refactor
1. **Red**: Escribe una prueba pequeña y enfocada que falle antes de implementar cualquier código de producción.
2. **Green**: Escribe el código estrictamente necesario para que la prueba pase con éxito.
3. **Refactor**: Limpia el código, elimina duplicidades y optimiza manteniendo todos los tests en verde.
4. No aceptes código nuevo o corrección de bugs sin una prueba automatizada asociada.

# Code Review & Quality

## Ejes de Inspección
- **Corrección lógica**: ¿Maneja casos límite, valores nulos y excepciones adecuadamente?
- **Rendimiento**: ¿Introduce consultas N+1, operaciones sincrónicas bloqueantes o renderizados innecesarios?
- **Seguridad**: ¿Se sanean todas las entradas de usuario y se previenen inyecciones SQL / XSS?
- **Simplicidad**: ¿Es el código fácil de entender para otro desarrollador sin requerir explicaciones paralelas?

# Debugging and Error Recovery

## Protocolo de Diagnóstico
1. **Reproducción fiable**: Crea un caso de prueba o paso a paso mínimo y repetible que dispare el fallo.
2. **Formulación de hipótesis**: Plantea una causa concreta y falsable basada en logs e inspección del estado.
3. **Comprobación**: Diseña un test o registro específico para confirmar o refutar la hipótesis.
4. **Solución en la raíz**: Corrige la causa original en lugar de ocultar los síntomas con parches cosméticos.

# Code Simplification

## Reglas de Claridad
- Reduce niveles de anidamiento utilizando guard clauses y salidas tempranas (early returns).
- Nombres descriptivos y explícitos sobre comentarios redundantes.
- Descompone métodos largos en funciones pequeñas con una única responsabilidad clara.
- Elimina abstracciones prematuras si solo tienen una implementación real.

# CI/CD and Automation

## Reglas de Pipeline
1. Todo Pull Request debe ejecutar linters, análisis de tipos y suites de pruebas en paralelo.
2. Bloqueo estricto de merge si algún paso falla.
3. Generación de artefactos reproducibles y despliegues automáticos a entornos de staging/producción tras validación.

# Git Workflow and Versioning

## Buenas Prácticas
- Commits atómicos: un cambio conceptual por commit con mensaje claro (`feat:`, `fix:`, `refactor:`, `docs:`).
- Rebase interactivo para limpiar ramas antes de abrir Pull Request.
- Versionado semántico estricto: MAJOR para cambios incompatibles, MINOR para nuevas funcionalidades retrocompatibles, PATCH para correcciones.

# Observability and Instrumentation

## Pilares de Visibilidad
- **Logs estructurados**: Incluye siempre contexto identificador (request_id, user_id, duración) en formato parseable.
- **Métricas**: Registra tasas de éxito, errores (4xx/5xx) y percentiles de latencia (p95/p99).
- **Alertas tempranas**: Notificaciones antes de que un fallo de rendimiento impacte a la totalidad de usuarios.

# Security and Hardening

## Controles Esenciales
1. **Consultas parametrizadas**: Usa siempre prepared statements; nunca concatenes variables en sentencias SQL.
2. **Escape contextual**: Escapa toda salida hacia el navegador (`htmlspecialchars` con ENT_QUOTES | ENT_SUBSTITUTE).
3. **Protección CSRF**: Tokens criptográficos únicos por sesión validados en todos los métodos POST/PUT/DELETE.
4. **Cookies seguras**: Marcas `HttpOnly`, `Secure` y `SameSite=Lax` en identificadores de sesión.
5. **Cabeceras HTTP de seguridad**: Content-Security-Policy, X-Frame-Options, X-Content-Type-Options.

# Performance Optimization

## Áreas de Optimización
- **Bases de datos**: Asegura índices en claves foráneas y columnas de filtro frecuente (`EXPLAIN QUERY PLAN`).
- **Frontend**: Optimización de imágenes (WebP), compresión gzip/brotli y minimización del bloqueo de renderizado por scripts.
- **Consultas eficientes**: Evita patrones de consulta N+1 mediante JOINs adecuados o agrupación de lecturas.

# Spec-Driven Development

## Componentes de una Especificación
1. **Problema y Alcance**: Qué problema resuelve la funcionalidad y qué queda explícitamente fuera de alcance.
2. **Contrato de Datos**: Esquema de entidades, tipos de datos y restricciones de integridad.
3. **Casos de Uso**: Flujos principales y alternativos detallados paso a paso.
4. **Criterios de Aceptación**: Lista de condiciones objetivas para declarar la tarea terminada.

# Interview Me

## Metodología
- Formula una sola pregunta clave a la vez para no abrumar al usuario.
- Cuestiona supuestos técnicos iniciales para entender el problema de negocio de fondo.
- Ofrece opciones recomendadas con sus respectivos pros y contras.
- No comiences a codificar hasta alcanzar un alto grado de certidumbre sobre el alcance deseado.