--- title: "Slash Commands Custom para Programar con IA: Construye Tu Propio Flujo Spec-Driven" description: "Cómo 6 archivos markdown convirtieron mi asistente de IA en un co-arquitecto estructurado — y por qué deberías construir tu propio sistema de comandos en vez de depender de prompts crudos." date: 2026-03-10 url: https://valdemird.com/blog/es/custom-commands-ai-coding/ lang: es tags: ["herramientas-ia", "workflow", "productividad", "automatizacion"] --- # Slash Commands Custom para Programar con IA: Construye Tu Propio Flujo Spec-Driven > Cómo 6 archivos markdown convirtieron mi asistente de IA en un co-arquitecto estructurado — y por qué deberías construir tu propio sistema de comandos en vez de depender de prompts crudos. Todas las herramientas de IA para programar te dejan escribir prompts en lenguaje natural. Muy pocas te dejan construir *flujos de trabajo estructurados* sobre ellas. Ese es el gap que la mayoría de desarrolladores no ven, y la razón por la que su código generado por IA necesita reescrituras constantes. El concepto no es nuevo. El [desarrollo spec-driven](https://en.wikipedia.org/wiki/Spec-driven_development) — definir *qué* quieres antes de escribir *cómo* — ha sido una disciplina de ingeniería de software por décadas. Lo nuevo es aplicarlo a la programación asistida por IA. Como [explora Birgitta Bockeler en martinfowler.com](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html), las herramientas de SDD están trayendo la disciplina de la ingeniería temprana — diseñar antes de codear — a la era agéntica. La idea es simple: en lugar de escribir las mismas instrucciones cada vez ("explora mi codebase primero", "sigue los patrones existentes", "no escribas tests todavía"), las codificas en slash commands reutilizables. Archivos markdown. Sin SDK, sin API, sin sistema de plugins. Solo archivos que tu herramienta de IA lee como instrucciones. Construí 6 comandos que forman un **pipeline de desarrollo spec-driven**. Te cuento cómo, y por qué deberías armar los tuyos. ## Por Qué los Prompts Crudos Fallan a Escala Cuando escribes *"agrega autenticación JWT a mi API"*, le estás pidiendo al modelo que tome docenas de decisiones implícitas: - ¿Qué librería de JWT? - ¿Dónde se almacenan los tokens? - ¿Cómo se integra con tu middleware existente? - ¿Cuál es tu patrón de manejo de errores? El modelo va a adivinar. A veces acierta. A menudo no. Y terminas gastando más tiempo corrigiendo las suposiciones de la IA que lo que hubieras tardado escribiendo el código tú mismo. ## Comando 1: Crear. De Idea a Spec Estructurado Le das un nombre y una descripción general. El comando genera un spec estructurado con contexto, comportamiento esperado, edge cases, restricciones, criterios de aceptación, y, crucialmente, **preguntas abiertas** que detectó que *tú* necesitas responder. Pon tus archivos de comandos: *(Porcentaje del tiempo de sesión arreglando código que no encajó)* ## La Regla de Oro > Nunca saltes pasos bajo presión. El tiempo que "ahorras" saltando el audit o el review lo pagas triple en correcciones después. No se trata de ir más lento. Se trata de **invertir 10 minutos en especificación para ahorrar 2 horas en debugging**. Tu herramienta de IA se vuelve dramáticamente más útil cuando la tratas como un colaborador que necesita contexto, no como una caja mágica que adivina lo que quieres. Los flujos estructurados le ganan a los prompts crudos. Siempre. --- **Lectura adicional:** - [Spec-Driven Development: Designing Before You Code](https://medium.com/@dave-patten/spec-driven-development-designing-before-you-code-again-21023ac91180), Dave Patten, Medium - [Exploring SDD Tools](https://martinfowler.com/articles/exploring-gen-ai/sdd-3-tools.html), Martin Fowler - [Spec-Driven Development: When Architecture Becomes Executable](https://www.infoq.com/articles/spec-driven-development/), InfoQ - [Beyond Vibe-Coding: A Practical Guide to Spec-Driven Development](https://www.scalablepath.com/machine-learning/spec-driven-development-guide), Scalable Path - [GitHub Spec Kit](https://github.com/github/spec-kit), Tooling open-source de GitHub para SDD