Herramientas de Ciclo de Spec (Stream B)
El Stream B contiene 11 herramientas que gestionan el ciclo de vida completo de una spec — desde la primera pregunta de clarificación hasta la entrega de una spec lista para producción a un agente de IA.
clarify_requirements
Genera preguntas de clarificación dirigidas antes de crear una spec.
Cuándo usarlo: Antes de create_spec cuando los requisitos son ambiguos, surgieron de una conversación verbal rápida, o tocan múltiples sistemas.
Qué produce: Una lista priorizada de preguntas que cubren límites de alcance, casos borde, requisitos no funcionales, manejo de errores y dependencias externas.
Prompt: "Use specforge to clarify requirements for adding Stripe payments to project proj_abc123"
Prompt: "Usa specforge para clarificar los requisitos de agregar pagos con Stripe al proyecto proj_abc123"TIP
Ejecutar clarify_requirements primero lleva a criterios de aceptación significativamente más completos y menos revisiones de specs. Es una inversión de 30 segundos que ahorra horas.
create_spec
Crea una spec SDD completa con secciones auto-generadas.
Qué genera:
| Sección | Descripción |
|---|---|
| User Story | Quién, qué, por qué en formato estándar |
| Criterios de Aceptación | Criterios testeables e inequívocos numerados para trazabilidad |
| Checklist DoR | Compuertas de Definition of Ready |
| Hints de Esquema DB | Tablas, columnas, relaciones, índices |
| Contratos de UI | Contratos de componentes, flujo de datos, gestión de estado |
| Hints de ADR | Architecture Decision Records |
| PLAN.md | Plan de ejecución RED/GREEN/VERIFY paso a paso |
Extras AI-native (cuando se detecta arquitectura de IA):
- Presupuestos de latencia y cadenas de fallback
- Criterios de versionado de prompts
- Requisitos de observabilidad LLM
Extras Frontend (cuando se detecta configuración de performance):
- Criterios de Core Web Vitals
- Requisitos de hidratación SSR
- Definiciones de límites MFE
Prompt: "Create a spec for adding Google OAuth authentication to my project proj_abc123"
Prompt: "Crea una spec para agregar autenticación Google OAuth a mi proyecto proj_abc123"list_specs
Lista todas las specs de un proyecto, opcionalmente filtrando por estado.
Cuándo usarlo: Para ver qué hay en el backlog, qué está en progreso o qué necesita revisión.
Prompt: "List all specs for project proj_abc123"
Prompt: "Show me specs in progress for project proj_abc123"
Prompt: "What specs are blocked in project proj_abc123?"update_status
Transiciona una spec a través de su ciclo de vida con validación DoR/DoD en cada paso.
Flujo de estados: draft → ready → in_progress → review → done
Cada transición valida el checklist apropiado. No puedes marcar una spec como done sin satisfacer sus criterios DoD.
Prompt: "Update status of spec SPEC-003 to in_progress in project proj_abc123"
Prompt: "Mark spec SPEC-007 as done in project proj_abc123"summarize_spec
Genera un resumen conciso de una spec — útil para actualizaciones de equipo, descripciones de PR o notas de standup.
Prompt: "Summarize spec SPEC-005 for project proj_abc123"generate_checklist
Genera un checklist de calidad para una spec — cubre preparación de implementación, cobertura de tests, documentación, seguridad y performance.
Prompt: "Generate a quality checklist for spec SPEC-002 in project proj_abc123"reconcile_spec
Reconcilia una spec con cambios de implementación, con aprobación por cambio y verificación de cumplimiento de la Constitución.
Cuándo usarlo: Cuando la implementación divergió intencionalmente de la spec y necesitas actualizar la spec para que coincida con la realidad.
La herramienta presenta cada cambio para aprobación — tú decides qué se convierte en la nueva verdad de la spec.
Prompt: "Reconcile spec SPEC-004 with the implementation changes in project proj_abc123"manage_scope
Gestiona la definición de alcance del proyecto y el backlog — agrega items, elimina, re-prioriza o exporta como backlog estructurado.
Prompt: "Add 'dark mode support' to the backlog for project proj_abc123 with priority high"
Prompt: "Show the current backlog for project proj_abc123"detect_contradictions
Analiza todas las specs de un proyecto en busca de contradicciones semánticas.
Cuándo usarlo: Antes de comenzar un sprint, después de un pivote importante del producto, o cuando las specs han sido actualizadas independientemente por diferentes miembros del equipo.
Prompt: "Detect contradictions in the specs for project proj_abc123"Ejemplo de output: "SPEC-002 dice que los usuarios pueden eliminar cuentas. SPEC-008 dice que los datos de cuenta son inmutables para propósitos de auditoría."
check_readiness
Evalúa si una spec está lista para implementación — completitud, calidad de criterios y estado de dependencias.
Verificaciones realizadas:
- ¿Son todos los criterios de aceptación testeables e inequívocos?
- ¿Están resueltas todas las dependencias bloqueantes?
- ¿Está completo el checklist DoR?
- ¿Pasa la spec el cumplimiento de la Constitución?
Prompt: "Check if spec SPEC-006 is ready for implementation in project proj_abc123"package_handoff
Genera un paquete estructurado de entrega para que un agente de IA implemente una spec.
Qué produce:
- Objetivo de implementación
- Criterios de aceptación numerados
- Lista de archivos con propiedad
- Restricciones y guardrails
- Prompt listo para pegar para Claude o cualquier agente de IA
Cuándo usarlo: Al delegar la implementación a una sesión autónoma de agente de IA o a un miembro del equipo que no participó en la creación de la spec.
Prompt: "Package spec SPEC-009 for handoff in project proj_abc123"