claude-dev-skill

¿Qué es claude-dev-skill?

claude-dev-skill es una skill personalizada para Claude Code que convierte a Claude en un proceso de “tech lead” para construir software con múltiples agentes de trabajo IA. La skill proporciona un flujo de trabajo estructurado multifase que coordina el trabajo paralelo de workers en worktrees aislados, con el objetivo de reducir la pérdida de contexto y conflictos de merge al enrutar cambios a través de PRs y revisiones.

Su propósito principal es ir más allá de la generación de código single-threaded: guía la alineación de requisitos (PRD), decisiones de arquitectura, descomposición de tareas, implementación paralela, verificaciones estáticas de QA y un paso estructurado de revisión/merge de PR.

Características clave

• Flujo de comandos /dev (SOP multifase): Comienza con clasificación de la solicitud y pasa por alineación de PRD, arquitectura y creación de issues, implementación de workers, verificación de QA y coordinación de merge de PR.
• Regla de enrutamiento tech-lead: La conversación principal se trata como coordinador; “nunca escribe código directamente”, requiriendo que los cambios pasen por Worker Agent → PR → proceso de revisión.
• Agentes Worker paralelos vía worktrees: Genera múltiples agentes worker que desarrollan en paralelo en worktrees aislados para soportar diferentes partes de la funcionalidad (p. ej., auth, API, frontend).
• Escaneo de conflictos pre-codificación: Antes de empezar el trabajo, los agentes worker escanean otros Issues abiertos en busca de solapamiento de archivos para detectar conflictos probables antes.
• Coordinación de PR post-merge: Después de merges, escanea PRs abiertos y notifica branches que necesitan rebase.
• Puerta de seguridad antes de revisión: Exige ejecutar herramientas de seguridad (p. ej., bandit más pip-audit para Python, o npm audit para Node) como paso requerido antes de la fase de revisión.
• Lista de verificación estructurada de revisión de PR con condiciones de veto: La revisión de código se hace mediante una lista de 7 ítems con condiciones de veto obligatorias.
• Auto-verificación con contraejemplos para cobertura de tests: Incluye una auto-verificación de seis categorías para asegurar que los workers consideren escenarios de Null/Empty/Boundary/Fallo externo/Concurrencia/Entrada maliciosa.

Cómo usar claude-dev-skill

1. Instala los archivos de la skill en el directorio de comandos de Claude Code (instalación basada en script para macOS/Linux/Windows, o copia manual preservando la estructura de directorios).
2. Asegúrate de tener Claude Code (CLI oficial de Anthropic) logueado.
3. Usa el GitHub CLI (gh) con una sesión autenticada (ejecuta gh auth login primero).
4. En Claude Code, ejecuta /dev [descripción opcional]. La skill clasificará la solicitud (p. ej., nuevo proyecto, nueva funcionalidad, corrección de bug, hotfix, cambio arquitectónico, refactorización) e iniciará el flujo correspondiente.

Una ejecución típica sigue las fases mostradas en el repositorio: alineación de PRD (dos rondas), arquitectura y descomposición de tareas con GitHub Issues, ejecución de workers en worktrees paralelos, verificación estática de QA y revisión de PR con lista de verificación y merge.

Casos de uso

• Construir una funcionalidad de backend web pequeña-mediana con PRD existente: Usa /dev para traducir un documento de requisitos de producto existente en decisiones de arquitectura, GitHub Issues e implementaciones paralelas de workers.
• Implementar múltiples módulos a la vez minimizando conflictos de merge: Deja que agentes worker separados manejen componentes diferentes (p. ej., autenticación vs. API CRUD de tareas vs. componentes frontend) y confía en escaneo de conflictos pre-codificación y coordinación de rebase post-merge.
• Corrección coordinada de bugs o hotfixes: Para correcciones de bugs o hotfixes de emergencia, el flujo clasifica el tipo de solicitud y lo enruta por revisión de arquitectura, cambios de worker, verificación de QA y merge estructurado de PR.
• Refactorización sistemática con revisión estructurada: Al refactorizar, la auto-verificación con contraejemplos del SOP y la puerta de seguridad pre-merge ayudan a asegurar que los workers consideren casos edge y ejecuten herramientas de auditoría requeridas antes de la revisión.
• Trabajo de cambio arquitectónico que requiere alineación antes de codificar: Usa la Fase 1 de alineación de PRD y Fase 2 de decisiones de arquitectura para aclarar el plan del equipo antes de que los workers inicien la implementación.

Preguntas frecuentes

• ¿Qué significa “tech lead” en el flujo de trabajo de esta skill? La conversación principal actúa como coordinador: alinea el PRD, decide la dirección de la arquitectura, genera agentes worker y asegura que los cambios de código pasen por PRs de Worker Agent y revisión, en lugar de ediciones directas en el chat.

• ¿Escribe claude-dev-skill código directamente desde la conversación principal? No. El flujo incluye una “regla de hierro” por la que la conversación principal nunca escribe código directamente; los cambios deben pasar por un Worker Agent y luego un PR para revisión.

• ¿Cómo se manejan los conflictos durante el desarrollo paralelo? La skill incluye un escaneo de conflictos pre-código (los agentes worker verifican Issues abiertos por solapamiento de archivos antes de empezar) y un paso post-merge que escanea PRs abiertos para identificar branches que necesitan rebase.

• ¿Qué verificaciones de seguridad se aplican? Antes de la fase de revisión, exige ejecutar herramientas de seguridad como bandit más pip-audit para Python, o npm audit para Node, según la descripción del Security gate del repositorio.

• ¿Está pensada para trabajo de despliegue en producción? Las notas de alcance del repositorio indican que no es adecuada para proyectos que requieran despliegue en producción porque no proporciona capacidad de DevOps/despliegue.

Alternativas

• Asistentes de código de un solo agente (estilo autocompletado/chat): Se centran en escribir código directamente desde prompts, pero normalmente no ofrecen un flujo multiagente de PRD a PR con revisiones forzadas.
• Prompting multi-paso convencional + flujos de PR manuales: Puedes pedirle a Claude que descomponga tareas y ejecutes workers manualmente, pero pierdes la estructura SOP integrada (clasificación, escaneo de conflictos, QA y coordinación de revisión por checklist).
• Flujos de equipo estándar basados en GitHub (Issues/PRs sin SOP de IA): Los equipos pueden replicar partes del flujo con GitHub Issues y revisiones de PR, pero la paralelización de “worker agents” y el enrutamiento automático de fases no se proporcionan de la misma manera.
• Otras skills personalizadas de Claude Code enfocadas en planificación o testing: En lugar de coordinar agentes worker en paralelo de principio a fin, algunas skills se centran solo en una parte del flujo (p. ej., generación de tests), dejando la integración y coordinación de merges al usuario.