PlanWright

oficial

Tablero de planificación orientado a objetivos para desarrollo liderado por agentes

GitHub

¿Qué puedes hacer con Plan Wright MCP?

Crear y gestionar objetivos — Use planwright_create_objective para definir resultados con criterios de aceptación, luego planwright_schedule_objective para ponerlos en cola para los agentes.
Reclamar y ejecutar trabajo de agentes — Los agentes llaman a planwright_claim_objective para iniciar una ejecución, planwright_append_plan para publicar una descomposición y planwright_request_acceptance cuando estén listos para revisión.
Registrar diferencias y resultados de pruebas — Envíe cambios de código mediante planwright_record_diff y verifique los criterios de aceptación con planwright_submit_test_run.
Verificar desviaciones durante la ejecución — Use planwright_check_alignment para confirmar que el trabajo del agente aún coincide con el objetivo reclamado.
Detectar carencias en la documentación — Llame a planwright_get_doc_suggestions para encontrar archivos de contexto faltantes, luego planwright_push_context_file para completarlos.
Listar errores y carencias de enriquecimiento — Consulte planwright_list_my_bugs para problemas conocidos y planwright_list_unenriched para objetivos que carecen de resúmenes de intención.

Documentación

Planwright

Plano de control para mano de obra de software autónoma.

Planwright es el tablero de planificación nativo por objetivos para el desarrollo de software liderado por agentes. Los humanos definen los resultados en la capa de Objetivos; los agentes de codificación (Claude Code, Cursor, Codex y otros) reclaman trabajo, descomponen tareas, ejecutan y reportan a través de MCP nativo, con cada cambio de estado capturado en un registro de auditoría encadenado con hash y firmado con Ed25519.

Inicio Rápido

Claude Code (recomendado)

claude mcp add planwright https://mcp.planwright.tools/mcp

Tu navegador se abre para iniciar sesión con GitHub. Eso es todo.

Otros Agentes

Consulta las guías completas de configuración de agentes para Cursor, Codex, Claude Desktop y clientes MCP genéricos.

Cómo Funciona

┌─────────────────────────────────────────────────────────────────┐
│                                                                 │
│   PLANNING (Humans)                 EXECUTION (Agents)          │
│                                                                 │
│   "Add OAuth login" ───────┐                                    │
│                            │                                    │
│   create_objective() ──────┤                                    │
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │   BACKLOG    │                            │
│                     └──────┬───────┘                            │
│                            │                                    │
│   schedule_objective() ────┤                                    │
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │  SCHEDULED   │◀── list_objectives()       │
│                     └──────┬───────┘                            │
│                            │                                    │
│                            │── claim_objective() ──────────────▶│
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │ IN PROGRESS  │◀── append_plan()           │
│                     │              │◀── record_diff()           │
│                     └──────┬───────┘                            │
│                            │                                    │
│                            │── request_acceptance() ───────────▶│
│                            ▼                                    │
│                     ┌──────────────┐                            │
│                     │  ACCEPTANCE  │                            │
│                     └──────┬───────┘                            │
│                            │                                    │
│   Human reviews ───────────┤                                    │
│   (web UI)                 │                                    │
│                     ┌──────┴───────┐                            │
│                     │     DONE     │                            │
│                     └──────────────┘                            │
│                                                                 │
│   Every step: hash-chained + Ed25519 signed audit trail         │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Características Principales

Nativo por Objetivos, No Basado en Tareas Sin puntos de historia. Sin gráficos de velocidad. Sin planificación de capacidad. Los agentes descomponen los objetivos en tareas por sí mismos: tú gestionas los resultados, no el esfuerzo.

Registro de Auditoría Inmutable Cada cambio de estado produce un registro de auditoría encadenado con hash y firmado con Ed25519. Sabe exactamente qué planeó el agente, qué cambió y cuándo.

Integración Nativa con MCP Los agentes se conectan a través del Protocolo de Contexto de Modelo, sin necesidad de clientes API personalizados. Funciona con cualquier agente compatible con MCP.

Soporte Multi-Agente Claude Code, Cursor, Codex, Factory, Amp: si habla MCP, puede trabajar desde tu tablero de Planwright.

Archivos de Contexto Sube CLAUDE.md, documentos de arquitectura y especificaciones a Planwright. Los agentes los leen antes de comenzar a trabajar.

Documentación

Ejemplos

Consulta el directorio examples/ para:

Archivos CLAUDE.md de ejemplo para diferentes tipos de proyectos
Estructuras de objetivos de ejemplo
Plantillas de archivos de contexto

Servidor MCP

El servidor MCP de Planwright está alojado y gestionado, no requiere autoalojamiento.

Endpoint	Protocolo
`https://mcp.planwright.tools/mcp`	HTTP Transmisible

La autenticación se maneja mediante OAuth 2.1 con Registro Dinámico de Clientes (RFC 7591). Tu agente abre un navegador para iniciar sesión con GitHub en la primera conexión.

Para entornos de CI/CD y sin interfaz gráfica, genera un token estático en Configuración → Tokens MCP.

Herramientas Disponibles

Planwright expone 30 herramientas MCP para la orquestación de agentes:

Configuración y Contexto

Herramienta	Descripción
`planwright_set_repo`	Establecer el proyecto activo para la sesión (por repositorio de GitHub o ID de proyecto)
`planwright_list_workspaces`	Listar los espacios de trabajo a los que tienes acceso
`planwright_list_projects`	Listar proyectos con IDs y repositorios de GitHub vinculados
`planwright_list_context_files`	Listar CLAUDE.md, especificaciones, documentos de arquitectura del proyecto
`planwright_get_context_file`	Leer un archivo de contexto específico
`planwright_push_context_file`	Subir o actualizar un archivo de contexto
`planwright_get_doc_suggestions`	Obtener sugerencias pendientes de brechas de documentación
`planwright_dismiss_doc_suggestion`	Descartar una sugerencia de documentación
`planwright_get_board_url`	Obtener la URL del tablero de Planwright

Iniciativas

Herramienta	Descripción
`planwright_list_initiatives`	Listar iniciativas (hitos) del espacio de trabajo
`planwright_create_initiative`	Crear una nueva iniciativa
`planwright_update_initiative`	Actualizar metadatos de la iniciativa
`planwright_delete_initiative`	Eliminar una iniciativa

Objetivos

Herramienta	Descripción
`planwright_list_objectives`	Listar objetivos por carril (backlog, programado, en_progreso, aceptación, hecho)
`planwright_get_objective`	Obtener detalles completos del objetivo, incluyendo el historial de ejecución del agente
`planwright_create_objective`	Crear un nuevo objetivo con criterios de aceptación
`planwright_update_objective`	Actualizar metadatos del objetivo
`planwright_schedule_objective`	Mover objetivo del backlog a programado

Flujo de Trabajo del Agente

Herramienta	Descripción
`planwright_claim_objective`	Reclamar un objetivo programado e iniciar una ejecución de agente
`planwright_append_plan`	Publicar el plan de descomposición del agente
`planwright_check_alignment`	Verificar que el trabajo se alinea con el objetivo reclamado (detección de desviación)
`planwright_record_diff`	Registrar resumen de diferencias y resultados de pruebas
`planwright_submit_test_run`	Enviar resultados de verificación de criterios de aceptación
`planwright_request_acceptance`	Mover objetivo al carril de aceptación para revisión humana
`planwright_append_note`	Registrar finalización de tarea en el registro de ejecución del agente
`planwright_flag_clarity`	Marcar objetivo con problemas de claridad
`planwright_override_clarity`	Anulación humana para marcas de claridad

Enriquecimiento y Clasificación

Herramienta	Descripción
`planwright_list_unenriched`	Listar objetivos/iniciativas que carecen de resúmenes de intención
`planwright_list_unclassified`	Listar objetivos que carecen de clasificación estratégica
`planwright_list_my_bugs`	Listar errores para este proyecto

Soporte

Licencia

Planwright es un producto comercial. Los ejemplos de integración MCP en este repositorio se proporcionan bajo la Licencia MIT.

Consulta LICENCIA para más detalles.