pnCore — v0.18.7

pnCore は MCP サーバー兼 Cursor プラグインです。長い一続きのチャットではなく、名前付きのゲート付きステップの連続としてソフトウェアデリバリーを実行します。

ディスカバリ、計画、スケプティック・チャレンジ、デザイン、監査、アセット、デリバリーを、決定論的な workflow_step エンジンによって提供します。それは、プロンプトのフォルダではなく、スキル、エージェント、ルール、pn-core:// リソースに支えられています。

カタログ： 170 スキル、9 つの公開エージェント + 6 つの内部オーケストレーションエージェント、31 個の表示可能なスラッシュパレットファイル（pn サブメニューの下の 30 個 + /pn スタブ）+ 18 個のパレット非表示の外科的コマンド（コマンドファイルは合計 49 個）、26 個の MCP ツール、16 種類のワークフロータイプ、さらに pn-core:// リソースとプロンプト。

なぜ存在するのか

単一のチャットは機能を計画し、コードを書き、「完成しました」と伝えることができますが、その間にはチェックポイントがありません。ステップ 3 で問題が起こった場合、どこで発生したかを突き止めるには、トランスクリプト全体を読み直す必要があります。一部分をやり直すように頼むと、通常は会話を最初からやり直すことになり、そこまで到達したコンテキストは失われてしまいます。

pnCore は、そのステップリストをチャットの外に移します。workflow_step(type, index, state) は、一度に 1 ステップ（discovery、plan、build、review）を実行し、次の指示を返します。スケプティックの審査、人間のゲート、workflow_verify が、モデル自身の断言ではなく、ステップが実際に合格したかどうかを決定します。切断された場合、workflow_state_save と workflow_state_load で、実行は中断した場所から再開されます。

Related MCP server: workflow-mcp

それは何か

決定論的。 workflow_step(type, index, state) が次の指示を決定します。ステップは思い込みでスキップされません — スキップはゲートの決定であり、ステートに記録されます。

ゲート付き。 スケプティック、人間、workflow_verify のゲートはエンジンに組み込まれています。意図は full auto、design focused、involved のいずれかです — involved は、ディスカバリ、計画、専門家、レビューを実行する前にあなたが承認することを意味します。

複数サーフェス。 packages/pn-core-mcp/content/ に単一の正規ツリーがあります。MCP はどのクライアントでもエンジンを実行します。Cursor プラグインは / パレット、ファイルグロブルール、エージェントセレクタ、ストップフックを追加します。Pi は同じ 26 ツールをネイティブ登録します。

再開可能。 すべての実行には run_id があります。ハンドオフ行と使用状況は JSONL に記録されます。切断後、ステートを読み込んで同じステップリストから続行します。

インストール

前提条件： Node.js 22+。

最初に health を呼び出します — バージョン、calendarDateUtc、ケーパビリティが返るはずです。返らない場合、下流のもの（スキル、エージェント、workflow_step）も何も読み込まれません。

Cursor — MCP（ワンクリック）

または、~/.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 と GIT_ASKPASS=echo は、git が認証できない場合（認証情報の欠落、レート制限、不正な URL）に即座に失敗させます。これらがないと、パイプされた標準入力での認証プロンプトが表示され、Cursor がずっとロード状態のままになります。

Cursor — プラグイン

対象プロジェクト のディレクトリから：

npx github:perniemann/pnCore plugin-install

コマンド、ルール、スキル、エージェント、設定、フックを .cursor/ と .cursor-plugin/ にコピーします。Cursor をリロードしてから、/pn-new を実行します。

MCP かプラグインか？ MCP はエンジンです。プラグインは Cursor のサーフェス（スラッシュパレット、ルール、エージェント、ストップフック）です。想定される Cursor 設定は両方です。詳細：Plugin vs MCP。

pi.dev（Pi コーディングエージェント）

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

Pi は単一の /pn エントリを表示します。直接起動：/pn pn-build。ネイティブツールは、npm run build:mcp を実行した後、このリポジリのルートから pi install git:…/pnCore または pi install . で同梱されます。Cursor と Claude Code は引き続き stdio MCP サーバーを使用します。ADR-0008 と ADR-0009 を参照してください。

Claude Code

同じ MCP JSON を使います。Settings → MCP Servers でブロックを貼り付け、有効にします。Anthropic の MCP ドキュメント を参照してください。

Windows、Cloud Agents、このチェックアウトの node パス、初回の npx タイムアウトについては、packages/pn-core-mcp/README.md を参照してください。クローンと開発は CONTRIBUTING.md を参照してください。

クイックスタート

1. MCP またはプラグイン（または両方）をインストールします（上記）。

2. health を呼び出します — バージョン、UTC 日付、機能。

3. 新しいリポジトリまたはグリーンフィールド： /pn-new または workflow_step("project_kickoff", 0, {}) — docs/refs/ 配下にディスカバリ、参照、PRD、デザイン文書。

4. ビルドまたは拡張： /pn-build または workflow_step("full_dev", 0, {}) — プロジェクトに既存のコンテキストがあればキックオフをスキップします。

5. 出荷前：/pn-deliver または /pn-frontend-audit。

コピペで最初に送るメッセージ：

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.

ステップ 0 の回答：はい、両方。ステップ 1：（3）Involved。

その他のプロンプト：docs/how-to-use-guide.md。

ワークフロー

実際のステップ数を知るには list_workflow_types を呼び出します。

また、visual_tweak、prompt_optimize、game_feature、engine_feature（Unreal / Godot）、fsi_analyst_draft、media_director も利用できます。完全なテーブルとエイリアスは list_workflow_types を参照してください。

例：full_dev

ツールステップは 0 ベースです。切断後の再開は：workflow_state_save してから workflow_state_load。スキーマは pn-core://reference/workflow-state-schema.md。

Design-first: full_dev の代わりに workflow_step("design", 0) を実行。/pn-setup で .pncore-design.md を読み込みます。

ゲーム / 3D： 機能ループには workflow_step("game_feature", 0) を使用。フルビルドには full_dev を使用し、ディスカバリでスタックを指定します。

変わること

3 つの階層概念（混同しないでください）：配信ティア（MVP/Full）、コンテキストティア（1〜4 の読み取り深度）、モデルティア（fast / standard / premium / premium_thinking / long_horizon）。ループオーケストレーション：role: orchestrator を指定した suggest_model_tier → long_horizon。詳細は pn-core://reference/delivery-tier-criteria.md と MCP ツール を参照してください。

ビルドセッションの前に読み込むこと: pn-core://reference/best-practices.md、pn-core://reference/loop-orchestration-guide.md、pn-core://reference/aesthetics-baseline.md、そして現在のUTC日付の health。

正直な限界

最適: Cursor で React、Astro、Next.js、バニラWeb、Node バックエンド、Three.js / Babylon / ゲーム開発、n8n、web3 に取り組むチーム。一覧: docs/plugin-reference.md。

ドキュメント

スクリプト

コントリビューター向けスクリプト、ローカル MCP 設定、pnCore の開発方法は、CONTRIBUTING.md に記載されています。リポジトリ構成: docs/folder-structure.md

ライセンス

MIT — LICENSE を参照してください。