Pathmode

Construa especificações de intenção estruturadas por meio de conversa com IA socrática. Descreva um problema ou cole um ticket de suporte — Claude desafia pensamentos vagos, faz perguntas pontuais e constrói uma especificação estruturada. Exporta como intent.md, .cursorrules ou CLAUDE.md.

GitHub

Experimente este MCPPatrocinado

Documentação

@pathmode/mcp-server

Crie especificações de intenção estruturadas por meio de conversa de IA socrática — direto no seu terminal.

Sem cadastro. Sem chave de API. Basta adicionar o servidor MCP e começar a conversar.

Intent Compiler

O Intent Compiler transforma o Claude Code em um parceiro socrático de pensamento de produto. Descreva um problema, cole um ticket de suporte ou explique o que está quebrado — o Claude desafia pensamentos vagos, faz perguntas pontuais, executa verificações de qualidade em tempo real em campos fracos e constrói uma especificação estruturada.

> Help me write an intent spec for our checkout flow

  What's broken about it? When you say "checkout flow" — is the whole
  thing failing, or is there one specific moment where users bail?

> Payment step times out and users get confused

  When you say "times out" — is that 5 seconds or 30? And what does
  the user actually see? A spinner? A blank screen? An error?

> About 8 seconds, they see a spinner with no feedback

  Proposed Objective: "Reduce cart abandonment caused by payment step
  timeouts exceeding 3 seconds, where users see a spinner with no
  status feedback or recovery path."

  Does that capture it, or is there more to the pain?

Quando a especificação está pronta, o Claude a salva como intent.md e opcionalmente exporta como .cursorrules ou CLAUDE.md — para que todo agente de IA no seu projeto veja a intenção como contexto de implementação.

Início Rápido

Adicione ao .claude/settings.json:

{
  "mcpServers": {
    "pathmode": {
      "command": "npx",
      "args": ["@pathmode/mcp-server"]
    }
  }
}

Depois, no Claude Code:

> Help me write an intent spec for [your problem here]

Pronto. Nenhuma chave de API necessária.

O Que Você Obtém

intent.md — Especificação estruturada com frontmatter YAML:

---
id: "intent_17291..."
version: 1
status: "draft"
---
# Fix Checkout Payment Timeout

## Objective
Reduce cart abandonment caused by payment step
timeouts exceeding 3 seconds.

## Outcomes
- [ ] Payment completes in under 3 seconds (p95)
- [ ] Users see real-time status during processing
- [ ] Failed payments show actionable error with retry

## Edge Cases
- **Network timeout during payment**: Show retry button, no double-charge
- **Unknown provider status**: Hold order, notify user within 30s

.cursorrules — Formato de diretiva de agente para o Cursor:

# CURRENT OBJECTIVE
You are implementing: "Fix Checkout Payment Timeout"

# SUCCESS OUTCOMES
Your implementation MUST satisfy ALL of these:
- Payment completes in under 3 seconds (p95)
- Users see real-time status during processing
- Failed payments show actionable error with retry

CLAUDE.md — Acrescenta uma seção  para que o Claude Code veja a intenção em toda conversa.

Pacote de Skills para Claude Code

O pacote também inclui 7 skills do Claude Code que são acionadas automaticamente com base no que você pergunta — sem necessidade de comandos de barra.

Skill	Use quando
`setup-pathmode-workflow`	Configuração inicial do projeto (comandos de teste, rastreador de issues, convenções de status)
`compile-intent`	Construção de uma especificação estruturada para o que será entregue
`verify-intent`	Design do ciclo de feedback executável para uma especificação
`grill-intent`	Teste de estresse de uma especificação existente para identificar fraquezas
`split-intent-to-issues`	Divisão de uma especificação em tickets do Linear / Jira / GitHub Issues
`review-against-intent`	Verificação de mudanças de código em relação aos resultados da intenção
`handoff-intent`	Captura de decisões no final da sessão

Instale após executar a configuração do MCP:

npx @pathmode/mcp-server install-skills            # project-local (.claude/skills/)
npx @pathmode/mcp-server install-skills --global   # global (~/.claude/skills/)

Reinicie o Claude Code. As skills são registradas no início da sessão e são invocadas automaticamente quando sua solicitação corresponde à descrição delas. Consulte skills/README.md para detalhes.

Ferramentas do Intent Compiler

Ferramenta	Descrição
`intent_save`	Salva uma especificação de intenção em `intent.md` na raiz do projeto
`intent_export`	Exporta como seção `.cursorrules` ou `CLAUDE.md`

Prompt do Intent Compiler

Prompt	Descrição
`compile-intent`	Inicia uma conversa socrática para construir uma especificação de intenção

Recursos de Equipe (Chave de API Necessária)

Para equipes que entregam com agentes de IA, conecte-se ao seu workspace Pathmode para rastreamento de dependências, contexto estratégico e governança.

Configuração com Chave de API

Configuração automática:

npx @pathmode/mcp-server@latest setup pm_live_...

{
  "mcpServers": {
    "pathmode": {
      "command": "npx",
      "args": ["@pathmode/mcp-server"],
      "env": {
        "PATHMODE_API_KEY": "pm_live_..."
      }
    }
  }
}

Funciona com Claude Code (.claude/settings.json), Claude Desktop (claude_desktop_config.json) e Cursor (.cursor/mcp.json).

Obtenha sua chave de API em Configurações > Chaves de API no aplicativo Pathmode.

Modo Local (Offline)

Leia arquivos intent.md do diretório do seu projeto sem uma chave de API:

{
  "mcpServers": {
    "pathmode": {
      "command": "npx",
      "args": ["@pathmode/mcp-server", "--local"]
    }
  }
}

Configuração

Método	Detalhes
Variável de ambiente	`PATHMODE_API_KEY=pm_live_...`
Arquivo de configuração	`~/.pathmode/config.json` com `apiKey`, `apiUrl`, `workspaceId`
Modo local	flag `--local` — lê `intent.md` e `.pathmode/intents/*.md`
Sem configuração	O Intent Compiler funciona sem qualquer configuração

Ferramentas de Equipe

Gerenciamento de Intenções

Ferramenta	Descrição
`get_current_intent`	Obtém a intenção ativa (primeira aprovada ou a mais recente)
`get_intent`	Obtém uma única intenção por ID com detalhes completos
`list_intents`	Lista todas as intenções, opcionalmente filtradas por status
`search_intents`	Busca intenções por palavra-chave em metas, objetivos e resultados
`update_intent_status`	Atualiza o status da intenção (draft > validated > approved > shipped > verified)
`log_implementation_note`	Registra uma decisão técnica ou nota de implementação

Análise Estratégica

Ferramenta	Descrição
`analyze_intent_graph`	Analisa o grafo de dependências para caminho crítico, ciclos e gargalos
`get_intent_relations`	Obtém o grafo de dependências para uma intenção específica

Contexto e Exportação

Ferramenta	Descrição
`export_context`	Gera arquivos CLAUDE.md, .cursorrules ou intent.md. Para claude-md, opcionalmente passe um ID de produto; para cursorrules/intent-md, o produto é derivado da intenção resolvida
`get_agent_prompt`	Obtém um prompt de execução estruturado para uma intenção
`get_workspace`	Obtém detalhes do workspace, incluindo estratégia, produtos ativos e constituição
`get_constitution`	Obtém regras de restrição obrigatórias para o workspace

Prompts de Equipe

Prompt	Descrição
`implement-intent`	Fluxo de trabalho completo de implementação para uma intenção específica
`review-risks`	Analisa o grafo de intenções para riscos arquiteturais
`what-next`	Sugere a intenção de maior prioridade para trabalhar em seguida

Recursos

URI	Descrição
`intent://current`	Intenção atualmente ativa
`intent://graph`	Grafo completo de dependências de intenções
`intent://workspace-strategy`	Visão do workspace, princípios e regras de constituição ativas

Solução de Problemas

"Nenhuma configuração do Pathmode encontrada" Isso não causa mais erro. O Intent Compiler funciona sem qualquer configuração. Os recursos de equipe exigem uma chave de API.

Ferramentas retornam "não disponível no modo local" A maioria das ferramentas de equipe exige o modo nuvem. Configure uma chave de API ou use --local para leitura básica de intenções.

Tempo limite de conexão Certifique-se de que sua chave de API seja válida e tenha os escopos corretos. Verifique sua conexão de rede com pathmode.io.

setup inicia o servidor em vez do instalador Use a versão mais recente do pacote:

npx @pathmode/mcp-server@latest setup pm_live_...

Como alternativa, você pode ignorar a configuração completamente definindo a chave diretamente na configuração do MCP:

{
  "mcpServers": {
    "pathmode": {
      "command": "npx",
      "args": ["@pathmode/mcp-server"],
      "env": {
        "PATHMODE_API_KEY": "pm_live_..."
      }
    }
  }
}

Política de Privacidade

Este servidor MCP se conecta à API do Pathmode (pathmode.io) para ler e escrever especificações de intenção, dados do workspace e regras de constituição em nome do usuário autenticado.

O Intent Compiler funciona totalmente offline — nenhum dado é enviado aos servidores do Pathmode. As especificações são salvas localmente no diretório do seu projeto.

Dados coletados (somente recursos de equipe): O servidor transmite sua chave de API para autenticação e envia/recebe dados do workspace por meio da API do Pathmode.

Armazenamento de dados: O servidor MCP não armazena dados localmente (exceto arquivos intent.md que ele cria e no modo --local). Os dados persistentes são armazenados na infraestrutura de nuvem do Pathmode.

Compartilhamento com terceiros: Nenhum dado é compartilhado com terceiros. O servidor se comunica exclusivamente com a API do Pathmode.

Política de privacidade completa: pathmode.io/privacy

Licença

MIT