PlanWright

oficial

Quadro de planejamento objetivo-nativo para desenvolvimento liderado por agente

GitHub

O que você pode fazer com Plan Wright MCP?

Criar e gerenciar objetivos — Use planwright_create_objective para definir resultados com critérios de aceitação, depois planwright_schedule_objective para colocá-los na fila para os agentes.
Reivindicar e executar trabalho do agente — Os agentes chamam planwright_claim_objective para iniciar uma execução, planwright_append_plan para postar uma decomposição e planwright_request_acceptance quando estiverem prontos para revisão.
Registrar diffs e resultados de teste — Envie alterações de código via planwright_record_diff e verifique os critérios de aceitação com planwright_submit_test_run.
Verificar desvios durante a execução — Use planwright_check_alignment para confirmar que o trabalho do agente ainda corresponde ao objetivo reivindicado.
Identificar lacunas na documentação — Chame planwright_get_doc_suggestions para encontrar arquivos de contexto ausentes, depois planwright_push_context_file para preenchê-los.
Listar bugs e lacunas de enriquecimento — Consulte planwright_list_my_bugs para problemas conhecidos e planwright_list_unenriched para objetivos que não possuem resumos de intenção.

Documentação

Planwright

Plano de controle para mão de obra de software autônoma.

Planwright é o quadro de planejamento nativo por objetivos para desenvolvimento de software liderado por agentes. Humanos definem resultados na camada de Objetivos; agentes de codificação (Claude Code, Cursor, Codex e outros) reivindicam trabalho, decompõem tarefas, executam e reportam de volta via MCP nativo — com cada mudança de estado capturada em uma trilha de auditoria encadeada por hash e assinada com Ed25519.

Início Rápido

Claude Code (recomendado)

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

Seu navegador abre para login no GitHub. Só isso.

Outros Agentes

Consulte os guias completos de configuração de agentes para Cursor, Codex, Claude Desktop e clientes MCP genéricos.

Como 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         │
│                                                                 │
└─────────────────────────────────────────────────────────────────┘

Principais Funcionalidades

Nativo por Objetivos, Não Baseado em Tarefas Sem story points. Sem gráficos de velocidade. Sem planejamento de capacidade. Os próprios agentes decompõem objetivos em tarefas — você gerencia resultados, não esforço.

Trilha de Auditoria Imutável Cada mudança de estado produz um registro de auditoria encadeado por hash e assinado com Ed25519. Saiba exatamente o que o agente planejou, o que mudou e quando.

Integração MCP Nativa Agentes se conectam via Model Context Protocol — sem necessidade de clientes de API personalizados. Funciona com qualquer agente compatível com MCP.

Suporte a Múltiplos Agentes Claude Code, Cursor, Codex, Factory, Amp — se fala MCP, pode trabalhar a partir do seu quadro Planwright.

Arquivos de Contexto Envie CLAUDE.md, documentos de arquitetura e especificações para o Planwright. Os agentes os leem antes de começar o trabalho.

Documentação

Exemplos

Veja o diretório examples/ para:

Exemplos de arquivos CLAUDE.md para diferentes tipos de projeto
Exemplos de estruturas de objetivos
Modelos de arquivos de contexto

Servidor MCP

O servidor MCP do Planwright é hospedado e gerenciado — sem necessidade de auto-hospedagem.

Endpoint	Protocolo
`https://mcp.planwright.tools/mcp`	HTTP Transmissível

A autenticação é feita via OAuth 2.1 com Registro Dinâmico de Cliente (RFC 7591). Seu agente abre um navegador para login no GitHub na primeira conexão.

Para ambientes de CI/CD e headless, gere um token estático em Configurações → Tokens MCP.

Ferramentas Disponíveis

O Planwright expõe 30 ferramentas MCP para orquestração de agentes:

Configuração e Contexto

Ferramenta	Descrição
`planwright_set_repo`	Definir projeto ativo para a sessão (por repositório GitHub ou ID do projeto)
`planwright_list_workspaces`	Listar espaços de trabalho aos quais você tem acesso
`planwright_list_projects`	Listar projetos com IDs e repositórios GitHub vinculados
`planwright_list_context_files`	Listar CLAUDE.md, especificações, documentos de arquitetura do projeto
`planwright_get_context_file`	Ler um arquivo de contexto específico
`planwright_push_context_file`	Enviar ou atualizar um arquivo de contexto
`planwright_get_doc_suggestions`	Obter sugestões pendentes de lacunas de documentação
`planwright_dismiss_doc_suggestion`	Descartar uma sugestão de documentação
`planwright_get_board_url`	Obter a URL do quadro Planwright

Iniciativas

Ferramenta	Descrição
`planwright_list_initiatives`	Listar iniciativas (marcos) do espaço de trabalho
`planwright_create_initiative`	Criar uma nova iniciativa
`planwright_update_initiative`	Atualizar metadados da iniciativa
`planwright_delete_initiative`	Excluir uma iniciativa

Objetivos

Ferramenta	Descrição
`planwright_list_objectives`	Listar objetivos por raia (backlog, agendado, em_progresso, aceitação, concluído)
`planwright_get_objective`	Obter detalhes completos do objetivo, incluindo histórico de execução do agente
`planwright_create_objective`	Criar um novo objetivo com critérios de aceitação
`planwright_update_objective`	Atualizar metadados do objetivo
`planwright_schedule_objective`	Mover objetivo do backlog para agendado

Fluxo de Trabalho do Agente

Ferramenta	Descrição
`planwright_claim_objective`	Reivindicar um objetivo agendado e iniciar uma execução de agente
`planwright_append_plan`	Publicar o plano de decomposição do agente
`planwright_check_alignment`	Verificar se o trabalho está alinhado com o objetivo reivindicado (detecção de desvio)
`planwright_record_diff`	Registrar resumo de diff e resultados de testes
`planwright_submit_test_run`	Enviar resultados da verificação dos critérios de aceitação
`planwright_request_acceptance`	Mover objetivo para a raia de aceitação para revisão humana
`planwright_append_note`	Registrar conclusão de tarefa no log de execução do agente
`planwright_flag_clarity`	Sinalizar objetivo como tendo preocupações de clareza
`planwright_override_clarity`	Substituição humana para sinalizações de clareza

Enriquecimento e Classificação

Ferramenta	Descrição
`planwright_list_unenriched`	Listar objetivos/iniciativas sem resumos de intenção
`planwright_list_unclassified`	Listar objetivos sem classificação estratégica
`planwright_list_my_bugs`	Listar bugs deste projeto

Suporte

Licença

Planwright é um produto comercial. Os exemplos de integração MCP neste repositório são fornecidos sob a Licença MIT.

Veja LICENSE para detalhes.