pnCore — v0.18.7

pnCore는 MCP 서버이자 Cursor 플러그인입니다. 하나의 긴 채팅 대신, 각 단계에 이름과 게이트가 있는 단계 시퀀스로 소프트웨어 딜리버리를 실행합니다.

디스커버리, 계획, 스켑틱 검증, 디자인, 감사, 에셋, 딜리버리를 결정론적 workflow_step 엔진을 통해 제공합니다. 이 엔진은 프롬프트 폴더가 아니라, 스킬, 에이전트, 규칙, pn-core:// 리소스로 뒷받침됩니다.

카탈로그: 스킬 170개, 공개 에이전트 9개 + 내부 오케스트레이션 에이전트 6개, 표시되는 슬래시 팔레트 파일 31개(pn 하위 메뉴 아래 30개 + /pn 스텁) + 팔레트 숨김 정밀 커맨드 18개(커맨드 파일 총 49개), MCP 도구 26개, 워크플로우 유형 16개, pn-core:// 리소스 및 프롬프트.

왜 필요한가

하나의 채팅으로 기능을 계획하고, 코드를 작성하고, 완료됐다고 말할 수 있습니다. 그러나 그 사이에는 체크포인트가 없습니다. 3단계에서 잘못되면 전체 트랜스크립트를 다시 읽어 어디서 잘못됐는지 찾아야 합니다. 한 부분만 다시 하라고 요청하는 것은 대개 대화를 처음부터 다시 시작하는 것이며, 그 시점까지 만들어 둔 컨텍스트는 사라져 있습니다.

pnCore는 그 단계 목록을 채팅 밖으로 옮깁니다. workflow_step(type, index, state)가 한 번에 한 단계씩 — 디스커버리, 계획, 빌드, 리뷰 — 실행하고 다음 지시를 반환합니다. 스켑틱 검토, 인간 게이트, 또는 workflow_verify가 단계가 실제로 통과했는지를 결정합니다. 모델이 완료했다고 스스로 말하는 것이 아닙니다. 연결이 끊기면 workflow_state_save와 workflow_state_load로 실행을 중단된 지점부터 이어갑니다.

Related MCP server: odin

무엇인가

결정론적. workflow_step(type, index, state)가 다음 지시를 결정합니다. 단계는 추정으로 건너뛰지 않습니다. 건너뛰는 것은 게이트 결정이며 상태에 기록됩니다.

게이트 적용. 스켑틱, 인간 게이트, workflow_verify 게이트가 엔진에 내장되어 있습니다. 실행 의도는 full auto, design focused, involved 중 하나입니다. involved는 디스커버리, 계획, 전문가, 리뷰가 실행되기 전에 직접 승인한다는 뜻입니다.

다중 표면. packages/pn-core-mcp/content/에 하나의 정식 트리가 있습니다. MCP는 모든 클라이언트에서 엔진을 실행합니다. Cursor 플러그인은 / 팔레트, 파일 glob 규칙, 에이전트 선택기, stop 훅을 추가합니다. Pi는 동일한 26개 도구를 네이티브로 등록합니다.

재개 가능. 모든 실행에는 run_id가 있습니다. 핸드오프 라인과 사용량은 JSONL에 기록됩니다. 연결이 끊긴 뒤 상태를 로드하면 동일한 단계 목록을 이어갑니다.

설치

전제 조건: Node.js 18+.

먼저 health를 호출하세요. 버전, calendarDateUtc, capabilities를 반환해야 합니다. 그렇지 않으면 이후의 모든 요소(스킬, 에이전트, 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이 인증을 할 수 없을 때(자격 증명 누락, rate limit, URL 오류) 즉시 실패합니다. 이 설정이 없으면 파이프된 stdin에서 자격 증명 프롬프트가 떠 Cursor가 로딩 화면에 계속 머물 수 있습니다.

Cursor — 플러그인

대상 프로젝트 디렉터리에서:

npx github:perniemann/pnCore plugin-install

.cursor/ 및 .cursor-plugin/에 커맨드, 규칙, 스킬, 에이전트, 설정, 훅을 복사합니다. Cursor를 새로고침한 다음 /pn-new를 실행하세요.

MCP 또는 플러그인? MCP는 엔진입니다. 플러그인은 Cursor 표면입니다(슬래시 팔레트, 규칙, 에이전트, stop 훅). 권장되는 Cursor 설정은 둘 다 사용하는 것입니다. 자세한 내용: 플러그인 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:/gi…/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 날짜, capabilities.

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.

Step 0: Yes, Both라고 답하고, Step 1: (3) Involved라고 답하세요.

프롬프트 더 보기: docs/how-to-use-guide.md.

워크플로우

실시간 단계 수는 list_workflow_types를 호출하세요.

엔진에는 그 외 visual_tweak, prompt_optimize, 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.

디자인 우선: full_dev 대신 workflow_step("design", 0)를 사용하세요. .pncore-design.md은 /pn-setup로 로드합니다.

게임 / 3D: 특성 루프는 workflow_step("game_feature", 0)를 사용하세요. 전체 빌드는 full_dev를 사용하고 스택을 초기 정의에서 명시하세요.

변경 사항

세 가지 티어 개념(혼동하지 마세요): delivery tier(MVP/Full), context tier(1–4 읽기 깊이), model tier(fast / standard / premium / premium_thinking / long_horizon). 루프 내 오케스트레이션: role: orchestrator와 함께 suggest_model_tier → long_horizon. 참조: pn-core://reference/delivery-tier-criteria.md` 및 MCP tools.

빌드 세션을 시작하기 전에 다음을 로드하세요: pn-core://reference/best-practices.md, pn-core://reference/loop-orchestration-guide.md, pn-core://reference/aesthetics-baseline.md, 그리고 현재 UTC 날짜의 health.

솔직한 한계

가장 적합한 팀: React, Astro, Next.js, vanilla web, Node 백엔드, Three.js / Babylon / gamedev, n8n, web3를 Cursor로 빌드하는 팀. 전체 목록: docs/plugin-reference.md.

문서

스크립트

기여자 스크립트, 로컬 MCP 설정, pnCore 개발 방법은 CONTRIBUTING.md에 있습니다. 저장소 구조는 docs/folder-structure.md를 참고하세요.

라이선스

MIT — LICENSE를 참조하세요.