Herramientas de Diseño y Planificación (Stream D)

Las herramientas del Stream D convierten specs aprobadas en artefactos de implementación concretos — esquemas, contratos de UI, decisiones de arquitectura, planes de ejecución, contratos de eventos y más.

Referencia Rápida

Herramienta	Descripción	Disponibilidad
`generate_adr`	Genera un Architecture Decision Record para una decisión técnica significativa	Incluida
`log_decision`	Registra, lista, busca o reemplaza decisiones arquitectónicas y de proceso	Incluida
`design_schema`	Diseña y valida esquemas de datos para tu aplicación	Incluida
`define_ui_contract`	Define y gestiona contratos de componentes UI para flujos de diseño-a-código	Incluida
`event_contracts`	Define y gestiona contratos de arquitectura event-driven	Incluida
`generate_execution_plan`	Crea un plan de ejecución paso a paso para implementar una spec	Incluida
`generate_orchestration_script`	Genera un script para orquestar ejecución multi-agente	Incluida
`recommend_model`	Recomienda el mejor tier de modelo de IA para una tarea dada	Incluida
`plan_team_distribution`	Planifica cómo distribuir specs aprobadas entre un equipo de agentes Claude Code	Incluida
`generate_spec_from_design`	Genera una spec de Planu a partir de una descripción de diseño UI/UX	Incluida
`contribute_context`	Contribuye contexto adicional a una spec desde fuentes externas	Incluida
`request_context`	Solicita contexto adicional o experiencia de la base de conocimiento	Incluida
`generate_proposal`	Genera una propuesta HTML de proyecto autónoma con cuadrícula KPI y diagrama Gantt	Incluida
`generate_docs_site`	Genera un sitio de documentación HTML estático a partir de las specs del proyecto	Incluida
`data_governance`	Configura políticas de gobernanza de datos y reglas de clasificación de datos	Incluida
`legal_compliance_report`	Genera un reporte de cumplimiento para requisitos legales y regulatorios	Incluida
`federate_specs`	Vincula una spec del proyecto actual a una spec en otro repositorio local	Incluida
`federation_status`	Muestra todos los links de federación de specs entre repos y su estado	Incluida
`discover_registry`	Lee y valida un manifiesto `.well-known/planu.json` desde una ruta de archivo local	Incluida
`publish_registry`	Genera un manifiesto `.well-known/planu.json` a partir de las specs de tu proyecto	Incluida
`registry_publish`	Publica una spec en el registro de Planu	Incluida
`registry_login`	Autentica con el registro de specs de Planu usando un token de API	Incluida
`registry_logout`	Elimina las credenciales del registro almacenadas	Incluida
`registry_whoami`	Muestra el usuario del registro actualmente autenticado	Incluida
`a2a_register`	Registra Planu como agente capaz de A2A (Agent-to-Agent)	Incluida
`a2a_delegate`	Delega una tarea relacionada con specs a otro endpoint de agente A2A	Incluida

Decisiones de Arquitectura

`generate_adr`

Genera un Architecture Decision Record (ADR) para una decisión técnica significativa.

Qué produce: Documentos ADR estructurados que cubren el contexto de la decisión, opciones consideradas, decisión tomada y consecuencias. El formato sigue MADR (Markdown Architectural Decision Records).

Cuándo usarlo: Cuando una spec involucra una elección tecnológica significativa, patrón de arquitectura o trade-off que los futuros desarrolladores necesitan entender.

Prompt: "Generate ADRs for spec SPEC-004 in project proj_abc123"

Ejemplo de output:

markdown

# ADR-001: Use Redis for session storage

## Status: Accepted

## Context
The authentication spec requires session persistence across multiple server instances...

## Decision
Use Redis as the session store...

## Consequences
- Positive: Horizontal scaling without sticky sessions
- Negative: Adds Redis as a required infrastructure dependency

`log_decision`

Registra, lista, busca o reemplaza decisiones arquitectónicas y de proceso en el log de decisiones del proyecto.

Acciones disponibles: log, list, search, supersede

Cuándo usarlo: Para mantener un registro con búsqueda de decisiones tomadas durante el proyecto — quién decidió qué, por qué y cuándo. Reemplaza una decisión anterior cuando el equipo cambia de dirección.

Prompt: "Log a decision: we will use PostgreSQL instead of MongoDB for project proj_abc123"
Prompt: "List all decisions for project proj_abc123"
Prompt: "Supersede decision DEC-003 with the new approach in project proj_abc123"

`design_schema`

Diseña y valida esquemas de datos para tu aplicación.

Qué produce:

Definiciones de tablas con columnas, tipos y restricciones
Relaciones de claves primarias y foráneas
Sugerencias de índices para rendimiento de consultas
Hints de migración
Esquema en múltiples dialectos (SQL, Prisma, SQLAlchemy, GORM, etc.)

Cuándo usarlo: Cuando una spec involucra persistencia de datos y necesitas un punto de partida concreto para la capa de base de datos.

Prompt: "Design the database schema for spec SPEC-002 in project proj_abc123"

`define_ui_contract`

Define y gestiona contratos de componentes UI para flujos de diseño-a-código.

Qué produce:

Definiciones de interfaz de componentes (props, eventos, slots)
Diagrama de flujo de datos (qué componentes poseen qué estado)
Enfoque de gestión de estado (local, contexto, store)
Contrato de API entre frontend y backend
Requisitos de accesibilidad

Cuándo usarlo: Para cualquier spec que incluya un componente frontend, formulario o interacción de usuario.

Prompt: "Define the UI contract for the login flow in spec SPEC-001 for project proj_abc123"

`event_contracts`

Define y gestiona contratos de arquitectura event-driven — genera contratos de eventos JSON Schema para validación productor/consumidor.

Qué produce:

Definiciones JSON Schema para cada tipo de evento
Contrato del productor (qué garantiza el emisor)
Contrato del consumidor (qué espera el suscriptor)
Estrategia de versionado
Notas de compatibilidad hacia atrás

Cuándo usarlo: Para cualquier spec que involucre colas de mensajes, buses de eventos (Kafka, RabbitMQ, AWS SQS/SNS, NATS) o integraciones de webhooks.

Prompt: "Define event contracts for the order processing flow in spec SPEC-008 for project proj_abc123"

Ejemplo de output:

json

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "title": "OrderPlaced",
  "version": "1.0.0",
  "type": "object",
  "required": ["orderId", "customerId", "items", "total", "placedAt"],
  "properties": {
    "orderId": { "type": "string", "format": "uuid" },
    "customerId": { "type": "string", "format": "uuid" },
    "items": { "type": "array", "items": { "$ref": "#/definitions/OrderItem" } },
    "total": { "type": "number", "minimum": 0 },
    "placedAt": { "type": "string", "format": "date-time" }
  }
}

Planificación de Ejecución

`generate_execution_plan`

Crea un plan de ejecución detallado paso a paso para implementar una spec — ciclo RED/GREEN/VERIFY con pasos paralelizables.

Qué produce:

markdown

## Phase 1: Foundation (parallel)
- [ ] Step 1a: Create database migration
- [ ] Step 1b: Define TypeScript interfaces
- [ ] Step 1c: Write failing tests (RED)

## Phase 2: Implementation (sequential)
- [ ] Step 2a: Implement repository layer (GREEN)
- [ ] Step 2b: Implement service layer

## Phase 3: Verification
- [ ] Step 3a: Run full test suite (VERIFY)
- [ ] Step 3b: Update spec status to review

Cuándo usarlo: Antes de que comience la implementación. El PLAN.md se convierte en el contrato de implementación para el agente de IA o el desarrollador.

Prompt: "Generate an execution plan for spec SPEC-005 in project proj_abc123"

`generate_orchestration_script`

Genera un script para orquestar ejecución multi-agente — crea un script de automatización paralela de 3 capas usando worktrees y claude -p.

Qué produce: Un script de shell que:

Crea git worktrees aislados por spec
Lanza workers de claude -p en paralelo
Gestiona la asignación de recursos basada en CPU y RAM disponibles
Monitorea la salud de los workers y maneja fallos

Cuándo usarlo: Cuando necesitas implementar múltiples specs independientes simultáneamente y quieres máximo paralelismo.

Prompt: "Generate an orchestration script for specs SPEC-010, SPEC-011, SPEC-012 in project proj_abc123"

`recommend_model`

Recomienda el mejor tier de modelo de IA (haiku, sonnet u opus) para una tarea dada basándose en complejidad, costo y requisitos de capacidad.

Qué evalúa:

Complejidad de la tarea (generación simple de código vs. decisiones de arquitectura)
Restricciones de costo
Requisitos de velocidad
Profundidad de razonamiento necesaria

Cuándo usarlo: Al elegir entre modelos de IA para implementación, code review o generación de specs.

Prompt: "Recommend a model for implementing spec SPEC-005 in project proj_abc123"

`plan_team_distribution`

Planifica cómo distribuir specs aprobadas entre un equipo de agentes Claude Code — asigna specs a agentes basándose en dependencias, propiedad de archivos y restricciones de paralelismo.

Qué produce:

Tabla de asignación de agentes (qué agente maneja qué specs)
Grafo de dependencias para determinar la secuencia
Mapa de propiedad de archivos para prevenir conflictos
Prompts de spawn de agentes listos para usar

Cuándo usarlo: Al implementar múltiples specs en paralelo con un equipo de agentes. Previene conflictos de archivos y trabajo desperdiciado.

TIP

Ejecuta plan_team_distribution antes de lanzar cualquier equipo de agentes. Detecta conflictos de propiedad de archivos que de otro modo causarían pesadillas en los merges.

Prompt: "Plan team distribution for approved specs in project proj_abc123"

Diseño desde Entrada

`generate_spec_from_design`

Genera una spec de Planu a partir de una descripción de diseño UI/UX — convierte wireframes, descripciones de mockups o notas de diseño en criterios de aceptación estructurados.

Cuándo usarlo: Cuando un diseñador entrega una descripción o imagen de una UI y necesitas convertirla en una spec construible antes de la implementación.

Prompt: "Generate a spec from this design: a dashboard with a sidebar nav, main content area, and a collapsing filters panel, for project proj_abc123"

`contribute_context`

Contribuye contexto adicional a una spec desde fuentes externas o experiencia de dominio — agrega conocimiento estructurado a una spec existente.

Cuándo usarlo: Cuando un experto en la materia (legal, seguridad, cumplimiento) necesita agregar restricciones a una spec que el autor original no tenía.

Prompt: "Contribute context to spec SPEC-003: GDPR requires data deletion within 30 days for project proj_abc123"

`request_context`

Solicita contexto adicional o experiencia de la base de conocimiento — consulta patrones aprendidos, decisiones pasadas y conocimiento de dominio relevante para una spec.

Cuándo usarlo: Antes de escribir una spec en un dominio desconocido para traer restricciones y patrones relevantes de proyectos anteriores.

Prompt: "Request context for a payments integration spec in project proj_abc123"

Exportación y Documentación

`generate_proposal`

Genera una propuesta HTML de proyecto autónoma con cuadrícula KPI, diagrama Gantt, tabla de desglose de specs, análisis de riesgos, resumen de presupuesto y vista general de arquitectura.

Qué produce: Un único archivo HTML portátil listo para compartir con clientes o stakeholders — sin servidor requerido.

Cuándo usarlo: Al presentar un plan de proyecto a stakeholders no técnicos o clientes potenciales.

Prompt: "Generate a project proposal for project proj_abc123"

`generate_docs_site`

Genera un sitio de documentación HTML estático a partir de specs del proyecto, catálogo de herramientas, diagramas de arquitectura y métricas.

Qué produce:

Un sitio HTML navegable que cubre todas las specs, su estado y criterios de aceptación
Diagramas de arquitectura derivados del grafo de specs
Catálogo de herramientas con búsqueda
Exportable para alojar en cualquier servidor estático

Cuándo usarlo: Cuando un proyecto necesita documentación viviente que se mantenga sincronizada con las specs.

Prompt: "Generate a documentation site for project proj_abc123"

Gobernanza y Cumplimiento

`data_governance`

Configura políticas de gobernanza de datos y reglas de clasificación de datos para el proyecto.

Qué produce:

Taxonomía de clasificación de datos (público, interno, confidencial, restringido)
Políticas de gobernanza por clase de datos
Etiquetado a nivel de spec para requisitos de manejo de datos
Detección de violaciones en specs y código futuros

Cuándo usarlo: Para proyectos que manejan datos sensibles — salud, finanzas, legal o cualquier industria regulada.

Prompt: "Set up data governance for project proj_abc123 under HIPAA"

`legal_compliance_report`

Genera un reporte de cumplimiento para requisitos legales y regulatorios — mapea specs e implementación a cláusulas específicas de regulaciones.

Qué produce:

Reporte de cobertura por regulación (GDPR, HIPAA, SOC 2, PCI DSS, etc.)
Brechas abiertas que necesitan remediación
Links de evidencia a specs y eventos del trail de auditoría
Exportable para revisión legal

Cuándo usarlo: Antes de una auditoría de cumplimiento o al preparar paquetes de evidencia para certificación.

Prompt: "Generate a GDPR compliance report for project proj_abc123"

Federación y Registro

La federación permite vincular specs entre repositorios. El registro permite publicar y descubrir specs para reutilización entre equipos y organizaciones.

`federate_specs`

Vincula una spec del proyecto actual a una spec en otro repositorio local — crea un link de dependencia entre repositorios.

Cuándo usarlo: En setups monorepo o multi-repo donde la spec de un proyecto depende de la spec de otro proyecto.

Prompt: "Federate spec SPEC-005 in project proj_abc123 to spec SPEC-012 in project proj_xyz789"

`federation_status`

Muestra todos los links de federación de specs entre repos y su estado — verifica que las specs vinculadas aún existen y están sincronizadas.

Prompt: "Show federation status for project proj_abc123"

`discover_registry`

Lee y valida un manifiesto .well-known/planu.json desde una ruta de archivo local — muestra qué specs expone un proyecto para reutilización.

Prompt: "Discover registry manifest at /workspace/shared-lib"

`publish_registry`

Genera un manifiesto .well-known/planu.json a partir de las specs de tu proyecto — hace que tus specs sean descubribles por otros proyectos.

Prompt: "Publish registry manifest for project proj_abc123"

`registry_publish`

Publica una spec en el registro de Planu para que otros equipos puedan descubrirla y reutilizarla.

Prompt: "Publish spec SPEC-007 to the Planu registry from project proj_abc123"

`registry_login`

Autentica con el registro de specs de Planu usando un token de API.

Prompt: "Log in to the Planu registry with my API token"

`registry_logout`

Elimina las credenciales del registro almacenadas en la máquina local.

Prompt: "Log out of the Planu registry"

`registry_whoami`

Muestra el usuario del registro actualmente autenticado.

Prompt: "Who am I logged in as in the Planu registry?"

Agent-to-Agent (A2A)

A2A permite a Planu participar en ecosistemas multi-agente — registrándose como un agente capaz y delegando tareas a otros agentes especializados.

`a2a_register`

Registra Planu como agente capaz de A2A (Agent-to-Agent) — publica las capacidades de Planu en un endpoint A2A para que otros agentes puedan descubrirlo y delegarle tareas.

Cuándo usarlo: Al integrar Planu en un pipeline multi-agente donde otros orquestadores necesitan saber qué puede hacer Planu.

Prompt: "Register Planu as an A2A agent for project proj_abc123"

`a2a_delegate`

Delega una tarea relacionada con specs a otro endpoint de agente A2A — envía una solicitud de tarea estructurada a un agente externo y recibe el resultado.

Cuándo usarlo: Cuando otro agente especializado (ej. un agente de revisión de código, un agente de despliegue) debe manejar un paso en el workflow de Planu.

Prompt: "Delegate the code review for spec SPEC-009 to the review agent at http://localhost:8080 in project proj_abc123"

Ver También

Herramientas de Ciclo de Spec (Stream B) — crear, actualizar y gestionar specs
Herramientas de Análisis y Estimación (Stream C) — validar, auditar y aprender de tu codebase
Herramientas de Plataforma y Operaciones (Streams E–I) — stack, agentes, git, gobernanza

Herramientas de Diseño y Planificación (Stream D) ​

Referencia Rápida ​

Decisiones de Arquitectura ​

generate_adr ​

log_decision ​

design_schema ​

define_ui_contract ​

event_contracts ​

Planificación de Ejecución ​

generate_execution_plan ​

generate_orchestration_script ​

recommend_model ​

plan_team_distribution ​

Diseño desde Entrada ​

generate_spec_from_design ​

contribute_context ​

request_context ​

Exportación y Documentación ​

generate_proposal ​

generate_docs_site ​

Gobernanza y Cumplimiento ​

data_governance ​

legal_compliance_report ​

Federación y Registro ​

federate_specs ​

federation_status ​

discover_registry ​

publish_registry ​

registry_publish ​

registry_login ​

registry_logout ​

registry_whoami ​

Agent-to-Agent (A2A) ​

a2a_register ​

a2a_delegate ​

Ver También ​

Herramientas de Diseño y Planificación (Stream D)

Referencia Rápida

Decisiones de Arquitectura

`generate_adr`

`log_decision`

`design_schema`

`define_ui_contract`

`event_contracts`

Planificación de Ejecución

`generate_execution_plan`

`generate_orchestration_script`

`recommend_model`

`plan_team_distribution`

Diseño desde Entrada

`generate_spec_from_design`

`contribute_context`

`request_context`

Exportación y Documentación

`generate_proposal`

`generate_docs_site`

Gobernanza y Cumplimiento

`data_governance`

`legal_compliance_report`

Federación y Registro

`federate_specs`

`federation_status`

`discover_registry`

`publish_registry`

`registry_publish`

`registry_login`

`registry_logout`

`registry_whoami`

Agent-to-Agent (A2A)

`a2a_register`

`a2a_delegate`

Ver También