Apariencia
Herramientas de Ciclo de Spec (Stream B)
El Stream B contiene todas las 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.
Referencia Rápida
| Herramienta | Descripción | Disponibilidad |
|---|---|---|
facilitate | Punto de entrada sin conocimiento previo — describe lo que quieres construir | Incluida |
clarify_requirements | Clarifica requisitos interactivamente antes de crear una spec | Incluida |
elicit_requirements | Elicitación avanzada e interactiva de requisitos | Incluida |
create_spec | Crea una spec SDD completa a partir de una descripción | Incluida |
list_specs | Lista todas las specs de un proyecto, filtra por estado | Incluida |
update_status | Mueve una spec a través de sus etapas del ciclo de vida | Incluida |
summarize_spec | Genera un resumen breve y legible de una spec | Incluida |
spec_history | Ve el historial de cambios de una spec | Incluida |
reconcile_spec | Actualiza una spec para que coincida con lo que realmente se construyó | Incluida |
branch_spec | Crea una rama de spec para experimentación | Incluida |
merge_spec_branch | Fusiona una rama experimental de spec de vuelta a la spec principal | Incluida |
version_spec | Crea una instantánea versionada etiquetada de una spec | Incluida |
spec_diff | Compara dos versiones de una spec y muestra las diferencias | Incluida |
export_spec | Exporta una spec a un formato externo (spec-kit) | Incluida |
check_readiness | Verifica si una spec tiene suficiente detalle para comenzar a construir | Incluida |
challenge_spec | Hace stress-test de una spec simulando fallos y casos borde | Incluida |
red_team | Revisión adversarial — argumenta en contra de la spec desde primeros principios | Incluida |
detect_contradictions | Detecta contradicciones e inconsistencias dentro o entre specs | Incluida |
manage_scope | Gestiona y controla el alcance para prevenir scope creep | Incluida |
package_handoff | Empaqueta una spec y sus dependencias para entrega a agente o equipo | Incluida |
decompose_spec | Descompone automáticamente una spec en tareas independientes de agente | Incluida |
analyze_spec_dependencies | Analiza el grafo de dependencias: ruta crítica, deps circulares, waves | Incluida |
generate_checklist | Genera un checklist de implementación a partir de una spec | Incluida |
check_spec_accuracy | Valida una spec contra la implementación real del codebase | Incluida |
spec_coverage | Genera un reporte de cobertura mostrando specs vs. implementación | Incluida |
spec_usage_report | Reporte que muestra qué specs están usando activamente los agentes | Incluida |
semantic_search | Busca specs y conocimiento del proyecto por significado | Incluida |
list_templates | Navega el catálogo de templates de spec incorporados y personalizados | Incluida |
apply_template | Crea archivos de spec a partir de un template | Incluida |
capture_idea | Captura una idea ligera sin crear una spec completa | Incluida |
list_backlog | Lista todas las ideas capturadas en el backlog del proyecto | Incluida |
promote_idea | Promueve una idea del backlog a una spec completa | Incluida |
discard_idea | Marca una idea del backlog como descartada | Incluida |
session_checkpoint | Guarda un checkpoint de sesión con el contexto actual | Incluida |
planu_status | Obtiene una instantánea compacta del estado actual del proyecto | Incluida |
log_lesson | Registra una lección aprendida de una spec o experiencia de proyecto | Incluida |
list_lessons | Lista las lecciones aprendidas de un proyecto | Incluida |
delete_spec | Elimina una o más specs de un proyecto | Incluida |
delete_project | Elimina todos los datos de un proyecto | Incluida |
delete_pattern | Elimina uno o más patrones aprendidos | Incluida |
delete_decision | Elimina una o más decisiones/ADRs | Incluida |
manage_trash | Gestiona la papelera: listar, restaurar o purgar | Incluida |
generate_spec_dashboard | Regenera el dashboard planu/index.html | Incluida |
Flujo de Trabajo Principal
facilitate
Punto de entrada sin conocimiento previo — describe lo que quieres construir y Planu determina los siguientes pasos.
Cuándo usarlo: Cuando no sabes por dónde empezar. Solo describe tu idea u objetivo en lenguaje natural y facilitate determinará si clarificar requisitos, crear una spec o sugerir la siguiente acción.
Prompt: "I want to add Stripe payments to my app"
Prompt: "Help me plan a multi-tenant permission system"TIP
facilitate es el mejor punto de partida para nuevos usuarios. Elimina la necesidad de conocer nombres de herramientas — solo describe lo que quieres construir.
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 planu to clarify requirements for adding Stripe payments to project 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.
elicit_requirements Pro
Elicitación avanzada e interactiva de requisitos — un modo de entrevista estructurada que va más profundo que clarify_requirements.
Cuándo usarlo: Para funcionalidades complejas, migraciones de plataforma o integraciones que involucran múltiples stakeholders. La herramienta guía la conversación con preguntas de seguimiento basadas en tus respuestas en lugar de presentar una lista plana.
Prompt: "Elicit requirements for the new reporting module in project proj_abc123"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"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"Gestión del Ciclo de Vida de Specs
spec_history Pro
Ve el historial de cambios de una spec — quién cambió qué, cuándo y por qué.
Cuándo usarlo: Al investigar por qué cambió una spec, durante auditorías o al resolver disputas sobre specs.
Prompt: "Show history for spec SPEC-003 in project proj_abc123"reconcile_spec Pro
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"branch_spec Pro
Crea una rama de spec para experimentación — permite explorar un cambio mayor de spec sin tocar la spec principal.
Cuándo usarlo: Cuando quieres prototipar un enfoque alternativo para una spec (diferente arquitectura, diferente alcance) antes de comprometerte con él.
Prompt: "Create a branch of spec SPEC-012 called 'microservices-approach' in project proj_abc123"merge_spec_branch Pro
Fusiona una rama experimental de spec de vuelta a la spec principal tras la validación.
Prompt: "Merge the 'microservices-approach' branch of spec SPEC-012 into main in project proj_abc123"version_spec Pro
Crea una instantánea versionada etiquetada de una spec — útil para seguimiento de hitos y entregas externas.
Cuándo usarlo: Antes de un lanzamiento importante, antes de entregar a un equipo externo, o para fijar una línea base antes de un refactor grande.
Prompt: "Create version v1.0 snapshot of spec SPEC-008 in project proj_abc123"spec_diff Pro
Compara dos versiones de una spec y muestra un diff estructurado de qué cambió.
Prompt: "Show the diff between v1.0 and v2.0 of spec SPEC-008 in project proj_abc123"export_spec Pro
Exporta una spec a un formato externo (spec-kit) para compartir fuera de Planu.
Prompt: "Export spec SPEC-010 to spec-kit format for project proj_abc123"Compuertas de Calidad
check_readiness Pro
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"challenge_spec Pro
Hace stress-test de una spec simulando fallos, tráfico alto, casos borde y condiciones adversariales.
Cuándo usarlo: Antes de aprobar una spec para un sistema crítico, o tras una revisión mayor de la spec.
Prompt: "Challenge spec SPEC-009 in project proj_abc123"red_team Pro
Revisión adversarial — argumenta en contra de la spec desde primeros principios antes de la aprobación.
Cuándo usarlo: Para specs de alto riesgo (facturación, autenticación, migración de datos) donde quieres una revisión del abogado del diablo antes de cerrar el diseño.
Prompt: "Red team spec SPEC-011 in project proj_abc123"detect_contradictions Pro
Analiza todas las specs de un proyecto en busca de contradicciones semánticas.
Cuándo usarlo: Antes de comenzar un sprint, tras 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."
Alcance y Empaquetado
manage_scope Pro
Gestiona la definición de alcance del proyecto y el backlog — agrega elementos, elimina, reprioriza 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"package_handoff Pro
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"decompose_spec Pro
Descompone automáticamente una spec en tareas independientes de agente con propiedad de archivos no superpuesta — lista para ejecutar en paralelo.
Cuándo usarlo: Para specs grandes que pueden dividirse entre múltiples agentes o miembros del equipo. La herramienta aplica propiedad exclusiva de archivos por tarea para prevenir conflictos.
Prompt: "Decompose spec SPEC-015 into parallel agent tasks in project proj_abc123"analyze_spec_dependencies Pro
Analiza el grafo de dependencias de specs: encuentra la ruta crítica, detecta dependencias circulares y calcula waves de ejecución.
Prompt: "Analyze spec dependencies for project proj_abc123"
Prompt: "What is the critical path to ship SPEC-020 in project proj_abc123?"Calidad y Cobertura
generate_checklist Pro
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"check_spec_accuracy Pro
Verifica la precisión de una spec contra la realidad de la implementación — comprueba que los criterios de aceptación, referencias a archivos y detalles técnicos sigan siendo correctos.
Cuándo usarlo: Después de cambios significativos de código, antes de un lanzamiento, o cuando una spec no se ha revisado en un tiempo.
Prompt: "Check accuracy of spec SPEC-005 for project proj_abc123"spec_coverage Pro
Analiza la cobertura de specs en el proyecto — identifica áreas del codebase sin specs y specs sin implementación correspondiente.
Cuándo usarlo: Durante planificación de sprint, revisiones trimestrales o al incorporarse para entender brechas de documentación.
Prompt: "Show spec coverage for project proj_abc123"spec_usage_report Pro
Genera un reporte de observabilidad de specs que muestra qué specs están usando activamente los agentes, cuáles están obsoletas y cuáles se referencian con más frecuencia.
Prompt: "Show spec usage report for project proj_abc123"semantic_search Pro
Busca en el conocimiento del proyecto (specs, patrones, decisiones, conocimiento aprendido) por significado — no solo por coincidencia de palabras clave.
Cuándo usarlo: Cuando recuerdas que algo fue decidido pero no puedes encontrarlo por palabra clave, o cuando buscas specs relacionadas con un tema en un proyecto grande.
Prompt: "Search for anything related to rate limiting in project proj_abc123"
Prompt: "Find specs about user permissions in project proj_abc123"Templates
list_templates
Lista todos los templates de spec disponibles con sus descripciones y casos de uso.
Prompt: "List available spec templates"apply_template Pro
Aplica un template de spec para crear specs rápidamente para patrones comunes (CRUD, auth, integración, etc.).
Cuándo usarlo: Al crear una spec que sigue un patrón conocido y quieres un punto de partida con secciones pre-llenadas.
Prompt: "Apply the CRUD template for a users resource in project proj_abc123"Gestión del Backlog
capture_idea
Captura una idea ligera o posibilidad futura sin crear una spec completa. Las ideas viven en el backlog hasta que se promueven o descartan.
Prompt: "Capture idea: add offline mode support to project proj_abc123"list_backlog
Lista todas las ideas capturadas en el backlog del proyecto.
Prompt: "Show backlog for project proj_abc123"promote_idea
Promueve una idea del backlog a una spec completa, activando el flujo normal de creación de specs.
Prompt: "Promote idea IDEA-003 to a spec in project proj_abc123"discard_idea
Marca una idea del backlog como descartada con una razón opcional.
Prompt: "Discard idea IDEA-005 in project proj_abc123 — not aligned with roadmap"Sesiones y Lecciones
session_checkpoint
Guarda un checkpoint de sesión con el contexto actual, el progreso y las preguntas abiertas — útil para retomar sesiones largas.
Prompt: "Save a session checkpoint for project proj_abc123"planu_status
Obtiene una instantánea compacta del estado actual del proyecto Planu — spec activa, estado de git, cola y actividad reciente. Diseñado para caber en ~150 tokens.
Prompt: "What's the current status of project proj_abc123?"log_lesson
Registra una lección aprendida de una spec o experiencia de proyecto — almacenada como conocimiento de proyecto con búsqueda.
Prompt: "Log lesson: always run detect_contradictions before sprint planning in project proj_abc123"list_lessons
Lista todas las lecciones aprendidas de un proyecto.
Prompt: "Show lessons learned for project proj_abc123"Limpieza
delete_spec
Elimina una o más specs de un proyecto. Las specs eliminadas se mueven a la papelera y pueden restaurarse.
Prompt: "Delete spec SPEC-017 from project proj_abc123"delete_project
Elimina todos los datos de un proyecto. Esta acción mueve todos los datos a la papelera antes de la eliminación permanente.
Prompt: "Delete project proj_abc123"delete_pattern
Elimina uno o más patrones aprendidos de un proyecto.
Prompt: "Delete pattern PAT-002 from project proj_abc123"delete_decision
Elimina una o más decisiones/ADRs de un proyecto.
Prompt: "Delete decision DEC-005 from project proj_abc123"manage_trash
Gestiona la papelera: listar elementos en la papelera, restaurar un elemento específico o purgar la papelera permanentemente.
Prompt: "List trash for project proj_abc123"
Prompt: "Restore spec SPEC-017 from trash in project proj_abc123"
Prompt: "Purge trash for project proj_abc123"generate_spec_dashboard
Regenera el dashboard planu/index.html — una vista general en HTML de todas las specs, sus estados y métricas clave del proyecto.
Prompt: "Regenerate the spec dashboard for project proj_abc123"Ver También
- Herramientas de Análisis y Estimación (Stream C) — estimación, detección de patrones, validate, recommend_model
- Herramientas de Diseño y Planificación (Stream D) — decisiones de arquitectura, esquemas, planes de ejecución
- Herramientas de Plataforma y Operaciones (Streams E–I) — stack, agentes, git, gobernanza