Ferramentas de Design & Planejamento (Stream D)

As ferramentas do Stream D transformam specs aprovadas em artefatos de implementação acionáveis — schemas, contratos de UI, decisões de arquitetura, planos de execução, contratos de eventos e muito mais.

Referência Rápida

Ferramenta	Descrição	Disponibilidade
`generate_adr`	Gere um Architecture Decision Record para uma decisão técnica significativa	Incluída
`log_decision`	Registre, liste, pesquise ou substitua decisões arquiteturais e de processo	Incluída
`design_schema`	Projete e valide schemas de dados para sua aplicação	Incluída
`define_ui_contract`	Defina e gerencie contratos de componentes de UI para fluxos de design-para-código	Incluída
`event_contracts`	Defina e gerencie contratos de arquitetura orientada a eventos	Incluída
`generate_execution_plan`	Crie um plano de execução passo a passo para implementar uma spec	Incluída
`generate_orchestration_script`	Gere um script para orquestração de execução multi-agente	Incluída
`recommend_model`	Recomende o melhor tier de modelo de IA para uma tarefa	Incluída
`plan_team_distribution`	Planeje como distribuir specs aprovadas entre uma equipe de agentes Claude Code	Incluída
`generate_spec_from_design`	Gere uma spec Planu a partir de uma descrição de design UI/UX	Incluída
`contribute_context`	Contribua contexto adicional para uma spec de fontes externas	Incluída
`request_context`	Solicite contexto adicional ou expertise da base de conhecimento	Incluída
`generate_proposal`	Gere uma proposta de projeto HTML autossuficiente com grade de KPIs e gráfico de Gantt	Incluída
`generate_docs_site`	Gere um site de documentação HTML estático a partir de specs do projeto	Incluída
`data_governance`	Configure políticas de governança de dados e regras de classificação de dados	Incluída
`legal_compliance_report`	Gere um relatório de conformidade para requisitos legais e regulatórios	Incluída
`federate_specs`	Vincule uma spec do projeto atual a uma spec de outro repositório local	Incluída
`federation_status`	Mostre todos os links de federação de specs entre repositórios e sua saúde	Incluída
`discover_registry`	Leia e valide um manifesto `.well-known/planu.json` de um caminho de arquivo local	Incluída
`publish_registry`	Gere um manifesto `.well-known/planu.json` a partir das specs do seu projeto	Incluída
`registry_publish`	Publique uma spec no registro do Planu	Incluída
`registry_login`	Autentique-se no registro de specs do Planu usando um token de API	Incluída
`registry_logout`	Remova as credenciais armazenadas do registro	Incluída
`registry_whoami`	Mostre o usuário autenticado atualmente no registro	Incluída
`a2a_register`	Registre o Planu como um agente com capacidade A2A (Agent-to-Agent)	Incluída
`a2a_delegate`	Delegue uma tarefa relacionada a spec para outro endpoint de agente A2A	Incluída

Decisões de Arquitetura

`generate_adr`

Gere um Architecture Decision Record (ADR) para uma decisão técnica significativa.

O que produz: Documentos ADR estruturados cobrindo o contexto da decisão, opções consideradas, decisão tomada e consequências. O formato segue MADR (Markdown Architectural Decision Records).

Quando usar: Quando uma spec envolve uma escolha tecnológica significativa, padrão de arquitetura ou trade-off que desenvolvedores futuros precisam entender.

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

Exemplo de saída:

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`

Registre, liste, pesquise ou substitua decisões arquiteturais e de processo no log de decisões do projeto.

Ações disponíveis: log, list, search, supersede

Quando usar: Para manter um registro pesquisável de decisões tomadas durante o projeto — quem decidiu o quê, por quê e quando. Substitua uma decisão anterior quando a equipe mudar de direção.

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`

Projete e valide schemas de dados para sua aplicação.

O que produz:

Definições de tabelas com colunas, tipos e restrições
Relacionamentos de chaves primárias e estrangeiras
Sugestões de índices para performance de consultas
Dicas de migração
Schema em múltiplos dialetos (SQL, Prisma, SQLAlchemy, GORM, etc.)

Quando usar: Quando uma spec envolve persistência de dados e você precisa de um ponto de partida concreto para a camada de banco de dados.

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

`define_ui_contract`

Defina e gerencie contratos de componentes de UI para fluxos de design-para-código.

O que produz:

Definições de interface de componentes (props, eventos, slots)
Diagrama de fluxo de dados (quais componentes gerenciam qual estado)
Abordagem de gerenciamento de estado (local, contexto, store)
Contrato de API entre frontend e backend
Requisitos de acessibilidade

Quando usar: Para qualquer spec que inclua um componente frontend, formulário ou interação do usuário.

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

`event_contracts`

Defina e gerencie contratos de arquitetura orientada a eventos — gere contratos de eventos com JSON Schema para validação produtor/consumidor.

O que produz:

Definições de JSON Schema para cada tipo de evento
Contrato do produtor (o que o emissor garante)
Contrato do consumidor (o que o assinante espera)
Estratégia de versionamento
Notas de compatibilidade retroativa

Quando usar: Para qualquer spec que envolva filas de mensagens, barramentos de eventos (Kafka, RabbitMQ, AWS SQS/SNS, NATS) ou integrações de webhook.

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

Exemplo de saída:

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" }
  }
}

Planejamento de Execução

`generate_execution_plan`

Crie um plano de execução detalhado e passo a passo para implementar uma spec — ciclo RED/GREEN/VERIFY com etapas paralelizáveis.

O que produz:

markdown

## Fase 1: Fundação (paralelo)
- [ ] Etapa 1a: Criar migração de banco de dados
- [ ] Etapa 1b: Definir interfaces TypeScript
- [ ] Etapa 1c: Escrever testes com falha (RED)

## Fase 2: Implementação (sequencial)
- [ ] Etapa 2a: Implementar camada de repositório (GREEN)
- [ ] Etapa 2b: Implementar camada de serviço

## Fase 3: Verificação
- [ ] Etapa 3a: Executar suite de testes completa (VERIFY)
- [ ] Etapa 3b: Atualizar status da spec para review

Quando usar: Antes de começar a implementação. O PLAN.md se torna o contrato de implementação para o agente de IA ou desenvolvedor.

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

`generate_orchestration_script`

Gere um script para orquestração de execução multi-agente — cria um script de automação paralela de 3 camadas usando worktrees e claude -p.

O que produz: Um script shell que:

Cria git worktrees isolados por spec
Lança workers claude -p em paralelo
Gerencia alocação de recursos com base em CPU e RAM disponíveis
Monitora saúde dos workers e trata falhas

Quando usar: Quando você precisa implementar múltiplas specs independentes simultaneamente e quer máximo paralelismo.

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

`recommend_model`

Recomende o melhor tier de modelo de IA (haiku, sonnet ou opus) para uma tarefa com base em complexidade, custo e requisitos de capacidade.

O que avalia:

Complexidade da tarefa (geração simples de código vs. decisões de arquitetura)
Restrições de custo
Requisitos de velocidade
Profundidade de raciocínio necessária

Quando usar: Ao escolher entre modelos de IA para implementação, code review ou geração de specs.

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

`plan_team_distribution`

Planeje como distribuir specs aprovadas entre uma equipe de agentes Claude Code — atribui specs a agentes com base em dependências, propriedade de arquivos e restrições de paralelismo.

O que produz:

Tabela de atribuição de agentes (qual agente trata quais specs)
Grafo de dependências para determinar sequenciamento
Mapa de propriedade de arquivos para evitar conflitos
Prompts prontos para uso de spawn de agentes

Quando usar: Ao implementar múltiplas specs em paralelo com uma equipe de agentes. Previne conflitos de arquivos e trabalho desperdiçado.

TIP

Execute plan_team_distribution antes de lançar qualquer equipe de agentes. Ele detecta conflitos de propriedade de arquivos que de outra forma causariam pesadelos de merge.

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

Design a Partir de Entrada

`generate_spec_from_design`

Gere uma spec Planu a partir de uma descrição de design UI/UX — converte wireframes, descrições de mockups ou notas de design em critérios de aceitação estruturados.

Quando usar: Quando um designer entrega uma descrição ou imagem de uma UI e você precisa transformá-la em uma spec construível antes da implementação.

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`

Contribua contexto adicional para uma spec de fontes externas ou expertise de domínio — anexa conhecimento estruturado a uma spec existente.

Quando usar: Quando um especialista no assunto (jurídico, segurança, conformidade) precisa adicionar restrições a uma spec que o autor original não tinha.

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

`request_context`

Solicite contexto adicional ou expertise da base de conhecimento — consulta padrões aprendidos, decisões passadas e conhecimento de domínio relevante para uma spec.

Quando usar: Antes de escrever uma spec em um domínio desconhecido para trazer restrições e padrões relevantes de projetos anteriores.

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

Exportação & Documentação

`generate_proposal`

Gere uma proposta de projeto HTML autossuficiente com grade de KPIs, gráfico de Gantt, tabela de breakdown de specs, análise de riscos, resumo de orçamento e visão geral de arquitetura.

O que produz: Um único arquivo HTML portátil pronto para compartilhar com clientes ou stakeholders — sem servidor necessário.

Quando usar: Ao apresentar um plano de projeto para stakeholders não técnicos ou potenciais clientes.

Prompt: "Generate a project proposal for project proj_abc123"

`generate_docs_site`

Gere um site de documentação HTML estático a partir de specs do projeto, catálogo de ferramentas, diagramas de arquitetura e métricas.

O que produz:

Um site HTML navegável cobrindo todas as specs, seus status e critérios de aceitação
Diagramas de arquitetura derivados do grafo de specs
Catálogo de ferramentas pesquisável
Exportável para hospedagem em qualquer servidor estático

Quando usar: Quando um projeto precisa de documentação viva que permanece sincronizada com as specs.

Prompt: "Generate a documentation site for project proj_abc123"

Governança & Conformidade

`data_governance`

Configure políticas de governança de dados e regras de classificação de dados para o projeto.

O que produz:

Taxonomia de classificação de dados (público, interno, confidencial, restrito)
Políticas de governança por classe de dados
Tagging no nível de specs para requisitos de tratamento de dados
Detecção de violações em specs e código futuros

Quando usar: Para projetos que lidam com dados sensíveis — saúde, finanças, jurídico ou qualquer indústria regulamentada.

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

`legal_compliance_report`

Gere um relatório de conformidade para requisitos legais e regulatórios — mapeia specs e implementação para cláusulas específicas de regulamentação.

O que produz:

Relatório de cobertura por regulamentação (GDPR, HIPAA, SOC 2, PCI DSS, etc.)
Lacunas abertas que precisam de remediação
Links de evidências para specs e eventos do log de auditoria
Exportável para revisão jurídica

Quando usar: Antes de uma auditoria de conformidade ou ao preparar pacotes de evidências para certificação.

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

Federação & Registro

A federação permite vincular specs entre repositórios. O registro permite publicar e descobrir specs para reutilização entre equipes e organizações.

`federate_specs`

Vincule uma spec do projeto atual a uma spec de outro repositório local — cria um link de dependência entre repositórios.

Quando usar: Em configurações monorepo ou multi-repo onde a spec de um projeto depende da spec de outro projeto.

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

`federation_status`

Mostre todos os links de federação de specs entre repositórios e sua saúde — verifica se as specs vinculadas ainda existem e estão sincronizadas.

Prompt: "Show federation status for project proj_abc123"

`discover_registry`

Leia e valide um manifesto .well-known/planu.json de um caminho de arquivo local — mostra quais specs um projeto expõe para reutilização.

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

`publish_registry`

Gere um manifesto .well-known/planu.json a partir das specs do seu projeto — torna suas specs descobríveis por outros projetos.

Prompt: "Publish registry manifest for project proj_abc123"

`registry_publish`

Publique uma spec no registro do Planu para que outras equipes possam descobri-la e reutilizá-la.

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

`registry_login`

Autentique-se no registro de specs do Planu usando um token de API.

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

`registry_logout`

Remova as credenciais do registro armazenadas na máquina local.

Prompt: "Log out of the Planu registry"

`registry_whoami`

Mostre o usuário autenticado atualmente no registro.

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

Agent-to-Agent (A2A)

O A2A permite que o Planu participe de ecossistemas multi-agente — registrando-se como um agente capaz e delegando tarefas para outros agentes especializados.

`a2a_register`

Registre o Planu como um agente com capacidade A2A (Agent-to-Agent) — publica as capacidades do Planu em um endpoint A2A para que outros agentes possam descobri-lo e delegar tarefas a ele.

Quando usar: Ao integrar o Planu em um pipeline multi-agente onde outros orquestradores precisam saber o que o Planu pode fazer.

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

`a2a_delegate`

Delegue uma tarefa relacionada a spec para outro endpoint de agente A2A — envia uma solicitação de tarefa estruturada para um agente externo e recebe o resultado.

Quando usar: Quando outro agente especializado (ex., um agente de code review, um agente de deployment) deve tratar uma etapa no fluxo de trabalho do Planu.

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

Veja Também

Ferramentas de Ciclo de Vida de Specs (Stream B) — criar, atualizar e gerenciar specs
Ferramentas de Análise & Estimativa (Stream C) — validar, auditar e aprender com sua base de código
Ferramentas de Plataforma & Operações (Streams E–I) — stack, agentes, git, governança

Ferramentas de Design & Planejamento (Stream D) ​

Referência Rápida ​

Decisões de Arquitetura ​

generate_adr ​

log_decision ​

design_schema ​

define_ui_contract ​

event_contracts ​

Planejamento de Execução ​

generate_execution_plan ​

generate_orchestration_script ​

recommend_model ​

plan_team_distribution ​

Design a Partir de Entrada ​

generate_spec_from_design ​

contribute_context ​

request_context ​

Exportação & Documentação ​

generate_proposal ​

generate_docs_site ​

Governança & Conformidade ​

data_governance ​

legal_compliance_report ​

Federação & 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 ​

Veja Também ​

Ferramentas de Design & Planejamento (Stream D)

Referência Rápida

Decisões de Arquitetura

`generate_adr`

`log_decision`

`design_schema`

`define_ui_contract`

`event_contracts`

Planejamento de Execução

`generate_execution_plan`

`generate_orchestration_script`

`recommend_model`

`plan_team_distribution`

Design a Partir de Entrada

`generate_spec_from_design`

`contribute_context`

`request_context`

Exportação & Documentação

`generate_proposal`

`generate_docs_site`

Governança & Conformidade

`data_governance`

`legal_compliance_report`

Federação & 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`

Veja Também