Pathmode
Construye especificaciones de intención estructuradas mediante conversación de IA socrática. Describe un problema o pega un ticket de soporte — Claude desafía el pensamiento vago, hace preguntas precisas y construye una especificación estructurada. Exporta como intent.md, .cursorrules o CLAUDE.md.
Documentación
@pathmode/mcp-server
Crea especificaciones de intención estructuradas mediante conversación de IA socrática, directamente en tu terminal.
Sin registro. Sin clave API. Solo añade el servidor MCP y empieza a hablar.
Intent Compiler
El Intent Compiler convierte a Claude Code en un socio de pensamiento de producto socrático. Describe un problema, pega un ticket de soporte o explica qué está roto: Claude cuestiona el pensamiento vago, hace preguntas precisas, ejecuta comprobaciones de calidad en vivo sobre campos débiles y construye una especificación estructurada.
> 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?
Cuando la especificación está lista, Claude la guarda como intent.md y opcionalmente la exporta como .cursorrules o CLAUDE.md, para que cada agente de IA en tu proyecto vea la intención como su contexto de implementación.
Inicio rápido
Añade a .claude/settings.json:
{
"mcpServers": {
"pathmode": {
"command": "npx",
"args": ["@pathmode/mcp-server"]
}
}
}
Luego, en Claude Code:
> Help me write an intent spec for [your problem here]
Eso es todo. No se necesita clave API.
Lo que obtienes
intent.md — Especificación estructurada con 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 directivas de agente para 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 — Añade una sección <!-- PATHMODE:START --> para que Claude Code vea la intención en cada conversación.
Paquete de habilidades para Claude Code
El paquete también incluye 7 habilidades de Claude Code que se activan automáticamente según lo que preguntes, sin necesidad de comandos de barra.
| Habilidad | Úsalo cuando |
|---|---|
setup-pathmode-workflow | Configuración inicial del proyecto (comandos de prueba, rastreador de incidencias, convenciones de estado) |
compile-intent | Construir una especificación estructurada de lo que se va a lanzar |
verify-intent | Diseñar el bucle de retroalimentación ejecutable para una especificación |
grill-intent | Probar a fondo una especificación existente para detectar debilidades |
split-intent-to-issues | Dividir una especificación en tickets de Linear / Jira / GitHub Issues |
review-against-intent | Verificar los cambios de código contra los resultados de la intención |
handoff-intent | Registrar decisiones al final de la sesión |
Instala después de ejecutar la configuración de MCP:
npx @pathmode/mcp-server install-skills # project-local (.claude/skills/)
npx @pathmode/mcp-server install-skills --global # global (~/.claude/skills/)
Reinicia Claude Code. Las habilidades se registran al inicio de la sesión y se invocan automáticamente cuando tu solicitud coincide con su descripción. Consulta skills/README.md para más detalles.
Herramientas del Intent Compiler
| Herramienta | Descripción |
|---|---|
intent_save | Guarda una especificación de intención en intent.md en la raíz del proyecto |
intent_export | Exporta como sección .cursorrules o CLAUDE.md |
Prompt del Intent Compiler
| Prompt | Descripción |
|---|---|
compile-intent | Inicia una conversación socrática para construir una especificación de intención |
Funciones de equipo (se requiere clave API)
Para equipos que lanzan productos con agentes de IA, conéctate a tu espacio de trabajo Pathmode para el seguimiento de dependencias, el contexto estratégico y la gobernanza.
Configuración con clave API
Configuración 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 con Claude Code (.claude/settings.json), Claude Desktop (claude_desktop_config.json) y Cursor (.cursor/mcp.json).
Obtén tu clave API en Configuración > Claves API en la aplicación Pathmode.
Modo local (sin conexión)
Lee archivos intent.md desde el directorio de tu proyecto sin clave API:
{
"mcpServers": {
"pathmode": {
"command": "npx",
"args": ["@pathmode/mcp-server", "--local"]
}
}
}
Configuración
| Método | Detalles |
|---|---|
| Variable de entorno | PATHMODE_API_KEY=pm_live_... |
| Archivo de configuración | ~/.pathmode/config.json con apiKey, apiUrl, workspaceId |
| Modo local | Indicador --local — lee intent.md y .pathmode/intents/*.md |
| Sin configuración | El Intent Compiler funciona sin ninguna configuración |
Herramientas de equipo
Gestión de intenciones
| Herramienta | Descripción |
|---|---|
get_current_intent | Obtiene la intención activa (la primera aprobada o la más reciente) |
get_intent | Obtiene una intención por ID con todos los detalles |
list_intents | Lista todas las intenciones, opcionalmente filtradas por estado |
search_intents | Busca intenciones por palabra clave en metas, objetivos y resultados |
update_intent_status | Actualiza el estado de la intención (borrador > validado > aprobado > enviado > verificado) |
log_implementation_note | Registra una decisión técnica o una nota de implementación |
Análisis estratégico
| Herramienta | Descripción |
|---|---|
analyze_intent_graph | Analiza el grafo de dependencias para ruta crítica, ciclos y cuellos de botella |
get_intent_relations | Obtiene el grafo de dependencias de una intención específica |
Contexto y exportación
| Herramienta | Descripción |
|---|---|
export_context | Genera archivos CLAUDE.md, .cursorrules o intent.md. Para claude-md, opcionalmente pasa un ID de producto; para cursorrules/intent-md, el producto se deriva de la intención resuelta |
get_agent_prompt | Obtiene un prompt de ejecución estructurado para una intención |
get_workspace | Obtiene detalles del espacio de trabajo, incluidos estrategia, productos activos y constitución |
get_constitution | Obtiene las reglas de restricción obligatorias del espacio de trabajo |
Prompts de equipo
| Prompt | Descripción |
|---|---|
implement-intent | Flujo de trabajo de implementación completo para una intención específica |
review-risks | Analiza el grafo de intenciones para detectar riesgos arquitectónicos |
what-next | Sugiere la intención de mayor prioridad en la que trabajar a continuación |
Recursos
| URI | Descripción |
|---|---|
intent://current | Intención actualmente activa |
intent://graph | Grafo completo de dependencias de intenciones |
intent://workspace-strategy | Visión del espacio de trabajo, principios y reglas de constitución activas |
Solución de problemas
"No se encontró configuración de Pathmode" Esto ya no causa un error. El Intent Compiler funciona sin ninguna configuración. Las funciones de equipo requieren una clave API.
Las herramientas devuelven "no disponible en modo local"
La mayoría de las herramientas de equipo requieren modo nube. Configura una clave API o usa --local para la lectura básica de intenciones.
Tiempo de espera de conexión agotado
Asegúrate de que tu clave API sea válida y tenga los alcances correctos. Verifica tu conexión de red con pathmode.io.
setup inicia el servidor en lugar del instalador
Usa la versión más reciente del paquete:
npx @pathmode/mcp-server@latest setup pm_live_...
Como alternativa, puedes omitir la configuración por completo estableciendo la clave directamente en la configuración de MCP:
{
"mcpServers": {
"pathmode": {
"command": "npx",
"args": ["@pathmode/mcp-server"],
"env": {
"PATHMODE_API_KEY": "pm_live_..."
}
}
}
}
Política de privacidad
Este servidor MCP se conecta a la API de Pathmode (pathmode.io) para leer y escribir especificaciones de intención, datos del espacio de trabajo y reglas de constitución en nombre del usuario autenticado.
El Intent Compiler funciona completamente sin conexión: no se envían datos a los servidores de Pathmode. Las especificaciones se guardan localmente en el directorio de tu proyecto.
Datos recopilados (solo funciones de equipo): El servidor transmite tu clave API para autenticación y envía/recibe datos del espacio de trabajo a través de la API de Pathmode.
Almacenamiento de datos: El servidor MCP no almacena datos localmente (excepto los archivos intent.md que crea y en modo --local). Los datos persistentes se almacenan en la infraestructura en la nube de Pathmode.
Uso compartido con terceros: No se comparten datos con terceros. El servidor se comunica exclusivamente con la API de Pathmode.
Política de privacidad completa: pathmode.io/privacy
Enlaces
- Página del Intent Compiler — Descripción general y guía de configuración
- Intent Compiler — Configuración interactiva y descripción general del producto
- Pathmode — Plataforma completa para equipos
- Problemas
Licencia
MIT