pnCore — v0.18.7

pnCore es un servidor MCP y un plugin de Cursor. Ejecuta la entrega de software como una secuencia de pasos con nombre y con gates, en lugar de un único chat largo.

Incluye descubrimiento, planificación, reto escéptico, diseño, auditorías, assets y entrega mediante un motor determinista workflow_step, respaldado por skills, agentes, reglas y recursos pn-core://, no por una carpeta de prompts.

Catálogo: 170 skills, 9 agentes públicos + 6 agentes internos de orquestación, 31 entradas visibles en la paleta de comandos (30 bajo el submenú pn + el stub /pn) + 18 comandos quirúrgicos ocultos de la paleta (49 archivos de comando en total), 26 herramientas MCP, 16 tipos de workflow, además de recursos y prompts pn-core://.

Por qué existe

Un único chat puede planear una funcionalidad, escribir el código y decirte que está terminado, pero no hay ningún punto de control intermedio. Si algo se tuerce en el paso tres, tienes que releer toda la transcripción para encontrar dónde. Pedirle que rehaga una parte suele implicar empezar la conversación de nuevo y perder el contexto que lo había llevado hasta ahí.

pnCore saca esa lista de pasos del chat. workflow_step(type, index, state) ejecuta un paso cada vez —descubrimiento, plan, build, revisión— y devuelve la siguiente instrucción. Una pasada escéptica, un gate humano o workflow_verify deciden si un paso ha superado realmente la validación, no solo la palabra del modelo. Si te desconectas, workflow_state_save y workflow_state_load retoman la ejecución justo donde se quedó.

Related MCP server: odin

Qué es

Determinista. workflow_step(type, index, state) decide la siguiente instrucción. Los pasos no se omiten por suposición: saltarse uno es una decisión de gate, registrada en el estado.

Con gates. Los gates de escéptico, humano y workflow_verify están integrados en el motor. El intent pue ser full auto, design focused o involved — involved requerir que apruebes descubrimiento, plan, especialistas y revisión antes de que se ejecuten.

Multisuperficie. Un único árbol canónico en packages/pn-core-mcp/content/. El MCP ejecuta el motor en cualquier cliente. El plugin de Cursor añade la paleta /, los patrones de especificación, selectores y el stop hook. Pi registra las mismas 26 herramientas de forma nativa.

Reanudable. Cada ejecución tiene un run_id. Las líneas de handoff y el uso se registran en JSONL. Tras una desconexión, cargas el estado y continuás con la ejecución misma lista de pasos.

Reanudable. Cada ejecución tiene una run_id. Líneas de traspaso y uso quedan en JSONL. Tras una desconexión, carga el estado y continúa la misma lista de pasos.

Instalación

Requisito previo: Node.js 22 o superior.

Llama primero a health: debe devolver versión, calendarDateUtc y capacidades. Si no lo hace, nada de lo dependiente (skills, agentes, workflow_step) cargará.

Cursor — MCP (un clic)

O añádelo manualmente a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "pn-core": {
      "command": "npx",
      "args": ["-y", "--package=git+https://github.com/perniemann/pnCore.git#main", "--", "pn-core"],
      "env": { "GIT_TERMINAL_PROMPT": "0", "GIT_ASKPASS": "echo" }
    }
  }
}

GIT_TERMINAL_PROMPT=0 y GIT_ASKPASS=echo fallan rápido cuando git no consigue autenticarse (faltan credenciales, demasiadas peticiones o una URL incorrecta). Sin ellos, cuando se solicitan credenciales y la entrada está conectada por stdin, Cursor se queda cargando para siempre.

Cursor — Plugin

Desde el directorio de tu proyecto de destino:

npx github:perniemann/pnCore plugin-install

Copia comandos, reglas, skills, agentes,configuración y hooks en .cursor/ y .cursor-plugin/. Recarga Cursor y ejecuta /pnpm.

¿MCP o plugin? El MCP es el motor. El plugin es la superficie de Cursor (paleta de /, reglas, agentes, stop hook). La configuración esperada en Cursor es utilizar ambos. Detalles: Plugin vs MCP.

pi.dev (Pi coding agent)

pi install git:github.com/perniemann/pnCore@main

Pi muestra una única entrada /pn. Invocación directa: /pn build. Las herramientas nativas se instalan con pi install git:…/pnCore o pi install . desde la raíz de este repo tras npm run build:mcp. Cursor y Claude Code siguen usando el servidor MCP stdio. Consulta ADR-0008 y ADR-0009.

Claude Code

Usa el mismo JSON de MCP, pégalo en Configuración → MCP Servers y actívalo. Consulta la documentación de MCP de Anthropic.

Windows, Cloud Agents, las rutas de node de este checkout y los primeros timeouts con npx: packages/pn-core-mcp/README.md. Para clonar y trabajar en local: CONTRIBUTING.md.

Inicio rápido

1. Instala el MCP y/o el plugin (arriba).

2. Llama a health — versión, fecha UTC y capacidades.

3. Repositorio nuevo (greenfield): /pn-wizard o workflow_step("project_kickoff", 0,{}) — descubrimiento, refs, PRD y diseño en docs/refs/.

4. Construir o ampliar: /pn-build o workflow_step("full_dev", 0,{}) — se omite el kickoff si el proyecto ya tiene contexto.

5. Antes de entregar: pn-deliver o pn-frontend-audit.

Copia y pega este primer mensaje:

pn-new ▲

Build [your-project-name] — [one-line description].
References: [path or "in .ref/"] (pitch, requirements, design assets).
Analyze both: prior art and design.
Intent: Involved — full gates at discovery, plan, specialists, and review.
Delivery tier: full. Design ambition: distinctive.

Paso 0: Sí; ambos. Paso 1: (3) Involved.

Más prompts: docs/how-to-use-guide.md.

Workflows

Consulta list_workflow_types para obtener las cuentas de pasos en vivo.

There are also in the engine: visual_tweak, prompt_optimize, game_feature, engine_feature (Unreal / Godot), fsi_analyst_draft, media_director. More info and aliases:get_message with list_workflow_types.

Ejemplo: full_dev

Los pasos de herramientas son de base 0. Retomar tras una desconexión: workflow_state_save y luego workflow_state_load. Esquema: pn-core://reference/workflow-state-schema.md.

Diseño primero: workflow_step("design", 0) en lugar de full_dev. Carga .pncor design.md mediante pnpm-setup.

Game / 3D: workflow_step("game_feature", 0) para bucles de función. Para builds completos, usa full_dev y nombra tu stack en el descubrimiento.

Qué cambia

Tres niveles de conceptos (no los confundas entre sí): delivery tier (MVP/Full) y context tier (profundidad de lectura 1–4), model tier (fast / standard / premium / premium_thinking / long_horizon). Orquestación de bucle: suggest_model_tier con role: orchestrator → long_horizon. Ver pn-core://reference/delivery-tier-criteria.md y herramientas MCP.

Carga antes de una sesión de compilación: pn-core://reference/best-practices.md, pn-core://reference/loop-orchestration-guide.md, pn-core://reference/aesthetics-baseline.md y health para la fecha UTC actual.

Límites honestos

Mejor encaje: equipos que desarrollan con Cursor, React, Astro, Next.js, web vanilla, backends de Node, Three.js / Babylon / gamedev, n8n y web3. Inventario: docs/plugin-reference.md.

Documentación

Scripts

Los scripts para contribuidores, la configuración local de MCP y cómo desarrollar pnCore están en CONTRIBUTING.md. Estructura del repositorio: docs/folder-structure.md.

Licencia

MIT — ver LICENSE.