pnCore – v0.18.7

pnCore ist ein MCP-Server und ein Cursor-Plugin. Es steuert Software‑Delivery als eine Abfolge benannter, mit Gates verwalteter Schritte – nicht als ein einziger langer Chat.

Es bringt Discovery, Planung, Skeptic-Challenge, Design, Audits, Assets und Delivery über eine deterministische workflow_step-Engine – gestützt auf Skills, Agents, Regeln und pn-core://-Resourcen und nicht auf einen Ordner mit Prompts.

Katalog: 170 Skills, 9 öffentliche Agents + 6 interne Orchestrierungs-Agents, 31 sichtbare Slash-Palette-Dateien (30 im Untermenü pn + /pn-Stub) sowie 18 palettenversteckte chirurgische Einzelbefehle (insgesamt 49 Befehlsdateien), 26 MCP-Tools, 16 Workflow-Typen, dazu pn-core://-Ressourcen und Prompts.

Warum es das gibt

Ein einziger Chat kann ein Feature planen, den Code schreiben und dir sagen, dass alles fertig ist – aber dazwischen gibt es keinen Checkpoint. Wenn er Schritt 3 nicht gut übersteht, liesst du im ganzen Transaktionsprotokoll, wo es schiefgelaufen ist. Bittest du, einen Teil neu zu machen, heißt das meist, das Gespräch neu zu beginnen – und der Kontext, der ihn bis dahin getragen hat, ist verschwunden.

pnCore verlagert diese Schrittliste aus dem Chat heraus. workflow_step(type, index, state) führt jeweils einen Schritt aus – Discovery, Plan, Build, Review – und gibt die nächste Instruktion zurück. Eine Skeptic-Prüfung, ein Human-Gate oder workflow_verify entscheidet, ob ein Schritt wirklich bestanden ist – nicht das Modell selbst. Falls die Verbindung abbricht, nehmen workflow_state_save und workflow_state_load den Run genau dort wieder auf, wo er aufgehört hat.

Related MCP server: workflow-mcp

Was es ist

Deterministisch. workflow_step(type, index, state) bestimmt die nächste Anweisung. Schritte werden nicht einfach übersprungen – das Überspringen ist eine Gate-Ermeldung und wird im State protokolliert.

MitGates. Skeptic-, Human- und workflow_verify-Gates sind in der Engine eingebaut. Die Absicht ist full auto, design focused oder involved – involved bedeutet, dass du Discovery, Planung, Vermögensliste und Review erst freigibst, bevor sie ablaufen. – Spezialisten bauen; UI-Assets werden erstellt, wenn im Umfang.

Multi-Surface. Ein gemeinsamer Baum unter packages/pn-core/content/. Der MCP betreibt die Engine in jedem Client. Das Cursor-Plugin ergänzt /-Fähre, Datei-Glob-Rules, Agent-Auswahl und den Stopp-Hook. Pi registriert dieselben 26 Tools nativ.

Resumable. Jeder Run hat eine run_id. Handoff-Linien und Nutzungsstatistiken landen in einer JSONL. Nach einem Abbruch lädst du den State und arbeitest die gleiche Schrittliste weiter ab.

Installation

als Voraussetzung: Node.js 22+.

Rufe zuerst health auf – es sollte Version, calendarDateUtc und Capabilities zurückgeben. Wenn nicht, wird auch alles Weitere (Skills, Agents, workflow_step) nicht geladen.

Cursor – MCP (mit einem Klick)

Oder ergänze manuell in ~/.cursor/mcp.json: GXP1

GIT_TERMINAL_PROMPT=0 und GIT_ASKPASS=echo führen einen schnellen Abbruch aus, wenn git nicht authentifizieren kann (fehlende Zugangsdaten, Rate-Limit oder eine falsche URL). Ohne diese Einstellungen lässt dich eine Zugangsdaten-Abfrage auf gepipeclient stdin in einer Endlos-Ladung bei Cursor hängen.

Cursor – Plugin

Führe von deinem Startverzeichnis aus:

GXP2 Kopiert commands, rules, skills, agents, config und hooks in .cursor/ und .cursor-plugin/. Lade Cursor neu und führe dann /pn-new aus.

MCP oder Plugin? MCP ist die Engine. Das Plugin ist die Cursor-Oberfläche (Slash-Palette, Rules, Agents, Stop-Hook). In Cursor sind beide eingerichtet. Mehr: Plugin vs. MCP.

pi.dev (Pi-Codeagent)

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

Pi hat einen einzelnen Einstiegspunkt /pn. Direkt-Einstieg: /pn pn-build. Native Tools werden per pi install git:…/pnCore oder – nach npm run build:mcp – mit pi install . direkt aus dem Repo-Root installiert. Cursor und Claude Code benutzen weiterhin den stdio-MCP-Server. Siehe ADR-0008 und ADR-0009.

Claude Code

Verwende dasselbe MCP-JSON. Unter Einstellungen → MCP-Server einfügen und aktivieren (ermöglichen). Siehe die MCP-Dokumentation von Anthropic.

Windows-Nutzer, Cloud-Agenten, node‑/Build‑Pfade sowie Timeouts beim ersten npx-Aufruf: packages/pn-core-mcp/README.md. Klon- & Entwicklungs-Anleitung: CONTRIBUTING.md.

Schnellstart

1. MCP und/oder Plugin install (oben).

2. health rufen – Version, UTC‑Datum, Capabilities.

3. Neuesofort starten: /pn-new oder workflow_step("project_kickoff", 0, {}) unter docs/refs/ (Reference).

4. Weiterentwickeln: /pn-build oder workflow_step("full_dev", 0, {}) – skipps Kickoff, wenn das Projekt schon Kontext hat.

5. Vor der Bereitstellung: /pn-deliver oder /pn-frontend-audit.

Erste Nachricht (Copy/Paste):

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.

Antwort bei Schritt 0: Ja, beides. Bei Schritt 1: (3) Involved.

Weitere Promptsnur: docs/how-to-use-guide.md.

Workflowsn (Abläufe)

Also list_workflow_types für genau Schrittzahlen.

Ebenfalls in der Engine: visual_tweak, prompt_optimize, game_feature, engine_feature (Unreal / Godot), fsi_analyst_draft, media_director. Vollständige Detailliste und Aliase siehe list_workflow_types.

Beispiel: full_dev

Die Schritte sind 0-based. Nach =>Resume: workflow_state_save und dann workflow_state_load. Schema: pnpm-node://reference/workflow-state-schema.md.

**Design-First:**einfacher mit workflow_step("design", 0) statt full_dev. Danach Rollout-Datei .pncore-design.md über /pn-setup.

Game / 3D: workflow_step("game_feature", 0) verwenden. For Gesamtbuil, full_dev nutzen.

Was sich dadurch ändert

Hinweis auf drei Begriffsebenen (nicht durcheinanderbringen): liefert on (MVP/Full) , Kontext-Ebene (1–4 Lesetiefe), Model-Stufe (fast / standard / premium / premium_thinking / long_horizon). Schleifen-Orchestrierung per suggest_model_tier mit role: orchestrator –> long_horizon. Siehe pnpm-core://reference/delivery-tier-criteria.md und MCP-Tools.

Lade vor einer Build-Session: pn-core://reference/best-practices.md, pn-core://reference/loop-orchestration-guide.md, pn-core://reference/aesthetics-baseline.md und health für das aktuelle UTC-Datum.

Ehrliche Grenzen

Am besten geeignet: Teams, die mit Cursor auf React, Astro, Next.js, Vanilla-Web, Node-Backends, Three.js / Babylon / Gamedev, n8n und web3 entwickeln. Verzeichnis: docs/plugin-reference.md.

Dokumentation

Skripte

Contributor-Skripte, die lokale MCP-Konfiguration und die Entwicklung von pnCore sind in CONTRIBUTING.md zu finden. Repo-Struktur: docs/folder-structure.md.

Lizenz

MIT — siehe LICENSE.