Recursos Herramientas Suscribirse
← Todos los recursos Skill para Claude · Gratis

SDD Clarifier

Transforma una idea vaga en especificaciones completas antes de escribir una sola línea de código.

Qué es el SDD Clarifier

El SDD Clarifier es una skill para Claude que guía el proceso de clarificación de un proyecto digital antes de escribir código. Tomas una idea —puede ser una frase, un párrafo, una nota de voz transcrita— y al final tienes un conjunto completo de artefactos de especificación: PRD, arquitectura, modelo de datos, design system, roadmap y specs funcionales compatibles con OpenSpec.

El problema que resuelve no es técnico. Es anterior a lo técnico.

Frameworks como OpenSpec, GitHub Copilot Workspace o BMAD asumen que ya sabes qué quieres construir. Entran en la fase de implementación. El SDD Clarifier cubre el tramo previo: las decisiones de negocio, las decisiones de diseño y la fase exploratoria donde todavía hay más preguntas que respuestas.

Cómo funciona

El proceso tiene tres fases secuenciales.

Fase 1 — Exploración (conversacional). Claude no genera nada todavía. Pregunta. Extrae del usuario las decisiones necesarias agrupadas en cuatro áreas: negocio (modelo de monetización, métricas de éxito, restricciones), diseño (plataforma, estilo visual, tono), técnica (stack, integraciones, despliegue) y alcance (MVP vs. visión completa). Máximo tres preguntas por turno. Al final, presenta un resumen de todas las decisiones para validación explícita.

Fase 2 — Formalización (generación de artefactos). Una vez confirmado el alcance, genera la estructura de carpetas completa con todos los documentos. Los specs funcionales siguen el formato OpenSpec (SHALL/MUST/SHOULD según RFC 2119), organizados por dominio. Los docs adicionales cubren lo que OpenSpec no cubre: business.md, design-system.md, architecture.md, data-model.md y roadmap.md. Se incluye un CLAUDE.md con instrucciones para el agente de codificación.

Fase 3 — Entrega y siguiente paso. Presenta la estructura generada y da el paso concreto a seguir: inicializar OpenSpec y continuar con el flujo estándar de implementación.

Filosofía

La skill implementa un principio simple: 80% planificación, 20% ejecución.

Claude no decide por el usuario. Pregunta, confronta, propone opciones y espera. El usuario mantiene el control y la comprensión total del proyecto en todo momento. Si durante la generación falta alguna decisión, Claude para y pregunta antes de asumir.

La potencia sin control no sirve de nada.

Cómo instalarla

Una skill es un archivo Markdown que Claude carga como contexto de sistema. No es un plugin ni una extensión del navegador. No requiere instalación en el sentido tradicional.

En Claude.ai (web y móvil). Ve a Configuración → Skills → Añadir skill. Carga el archivo sdd-clarifier-skill.md. A partir de ese momento, Claude lo usará automáticamente cuando detecte que estás describiendo un proyecto.

En Claude Code (terminal). Copia el archivo en ~/.claude/skills/sdd-clarifier/SKILL.md. Claude Code lo cargará en cada sesión.

En Claude Desktop. El proceso es equivalente al de Claude Code: el archivo va en la carpeta de skills de tu configuración local.

¿Funciona con la API de Anthropic? No directamente. Las skills son un mecanismo de Claude Code y Claude Desktop. Si usas la API, puedes incluir el contenido del archivo como system prompt manualmente, pero el sistema de skills no se aplica en llamadas directas a la API.

Compatibilidad con OpenSpec

Los artefactos que genera esta skill son directamente compatibles con OpenSpec CLI. Una vez que tienes la carpeta generada:

  1. Instala OpenSpec: npm install -g @fission-ai/openspec@latest
  2. Ejecuta openspec init en el directorio del proyecto
  3. Los specs generados por el SDD Clarifier se integran como fuente de verdad
  4. Para nuevas funcionalidades, usa el flujo estándar: /opsx:propose, /opsx:apply, /opsx:archive

Apoyo voluntario

¿Te ha resultado útil este recurso?

Todos los recursos de Con Criterio son gratuitos. Si quieres apoyar que sigan siéndolo, puedes invitarme a un café.

Invítame a un café

Archivos incluidos

sdd-clarifier-skill.md MD · 8 KB
Descargar