PARA DESARROLLADORES

Desarrolladores

El perfil software es la parte honda del kit. Le da a un proyecto una organización de ingeniería completa, cada rol cargando las herramientas adecuadas para su carril, y un flujo de trabajo ordenado desde el issue hasta el PR fusionado.

Tu equipo

Ejecuta /kit-init y elige software:

Rol	De qué se encarga	Herramientas que carga
tech-lead	Sistema de build, toolchain, ADRs, CI/CD, scaffolding	Context7, GitHub navigator
backend	API, modelo de datos, esquema, jobs, tiempo real, auth	claude-api, Context7
frontend	Toda la UI cliente, app shell, UX cliente, animación	claude-api, GSAP, Chrome DevTools, Context7
qa	Tests E2E, aceptación, regresión, el gate de release	Playwright, Chrome DevTools
security	Modelado de amenazas, auditorías de vulnerabilidades, defensa ante inyecciones, deps	claude-api
devops	Infra, pipelines CI/CD, deploy, release, migraciones	Context7, GitHub navigator
designer	Design system, pantallas, movimiento, UX	skills de diseño + GSAP
pm	Estado del trabajo a través de GitHub; issues, planes, bloqueos	skills de flujo de tareas

Los roles delegan cruzando fronteras — backend pasa el trabajo de UI a frontend, la infra a devops — en vez de adivinar fuera de su carril. Consulta Agentes y orquestación para ver el modelo de enrutamiento.

Skills de construcción que se activan solas

Algunas skills están condicionadas al stack: solo se activan cuando se detecta su tecnología en tu package.json, y se mantienen al margen en caso contrario.

Skill	Se activa cuando	Cubre
feature-build-refine	@refinedev/* presente	Arquitectura Next.js + Supabase + RefineDev
supabase-patterns	@supabase/supabase-js presente	Modelo de tres clientes, guard de auth en server-action, acceso RLS-first

Si la tecnología no está en tu stack, la skill simplemente no aplica. Y karpathy-guidelines — barreras contra los errores comunes de codificación con LLM — viaja en todos los perfiles.

El flujo de trabajo

El kit asume un camino limpio a través de GitHub: issue → branch → PR → merge → close, con sincronización opcional con un tablero de Projects v2. Skills como task-new, task-start, task-pr y task-close impulsan cada paso. Los milestones siguen una cadencia de producto: Foundation → MVP → Beta → GA.

Gates opcionales y SDD

Estos permanecen apagados hasta que los elijas:

• Gate de pre-push — --prepush "<command>" ejecuta un comando (p. ej. tu build) antes de cada git push y bloquea el push si falla. Auto-superable: solo actúa sobre git push.
• Desarrollo guiado por especificación (SDD) — --speckit on instala o identifica Spec Kit e impulsa specify → plan → tasks → implement con gates de revisión.

Consulta Reglas y hooks para ver cómo están cableados.

A dónde ir después

• Instalación — déjalo listo, luego /kit-init → software.
• Perfiles y configuración — cada ajuste, mapeado.
• Comandos y scripts — la referencia completa de comandos.