사용 가이드

아이디어만 있으면, 대화로 제품 설계를 끝까지 만들어주는 코치예요. 붙이고 → 로그인 → 시작, 이 흐름이면 돼요.

툴별 연결

쓰는 AI 도구를 고르고, 아래 문장을 그 도구의 채팅에 그대로 붙여 넣어요. 연결과 로그인까지 도구가 안내해요. 한 번 로그인하면 쓰는 동안 계속 유지돼요.

이 문장을 복사해 그 도구의 채팅에 붙여 넣어요

PurplePrint MCP를 Claude Code에 추가해줘.
서버 이름은 purpleprint, transport는 http, URL은 https://app.purpleprint-ai.com/mcp 이야.
전역(user scope)으로 등록하고, ~/.claude.json의 mcpServers.purpleprint에 alwaysLoad: true도 넣어줘
(최신 Claude Code IDE에서 /purpleprint:* 슬래시가 안 보이는 문제를 막는 설정이야). 직접 수정하면 UTF-8 no BOM으로 저장해줘.
/mcp에서 purpleprint Authenticate까지 진행해줘.
⚠️ **슬래시(/purpleprint:*)가 안 보여도 그냥 쓸 수 있어. 연결만 됐으면 "퍼플프린트 시작해줘"라고 자연어로 말하면 pp_start tool로 바로 시작돼.**
슬래시 목록은 편의일 뿐이라, 안 뜬다고 설치를 다시 하거나 붙잡고 있지 말고 자연어로 진행해줘.
인증이 필요한데 화면이 안 뜨면 purpleprint를 껐다 켠 뒤(disable → enable) 다시 확인해줘. 이미 "connected"로 보이면 대개 인증은 끝난 상태야.
그리고 다음에도 자동으로 이어지게 ~/.claude/CLAUDE.md(전역)에 재개 규칙을 추가해줘: 이미 있으면 넘어가고, 기존 내용은 안 건드리고 append만 해줘: "PurplePrint로 설계하던 프로젝트를 이어가는 세션이면 먼저 pp_start로 재개한다. PurplePrint MCP가 연결돼 있지 않으면 그냥 진행하지 말고 '지금 PurplePrint 없이 진행 중'임을 유저에게 먼저 알린다. 그리고 연결 안내(https://www.purpleprint-ai.com/docs#connect)를 보여 주고, 유저가 원하면 연결까지 대신한다(연결 뒤 앱을 다시 열어야 도구가 보인다). 무관한 작업이면 무시한다."
마지막 단계(꼭 해야 해요): 설치·로그인이 끝나면 나에게 이렇게 알려줘. "이제 Claude Code를 다시 시작해 주세요. 터미널이면 지금 세션을 끝내고 claude를 새로 실행하고, VS Code·Cursor 확장이면 창 다시 로드, 데스크톱 앱이면 트레이까지 완전히 종료했다가 다시 열어 주세요. 창만 닫으면 안 되고 완전히 종료했다가 다시 열어야 새 연결이 잡혀요. 다시 열면 "퍼플프린트 시작해줘"라고 말해 주세요." 새 연결은 앱을 다시 열어야 잡히니까, 이 세션에서 바로 확인이 안 돼도 정상이야. 설치를 다시 하지 마.

이 문장을 복사해 그 도구의 채팅에 붙여 넣어요

PurplePrint MCP를 이 에디터에 추가해줘.
서버 이름은 purpleprint, URL은 https://app.purpleprint-ai.com/mcp 이야.
이 툴의 MCP 설정에 remote/http MCP로, 한 프로젝트가 아니라 전역(유저 설정: 예: ~/.cursor/mcp.json, VS Code 유저 settings)으로 등록해줘.
OAuth/authorize 흐름이 필요하면 브라우저 로그인까지 진행하게 안내해줘.
⚠️ **명령 목록이 안 보여도 그냥 쓸 수 있어. 연결만 됐으면 "퍼플프린트 시작해줘"라고 자연어로 말하면 pp_start tool로 바로 시작돼.**
목록은 편의일 뿐이라 안 뜬다고 붙잡고 있지 말고 자연어로 진행해줘.
인증 화면이 필요한데 안 뜨면 purpleprint를 껐다 켠 뒤(disable → enable) 확인해줘. 이미 "connected"면 대개 인증은 끝난 상태야.
그리고 다음에도 자동으로 이어지게 Cursor면 ~/.cursor/rules/purpleprint.mdc(frontmatter alwaysApply: true), VS Code Copilot이면 유저 지침 파일(전역)에 재개 규칙을 추가해줘: 이미 있으면 넘어가고, 기존 내용은 안 건드리고 append만 해줘: "PurplePrint로 설계하던 프로젝트를 이어가는 세션이면 먼저 pp_start로 재개한다. PurplePrint MCP가 연결돼 있지 않으면 그냥 진행하지 말고 '지금 PurplePrint 없이 진행 중'임을 유저에게 먼저 알린다. 그리고 연결 안내(https://www.purpleprint-ai.com/docs#connect)를 보여 주고, 유저가 원하면 연결까지 대신한다(연결 뒤 앱을 다시 열어야 도구가 보인다). 무관한 작업이면 무시한다."
마지막 단계(꼭 해야 해요): 설치·로그인이 끝나면 나에게 이렇게 알려줘. "이제 에디터(Cursor·VS Code)를 완전히 종료했다가 다시 열어 주세요. 창만 닫으면 안 되고 완전히 종료했다가 다시 열어야 새 연결이 잡혀요. 다시 열면 새 채팅에서 "퍼플프린트 시작해줘"라고 말해 주세요." 새 연결은 앱을 다시 열어야 잡히니까, 이 세션에서 바로 확인이 안 돼도 정상이야. 설치를 다시 하지 마.

이 문장을 복사해 그 도구의 채팅에 붙여 넣어요

PurplePrint MCP를 Codex에 추가해줘.
서버 이름은 purpleprint, URL은 https://app.purpleprint-ai.com/mcp 이야.
Codex CLI/IDE가 공유하는 ~/.codex/config.toml에 streamable HTTP MCP로 등록하고 OAuth 로그인까지 진행해줘.
로그인 창은 5분 안에 끝내야 한다고 먼저 알려줘(Codex가 5분만 기다려). 늦어서 "로그인은 끝났어요" 안내나 127.0.0.1 연결 오류가 뜨면 로그인을 한 번 더 시작해줘: 이미 로그인돼 있어서 금방 끝나.
Windows PowerShell에서 codex.ps1 실행정책에 막히면 cmd /c codex mcp ... 형태로 실행해줘.
끝나면 codex mcp list로 등록을 확인해줘. / 메뉴에 /purpleprint:start가 안 떠도 정상이야: 자연어 "PurplePrint 시작해줘"로 pp_start tool을 써.
그리고 다음에도 자동으로 이어지게 ~/.codex/AGENTS.md(전역)에 재개 규칙을 추가해줘: 이미 있으면 넘어가고, 기존 내용은 안 건드리고 append만 해줘: "PurplePrint로 설계하던 프로젝트를 이어가는 세션이면 먼저 pp_start로 재개한다. PurplePrint MCP가 연결돼 있지 않으면 그냥 진행하지 말고 '지금 PurplePrint 없이 진행 중'임을 유저에게 먼저 알린다. 그리고 연결 안내(https://www.purpleprint-ai.com/docs#connect)를 보여 주고, 유저가 원하면 연결까지 대신한다(연결 뒤 앱을 다시 열어야 도구가 보인다). 무관한 작업이면 무시한다."
마지막 단계(꼭 해야 해요): 설치·로그인이 끝나면 나에게 이렇게 알려줘. "이제 Codex를 다시 시작해 주세요. CLI면 지금 세션을 끝내고 새로 실행하고, VS Code 확장이면 창 다시 로드, ChatGPT 데스크톱 앱이면 트레이까지 완전히 종료했다가 다시 열어 주세요. 창만 닫으면 안 되고 완전히 종료했다가 다시 열어야 새 연결이 잡혀요. 다시 열면 새 스레드에서 "PurplePrint 시작해줘"라고 말해 주세요." 새 연결은 앱을 다시 열어야 잡히니까, 이 세션에서 바로 확인이 안 돼도 정상이야. 설치를 다시 하지 마.

이 문장을 복사해 그 도구의 채팅에 붙여 넣어요

PurplePrint MCP를 Antigravity 전역 MCP로 추가해줘.
서버 이름은 purpleprint, URL은 https://app.purpleprint-ai.com/mcp 이야.
~/.gemini/config/mcp_config.json에 serverUrl 방식으로 등록하고, 필요하면 ~/.gemini/antigravity/mcp_config.json도 확인해줘.
등록 후 Settings > Customizations > Installed MCP Servers에서 Refresh하고 Authenticate까지 진행해줘.
그리고 다음에도 자동으로 이어지게 Antigravity가 세션 시작에 읽는 전역 지침 파일(예: ~/.gemini/GEMINI.md 또는 AGENTS.md)(전역)에 재개 규칙을 추가해줘: 이미 있으면 넘어가고, 기존 내용은 안 건드리고 append만 해줘: "PurplePrint로 설계하던 프로젝트를 이어가는 세션이면 먼저 pp_start로 재개한다. PurplePrint MCP가 연결돼 있지 않으면 그냥 진행하지 말고 '지금 PurplePrint 없이 진행 중'임을 유저에게 먼저 알린다. 그리고 연결 안내(https://www.purpleprint-ai.com/docs#connect)를 보여 주고, 유저가 원하면 연결까지 대신한다(연결 뒤 앱을 다시 열어야 도구가 보인다). 무관한 작업이면 무시한다."
마지막 단계(꼭 해야 해요): 설치·로그인이 끝나면 나에게 이렇게 알려줘. "이제 Antigravity를 완전히 종료했다가 다시 열어 주세요. 창만 닫으면 안 되고 완전히 종료했다가 다시 열어야 새 연결이 잡혀요. 다시 열면 "PurplePrint 시작해줘"라고 말해 주세요." 새 연결은 앱을 다시 열어야 잡히니까, 이 세션에서 바로 확인이 안 돼도 정상이야. 설치를 다시 하지 마.

ChatGPT·Claude는 데스크톱 앱에서 써 주세요(ChatGPT 앱의 Codex · Claude 앱의 Claude Code). 웹 브라우저 버전에서는 문서가 저장되지 않아 이어갈 수 없어요.

붙여 넣은 뒤엔 앱을 다시 열어요. 새 연결은 앱을 완전히 종료했다가 다시 열어야 잡혀요(창만 닫으면 안 돼요). 터미널은 새 세션, 에디터 확장은 창 다시 로드, 데스크톱 앱은 트레이까지 종료. 다시 열면 “퍼플프린트 시작해줘”.

로그인 버튼을 누르면 이 화면이 떠요. Google이나 GitHub 한 번이면 끝:

PurplePrint

이어서 진행하려면 로그인이 필요해요.
계정으로 한 번만 확인할게요.

Google로 계속하기

GitHub로 계속하기

어렵거나 막히면 같이 해요. 무료 온보딩 교육 예약에서 화면을 함께 보며 연결을 도와드려요. 혼자 풀어 보려면 트러블슈팅을 봐요.

지원하는 도구

연결 방식은 remote HTTP MCP + OAuth예요. API 키나 설정 비밀이 필요 없어요.

툴	상태	방식
Claude Code	지원됨	URL + `alwaysLoad: true` + `/mcp` Authenticate
Cursor	지원됨	유저 설정에 url + 브라우저 OAuth
VS Code	지원됨	Claude Code · Codex 확장을 얹으면 그대로 연결돼요. 유저 설정에 직접 등록하는 방법은 아래 탭에 (Copilot 자체 연결은 검증 중)
Codex	지원됨	`codex mcp add/login` + 자연어 `pp_*`
Antigravity (구글)	지원됨	config serverUrl → Refresh → Authenticate → 코드 붙여넣기 → 재시작 (아래 상세)
Devin Desktop · Cascade (구 Windsurf) · Devin · Lovable	준비 중	url + OAuth 공식 확인 · 연결 검증 중 (Devin은 조직 권한 필요)
Emergent	검토 중	url 기반 + DCR OAuth (검증 중)

Client UI

툴 안에서는 이 지점을 찾으면 돼요

Claude CodeCursorVS CodeCodexAntigravity

Claude Code

> /mcp

MCP servers

Usage: /mcp [reconnect|enable|disable [<server>|all]]

/mcp

purpleprint

Remote HTTP · OAuth required · alwaysLoad true

filesystem

Connected · local stdio

Running

github

Disabled for this workspace

Disabled

Cursor Settings

Settings / Tools & MCPs

MCP Servers

Ppurpleprint

Remote HTTPS · https://app.purpleprint-ai.com/mcp

OAuth required

Add MCP Server

Remote HTTPSCommand

Server URL https://app.purpleprint-ai.com/mcpHTTP headers Optional key / value rowsClient ID OAuth Client ID (optional)Client Secret OAuth Client Secret (optional)

Edit JSONSave

mcp.json

{
  "servers": {
    "purpleprint": {
      "url": "https://app.purpleprint-ai.com/mcp"
    }
  }
}

The MCP Server Definition 'purpleprint' wants you to authenticate to PurplePrint.

Cancel

Add Client Registration DetailsDynamic Client Registration not supported · Client ID · Client Secret

Codex · config.toml

# ~/.codex/config.toml
[mcp_servers.purpleprint]
url = "https://app.purpleprint-ai.com/mcp"

$ codex mcp add purpleprint --url https://app.purpleprint-ai.com/mcp

$ codex mcp login purpleprint

Opening browser for OAuth...

purpleprint · remote · authenticated

Antigravity · Settings

Installed MCP Servers

Add MCP +Refresh ⟳

purpleprint

› 34 tools enabled

에이전트 없이 직접 설정할래요

Claude Code

터미널에서 전역 등록: claude mcp add --transport http -s user purpleprint https://app.purpleprint-ai.com/mcp
최신 IDE면 ~/.claude.json의 mcpServers.purpleprint에 "alwaysLoad": true 추가: 슬래시가 안 보이는 문제를 막아요.
/mcp 열고 → purpleprint에서 Authenticate → 브라우저 로그인
Claude Code를 다시 시작: 터미널은 세션을 끝내고 claude를 새로 실행, 확장은 창 다시 로드, 데스크톱 앱은 트레이까지 완전히 종료했다가 다시 열기

Cursor · VS Code

유저 설정(~/.cursor/mcp.json 또는 VS Code 유저 settings)에 서버를 등록해요:

{ "mcpServers": {
    "purpleprint": { "url": "https://app.purpleprint-ai.com/mcp" }
} }

연결할 때 브라우저 OAuth가 자동으로 떠요 → 로그인
에디터를 완전히 종료했다가 다시 열기(창만 닫으면 안 돼요) → 새 채팅에서 “퍼플프린트 시작해줘”

Codex

Windows는 cmd /c codex mcp add purpleprint --url https://app.purpleprint-ai.com/mcp → cmd /c codex mcp login purpleprint
슬래시(/purpleprint:*)가 안 떠도 정상: 자연어로 “PurplePrint 시작해줘”라고 하면 pp_start tool을 써요.
로그인 창은 5분 안에 끝내 주세요. Codex가 로그인을 5분만 기다려요. 늦으면 “로그인은 끝났어요” 안내가 떠요. 그때 Codex에서 로그인을 한 번 더 누르면 이미 로그인돼 있어서 금방 끝나요.
Codex를 다시 시작: CLI는 세션을 끝내고 새로 실행, 확장은 창 다시 로드, ChatGPT 데스크톱 앱은 트레이까지 완전히 종료했다가 다시 열기 → 새 스레드에서 “PurplePrint 시작해줘”

빠른 시작: 첫 세션

연결: 툴별 연결에서 쓰는 도구 탭을 골라 문장을 그 도구의 채팅에 붙여 넣어요.
로그인: 브라우저에서 Google/GitHub로 한 번. (쓰는 동안 계속 유지)
재개 규칙: 위 연결 프롬프트가 전역 설정에 “다음에도 이어가기” 규칙을 함께 심어요. 그래서 재부팅하거나 새 세션을 열어도 코치가 자동으로 이어가고, 혹시 PurplePrint가 안 붙어 있으면 먼저 알려줘요.
시작: /purpleprint:start(또는 자연어로 “PurplePrint 시작해줘” → pp_start). 환영 인사가 뜨면 “시작할게요”라고 답하면 Phase 0부터 시작돼요.

이미 적어둔 글·메모·노션이 있으면 같이 붙여넣어요. 핵심을 뽑아 빠진 부분을 거꾸로 채워줘요.

처음 시작하면 대화가 이렇게 흘러가요:

첫 세션

데모예요. 실제론 당신 아이디어로, 당신 툴 안에서 진행돼요. 답이 막히면 “다시”·“더 쉽게”라고만 하면 바로 고쳐줘요.

코치가 해 주는 일

설계를 몰라도 깊이 있게 갈 수 있게, 코치가 먼저 제안하고 문서로 남기고 다시 점검해요. 기능마다 어디서 쓰는지(웹 코치 · AI 도구)와 언제 나오는지를 함께 적었어요.

1순위를 먼저 제안해요

고르라고 묻지 않고 후보와 1순위, 1순위인 이유, 나머지를 뺀 이유(3중 근거)를 먼저 보여 줘요. 맞는지만 확인하면 돼요. 가격·환불·개인정보 수집 범위·제품 방향처럼 당신만 정할 수 있는 결정은 따로 물어요.

Phase 0~9 · 웹 코치 · AI 도구

단계마다 설계 문서가 쌓여요

맥락문서부터 설계문서·구독플랜·UX설계·와이어프레임·디자인시스템·점검로그·마케팅전략·핸드오프·과업정의서까지 단계마다 문서를 만들어요. 당신이 확인한 내용만 확정하고, 단계가 끝나기 전에는 "작성 중"으로 표시해요.

웹 코치 = 문서 탭 · AI 도구 = 작업 폴더의 .md 파일

필요하면 직접 찾아보고 근거를 남겨요

경쟁 서비스, 쓸 사람, 마케팅·시장 진입, 만들 기능에 필요한 자료(GitHub·Reddit 포함)를 코치가 웹에서 찾아 읽고 출처를 문서에 남겨요. 더 깊은 조사는 아래 명령 레퍼런스의 리서치·검증 엔진이 맡아요.

Phase 0~9 · 웹 코치 · AI 도구 · 리서치·검증 엔진 보기 →

설계 지도로 핵심을 한눈에 봐요

문서가 쌓여도 전체가 보이게 밸류 체인·유저 여정·화면·핵심 로직·데이터 관계를 문서에서 바로 지도로 그려요.

웹 코치

핀을 찍어 바로 고치고 이야기해요

지도에서 고칠 자리를 누르고 한 줄 남겨요. 여러 곳에 달아 한 번에 보내면 코치가 그 자리를 짚어 문서를 고치거나, 왜 그렇게 정했는지 같이 이야기해요.

웹 코치

매 세션마다 자동으로 재귀점검해요

한 번 고치고 끝내지 않고, 문서끼리 맞지 않는 곳을 다시 점검해 새 빈틈이 두 번 연속 나오지 않을 때까지 반복해요. 회차는 점검로그에 남아요. AI 도구에 연결해 만드는 동안에는 세션마다 설계 문서·개발 설계·코드가 서로 맞는지도 봐요. 연속 0건은 점검한 범위 안의 결과라, 결함이 없다는 보증은 아니에요.

Phase 6 · 개발 단계

개발 설계의 순서를 먼저 제안해요

서비스 설계를 마치면 무엇부터 설계하고 만들지 후보·1순위와 근거·뺀 이유로 먼저 제안해요. 누가 만들지, 어디까지를 첫 범위로 할지도 함께 정해요.

Phase 8~9

과업정의서로 진행 현황과 백로그를 챙겨요

무엇을 어떤 순서로 만들고 언제 끝났다고 볼지(완료 기준) 과업정의서로 정리해요. 만들기 시작하면 진행률과 진행 현황을 계속 갱신하고, 새로 생긴 할 일은 백로그에 모았다가 과업으로 올려요.

Phase 9 뒤 · 개발 단계

작업의 우선순위를 먼저 제안해요

무엇부터 할지 묻기 전에 1순위와 그 근거, 미룰 일과 그 이유를 먼저 말해요. 세션을 다시 열면 진행 현황과 다음 할 일 하나부터 짚어요.

Phase 9 뒤 · 개발 단계

세션 기억과 컨텍스트 관리는 하네스가 맡아요

CLAUDE.md·AGENTS.md 같은 작업 규칙 파일을 직접 쓰고 고칠 필요가 없어요. 코치가 세션마다 한 장 요약(project-lens)과 과업정의서를 먼저 읽고 이어가고, 대화가 길어지면 정리해서 새 세션으로 넘겨요. 웹 코치는 대화와 문서를 계정에 이어서 보관해요.

AI 도구 · 웹 코치

빌더로 자라는 과정을 보여줘요

설계 문서를 끝낼 때마다 9칸 빌더 레벨이 갱신돼요. 주도 단계·7가지 신호·다음 한 걸음으로 AI를 얼마나 잘 이끄는지, 다음에 무엇을 연습하면 되는지 알려줘요.

웹 코치 · AI 도구 · 빌더 레벨 알아보기 →

Hyper-Review 리포트는 이렇게 읽어요

정체성 판정(한 문장으로 말할 수 있는지) → 설계 구성도(열 가지 요소의 빈 곳) → 구조 지도(뿌리 이슈와 함께 풀리는 이슈) → 근거 캐보기(발견 전부·근본 원인·팀 역량) → 실행·핸드오프(다음 행동·착수 게이트·넘길 메시지) 순서로 보면 돼요.

Hyper-Review · 샘플 리포트 보기 →

Phase 0~9 흐름

PurplePrint의 핵심이에요. 막막한 아이디어 한 줄을 개발 가능한 설계로 바꾸는 10단계 코칭 흐름. 혼자 막막하게 시작하지 않게, 코치가 한 번에 한 단계씩·질문 하나씩 이끌어요. 각 단계는 앞 단계의 결론 위에 쌓여서, 중간이 비지 않게 “왜→누구→무엇→어떻게”의 목적 체인을 잡아가요.

어떻게 진행돼요. 직접 보기

탭을 눌러보세요. 코치가 먼저 닫아주고, 평소 말로 답하고, 마음에 안 들면 반박·토론까지: 이 하나하나가 제품 사용 방식이에요. 일반 AI처럼 “좋아요”만 누르는 게 아니라, 당신이 이끌어요.

빈 화면에서 막막하게 시작하지 않아요. 매 단계 후보와 1순위·근거를 코치가 먼저 제안해요.

purpleprint · 설계 세션

그리고, 끝까지 한 세션을 그대로

위 사용 방식이 실제로 어떻게 이어지는지: “자기소개서 서비스” 한 줄로 Phase 0부터 9까지 한 세션을 통째로 따라가 봤어요. 스크롤하면 한 단계씩 재생되고, 각 단계가 끝나면 그 자리에서 산출물이 나와요.

purpleprint · 설계 세션

산출물Preview

명령 레퍼런스

아래는 슬래시 클라(Claude Code·Cursor) 기준 /purpleprint:<명령> 형식이에요. tool 클라(Codex)는 같은 기능을 pp_<명령>으로 써요. 예: /purpleprint:status = pp_status.

시작 · 진행

`/purpleprint:start`	시작하거나 이어가기. 제일 먼저 쓰는 명령이에요. 처음이면 따뜻한 온보딩으로, 이어가는 거면 지난 Phase·산출물·다음 행동을 서버가 기억해 그 자리부터 재개해요.
`/purpleprint:단계 진행 (0~9)`	단계는 목록에서 고르지 않아요. start로 시작하면 코치가 상태를 보고 맥락(0)·페르소나(1)·문제(2)·기능(3)·UX(4)·와이어프레임(5)·점검(6)·GTM(7)·개발설계(8)·핸드오프(9) 순서대로 이끌어요. 특정 단계로 건너뛰고 싶으면 “Phase 4부터 볼래요”처럼 말하면 돼요.

상태 · 운영

`/purpleprint:status`	지금 어느 Phase까지 왔고, 만든 산출물과 다음 행동이 뭔지 한눈에 보여줘요.
`/purpleprint:list`	지금까지 만든 산출물(맥락문서·설계문서 등) 목록을 보여줘요.
`/purpleprint:help-next-todo`	막힐 때: 지금 상황에서 다음에 할 행동 딱 1개를 짚어줘요.
`/purpleprint:projects`	아이디어가 여러 개라면, 프로젝트 목록을 보고 전환하거나 새로 만들어요.
`/purpleprint:save`	지금 지점을 체크포인트로 저장해요. 다음에 start로 그대로 이어가요.
`/purpleprint:how-to-use`	처음 켰을 때: PurplePrint 사용법을 빠르게 안내해요.
`/purpleprint:manual`	설치·인증·문제 해결을 더 자세히 다루는 매뉴얼. server-health로 안 풀릴 때 봐요.
`/purpleprint:server-health`	“연결은 됐는데 왜 안 되지” 싶을 때: 서버 도달·소스 버전·인증 상태를 자가진단하고 클라별 회복법을 알려줘요.
`/purpleprint:oauth`	내 로그인 상태·등급·체험(trial) 남은 기간을 브리핑해요.
`/purpleprint:handoff`	완성한 설계 산출물을 모아 개발자나 AI에게 그대로 넘길 패키지로 만들어줘요.

성장

/purpleprint:my-growth 설계 문서를 끝낼 때마다 9칸 빌더 레벨이 자동으로 갱신돼요. 따로 부를 필요 없어요. 직접 부르면 지금까지의 대화 로그를 훑어 내 빌더 역량이 어떻게 자랐는지 일자별로 보여줘요. 대화 내용은 안 보고 행동 신호만 봐요(content-free).

Kits

`/purpleprint:engine-list`	설계·개발에 바로 얹을 수 있는 Kit(서비스 설계·개발 설계·웹페이지·앱·마케팅 콘텐츠 템플릿) 목록을 봐요. 코치가 단계에 맞는 Kit을 먼저 권하기도 해요.
`/purpleprint:engine-install`	고른 Kit을 원래 파일 구조 그대로 내 프로젝트 폴더에 받아요. 큰 Kit은 나눠서 받아요. 무료 체험이나 구독 중이면 쓸 수 있어요.

리서치·검증 엔진

PurplePrint 설계 코치는 당신이 답한 내용을 바탕으로 설계를 끌어내요. 하지만 “경쟁사는 실제로 어떻게 하고 있나”, “이 페르소나가 진짜 존재하나” 같은 건 당신 머릿속엔 없는 정보예요. 리서치·검증 엔진이 그 빈칸을 실제 조사·검증으로 메워서, 추측이 아니라 근거 위에 설계가 서게 해줘요.

일반 AI와 근본적으로 다른 점: 일반 AI(ChatGPT·Claude 등)는 “경쟁사 조사해줘”처럼 당신이 일일이 시켜야 하고, 안 시키면 그냥 넘어가요. 퍼플프린트는 Phase 0~9 프레임워크 안에서 필요한 순간에 “지금 이 조사를 하면 좋아요”라고 먼저 제안해요. 무엇을 놓치고 있는지 당신이 몰라도 코치가 선제적으로 짚어주는 게 근본 차이예요.

`/purpleprint:hyper-research`	경쟁 제품·기술·시장을 깊게 조사해요 → “남들은 이 문제를 이미 어떻게 풀었나”를 알고, 베끼지 않을 차별점을 잡을 수 있어요. (주로 Phase 2)
`/purpleprint:hyper-research-marketing`	경쟁사의 채널·카피·콘텐츠·커뮤니티를 조사해요 → 막연히 광고비 쓰지 않고, 통하는 채널·메시지의 근거를 갖고 시작해요. (주로 Phase 6 직후)
`/purpleprint:hyper-research-persona`	가정한 페르소나가 실제로 존재하는지 데이터로 검증해요 → “상상 속 유저”에 베팅하는 위험을 줄이고, 놓친 인접 시장도 찾아요. (주로 Phase 1)
`/purpleprint:hyper-scenario`	그린 설계를 실제 유저가 쓰는 흐름으로 시뮬레이션해요 → 만들기 전에 빠진 시나리오·끊기는 지점을 발견해 재작업을 줄여요. (주로 Phase 5 직후)
`/purpleprint:hyper-research-gtm`	검색 수요·경쟁 채널·런칭 사례를 조사해요 → 출시할 때 어디서·어떻게 첫 유저를 데려올지 전략을 갖고 시작해요. (주로 Phase 7)

호출 방식: 제안을 받아 명령을 부르면 당신의 AI Agent의 웹 능력으로 실행돼요(추가 비용 0). 이때 조사는 분리된 보조 에이전트(Codex)가 맡는 게 기본이에요. 조사 자료가 코치 대화에 쌓이면 그다음 설계 판단이 그 자료에 끌려가서요. Codex 구독이 있으면 코치가 설치·로그인까지 안내하고, 그다음부터는 알아서 돌려 결과만 받아와요(Codex 앱을 따로 켤 필요 없어요). 없거나 모르면 코치가 직접 조사하니 그대로 진행하면 돼요. 원하면 아무 때나 직접 불러도 되고요. 각 줄의 “주로 Phase N”은 가장 잘 맞는 시점이지, 그때만 되는 건 아니에요.

/purpleprint:hyper-review 고티어

① 서비스 설계: 페르소나·밸류체인·수익·UX·보안·팀 역량까지 39개 축으로 빈틈 0건까지 재귀 점검해요. '될 제품인지'를 서버에서 전문가급 깊이로. (주로 Phase 6)

/purpleprint:hyper-review-dar 고티어

② 개발 설계: 아키텍처·계약·데이터 모델을 8개 관점으로 회전하며 심층 점검(DAR). '구조가 무너지지 않는지'를 코드 쓰기 전에. 코드가 아니라 설계 문서만 서버로 가요. (주로 Phase 8)

/purpleprint:hyper-review-code-audit 로컬 실행

③ 코드: 앞선 Review·DAR 리포트를 기준으로 코드가 설계대로 짜였는지 정합을 점검해요. 코드는 서버에 안 보내요(당신의 AI Agent가 로컬에서 실행·비용 0).

세 단계(서비스 설계 → 개발 설계 → 코드)가 하나의 점검 사다리예요. 각 단계는 Ultra로 더 집요하게: 라운드 상한을 풀어 발견이 연속 0건이 될 때까지 재귀해요(더 좋은 AI가 아니라, 더 끝까지 캐는 깊이). 투명하게 알려드려요. Review·DAR는 서버 LLM으로 돌아서, 시작하면 백그라운드에서 보통 20~40분(서비스 설계 점검 기준) 걸리고 토큰도 꽤 써요. 끝나면 이메일로 알려드려요. 대신 시니어 패널급 리포트를 받아요. 진행 상황은 hyper-review-status로 돌리는 중에도 언제든 확인돼요.

Hyper-Review 시리즈를 돌리면 이렇게 진행돼요 (개발 설계 점검 DAR 예시):

purpleprint · Hyper-Review DAR

› pp_hyper_review_dar (개발 설계 문서 입력)

# Hyper-Review DAR(개발 설계 아키텍처 점검)을 시작했어요

- jobId: dar-7f3a… · 모드: dar (개발 설계 문서)

진행/결과는 hyper-review-status로 확인해요.

› pp_hyper_review_status (한참 뒤)

# Hyper-Review 점검 중

- 진행: 라운드 3/8 (관점 회전 심화 점검): 지금까지 발견 7건

- 경과: 약 6분 · 보통 30분 안팎 걸려요

› pp_hyper_review_status (완료 후)

# Hyper-Review 완료

- 발견: 17건 → 핵심 이슈 5개

## 근본 원인

정체성 → 가치사슬 → 비동기 경험 괴리 → 과금 한도 누락 → 관측성 저하

## 핵심 이슈

1. [high] 과금 한도 초과 시 상태 전이 미정의

2. [high] 미터링 원자성 = 관측 grade (billing grade 아님)

3. [medium] 모델 가격 하드코딩 …

## 다음 행동 · 팀 핸드오프 메시지

리포트는 당신 로컬(docs/review/)에 저장돼요. 팀원용·AI용 핸드오프까지 같이 나와요.

데모예요. 실제론 당신 설계 문서로, 위 3형제(서비스 설계 Review · 개발 설계 DAR · 코드 Code Audit)를 같은 방식으로 돌려요. Code Audit만 코드를 서버에 안 보내고 당신의 AI Agent가 로컬에서 점검해요.

프라이버시

어디서 코치를 쓰느냐에 따라 내용이 있는 곳이 달라요. 먼저 어디서 쓰든 같은 네 가지 약속이에요.

AI 학습에 쓰지 않아요

웹 코치와 Hyper-Review의 AI 처리는 모델 학습에 쓰지 않아요. 외부 AI 모델은 입력·출력을 보관하지 않는 무보관(Zero Data Retention) 경로로만 불러요. 처리방침 제6조

쓰는 AI 도구로 하면 내 컴퓨터에 남아요

Claude Code·Cursor 같은 AI 도구에 연결해 쓰면, 코칭 대화와 설계 문서는 내 작업 폴더에만 있고 PurplePrint 서버로 오지 않아요. 처리방침 제5조

만든 설계는 내 것이에요

코치와 만든 맥락문서·설계문서 같은 산출물의 권리는 이용자에게 있어요. 이용약관 제9조

지우면 바로 지워져요

웹 코치에서 프로젝트를 지우면 대화와 설계 문서를 바로 지우고 공유 링크도 멈춰요. 처리방침 제6조의7

무엇이 어디에 있는지 쓰는 곳마다 정확히 정리하면:

AI 도구에서 쓸 때: content-free

Claude Code·Cursor·Codex처럼 내 AI 도구에 연결해 쓰는 경우예요. 당신이 뭘 만드는지·뭐라고 썼는지는 우리 서버가 보지 않아요.

로컬에만: 서버로 안 가요

아이디어·대화 내용·만든 설계 문서(맥락문서·설계문서·UX설계 등) 전부 당신 컴퓨터에만 있어요. 리서치 엔진 결과도: 당신의 AI Agent의 웹 능력으로 실행돼서 내용이 우리 서버를 거치지 않아요.

서버로 가는 것: 진척 메타뿐

“어느 Phase까지 왔는지”, “어떤 명령을 몇 번 썼는지” 같은 진척 신호만 가요. 무슨 아이디어인지, 뭐라고 답했는지 같은 내용은 안 가요. 재개·사용량 관리에 필요한 최소한이에요.

성장 측정(my-growth)도 content-free

빌더 역량은 대화 내용 없이, 행동의 신호(어떤 결정을 스스로 내렸는지 같은)만 집계해서 측정해요. 무슨 말을 했는지는 보지 않아요.

웹 코치에서 쓸 때: 서버에 보관해요

웹 코치는 브라우저에서 설치 없이 쓰는 설계 코치예요. 파일을 둘 내 컴퓨터가 없으니, 문서와 대화를 우리 서버에 둬요.

보관하는 것: 문서와 대화

웹 코치에서 만든 설계 문서와 코치와 나눈 대화(지난 대화 포함)를 우리 서버 저장소에 보관해요. 다시 열면 그 자리부터 이어가기 위해서예요.

AI 처리: 보관하지 않는 경로로만

코치 답을 만들 때 대화가 AI 처리로 가요. 이때 입력과 출력을 보관하지 않는 경로(무보관)만 쓰고, 모델 학습에도 쓰지 않아요.

다른 이용자가 볼 때: 내가 공유한 경우만

다른 이용자는 내가 공유 링크를 만들 때만 볼 수 있어요. 대화는 “대화도 보여 주기”를 켠 링크에서만 보여요.

회사가 볼 때: 정해진 경우만

회사는 원칙적으로 내 내용을 열어 보지 않아요. 내가 해결을 요청했을 때, 장애·보안 대응이 필요할 때, 품질 점검(설정에서 거부할 수 있어요)일 때만 지정된 사람이 보고, 볼 때마다 기록을 남겨요. 처리방침 제6조의10

지우면 바로 지워져요

프로젝트를 지우면 그 프로젝트의 문서와 대화가 바로 지워지고, 그 프로젝트의 공유 링크도 닫혀요. 내용 없는 진척 기록만 남아요.

체험 · 가격 FAQ

개발을 몰라도 되나요?

설계 단계엔 코딩이 필요 없어요. 설계 용어 몰라도 평소 말로 답하면 되고, 매 단계 후보 2~3개와 1순위를 먼저 제안하니까 빈 화면에서 막막하게 시작하지 않아요. 헷갈리면 “다시”·“더 쉽게”라고만 해도 바로 고쳐줘요. 다만 퍼플프린트는 AI 코딩 도구(Cursor·Claude Code 등) 안에서 돌아가요. 그 도구를 이미 쓰고 계신 게 편해요.

이미 적어둔 메모·노션이 있어요.

붙여넣으면 핵심을 뽑아 정규화하고, 빠진 “왜·누구·무슨 문제”를 거꾸로 채워줘요. 처음부터 다시 쓰지 않아도 돼요. 있는 걸 토대로 빈칸만 메워가요.

결과물(산출물)은 어디에 저장되나요?

당신 로컬 프로젝트 폴더에 `.md` 파일로 쌓여요(맥락문서·설계문서·UX설계 등). 다음에 `start`로 이어가면 서버가 지난 지점을 기억해 그 자리부터 재개돼요. 웹 코치에서 만들면 우리 서버에 보관되고, 웹 코치의 문서 탭에서 봐요.

어떤 툴에서 써야 하나요?

Claude Code·Cursor·Codex·Antigravity에서 쓸 수 있어요. VS Code는 Claude Code나 Codex 확장을 얹어서 쓰면 그대로 연결돼요. Devin Desktop·Cascade(구 Windsurf)·Devin·Lovable은 준비 중이고, Emergent는 아직 검증 중이에요. 설치가 번거로우면 웹에서 바로 돌려봐도 돼요. 자세한 연결은 위 [툴별 연결]에 툴별로 정리돼 있어요.

리서치 엔진은 비용이 드나요?

Research·Scenario·Marketing·Persona·GTM 엔진은 당신의 AI Agent가 실행해서 퍼플프린트 쪽 추가 비용은 0이에요. 조사를 Codex 보조 에이전트에 맡기는 경우엔 당신의 Codex 구독으로 돌아가고요(구독이 없으면 코치가 직접 조사해요). 서버 LLM을 쓰는 Hyper-Review(39축)만 고티어예요.

무료인가요?

가입하면 카드 등록 없이 2주 무료 체험이 자동 시작돼요. 이후 베타 가격 $13/mo(정가 $20): 기존 AI 구독 옆에 붙이는 애드온이에요.

로그인은 왜 필요한가요?

계정 식별과 체험/구독 관리를 위한 최소한이에요. Google 또는 GitHub로 한 번 로그인하면 쓰는 동안 계속 유지돼서(적어도 90일) 매번 안 해도 돼요. 처음 가입한 방법 그대로 로그인해요(이메일 로그인은 미리 발급한 계정 전용이에요).

내 아이디어·코드가 서버로 가나요?

AI 도구(Claude Code·Cursor·Codex 등)에서 쓰면 아니요. 대화 내용·산출물은 당신 로컬에만 있고, 서버엔 “어느 Phase까지 왔는지” 같은 진척 메타만 가요(content-free). 웹 코치(브라우저에서 쓰는 코치)는 이어서 쓸 수 있게 문서와 대화를 우리 서버에 보관해요. 자세한 건 위 [프라이버시]에.

Codex 로그인 끝에 “127.0.0.1 연결 거부”가 떠요.

로그인이 5분을 넘기면 Codex가 기다리다 연결을 닫아서 그래요. 계정은 이미 만들어졌으니 Codex에서 로그인을 한 번 더 시작하면 돼요. 이번엔 이미 로그인돼 있어서 금방 끝나요.

Codex에서 슬래시(/)가 안 보여요.

정상이에요. Codex는 tool 표면이라, 자연어로 “PurplePrint 시작해줘”라고 하면 `pp_start` tool을 써요. 막히면 `pp_server_health`로 진단해요.

트러블슈팅

방금 설치했는데 로그인이 안 잡히거나 명령이 없어요

설치한 세션은 새 연결과 로그인을 다시 읽지 않아요. 앱을 완전히 종료했다가 다시 열면 잡혀요. 설치를 다시 할 필요는 없어요.

데스크톱 앱(Claude·ChatGPT·Cursor·Antigravity): 트레이까지 완전히 종료했다가 다시 열기(창만 닫으면 안 돼요)
터미널(Claude Code·Codex CLI): 지금 세션을 끝내고 새로 실행
VS Code·Cursor 안의 확장: 명령 팔레트 → 창 다시 로드

다시 열면 “퍼플프린트 시작해줘”라고 말해요. 그래도 안 되면 아래 항목을 봐요.

로그인 화면에서 “Forbidden”이 뜨거나 비밀번호를 물어요

처음 가입한 방법 그대로 로그인해요. Google로 가입했으면 Google로 계속하기, GitHub로 가입했으면 GitHub로 계속하기예요. 이메일로 계속하기는 PurplePrint가 미리 발급한 계정(심사·운영) 전용이라, Google 계정 주소를 넣으면 막혀요.

다시 로그인해도 같은 오류가 되풀이돼요

AI 도구에 저장된 연결 정보가 오래된 거예요. 재인증을 반복하지 말고 연결을 지웠다가 다시 추가하면 바로 이어져요. 만들던 설계와 계정은 그대로예요.

Claude Code: claude mcp remove purpleprint → claude mcp add --transport http -s user purpleprint https://app.purpleprint-ai.com/mcp → 앱을 완전히 껐다 켜고 /mcp에서 Authenticate
다른 도구(Cursor·Codex 등): MCP 설정에서 PurplePrint를 지웠다가 다시 추가 → 앱 다시 열기 → 로그인

재부팅했더니 PurplePrint 없이 그냥 진행돼요

재부팅하거나 새 세션을 열면 MCP가 자동으로 다시 안 붙을 수 있어요(로그인이 풀리기도 해요). 그러면 나도 모르게 그냥 일반 AI로 진행되기 쉬워요. 겉보기엔 똑같아서 눈치채기 어려워요.

예방: 연결 프롬프트가 전역 설정에 심는 재개 규칙이 있으면, 새 세션에서 코치가 자동으로 pp_start를 부르고, 안 붙었으면 “지금 PurplePrint 없이 진행 중”이라고 먼저 알리고 다시 연결하는 길까지 안내해요. 아직 안 심었으면 홈의 연결 프롬프트를 다시 붙여넣거나, 코치에게 “재개 규칙 심어줘”라고 하면 돼요.

Claude Code 고급: 더 확실히 하려면 ~/.claude/settings.json에 SessionStart hook을 더해요. 세션 시작마다 claude mcp list로 실제 연결 상태를 확인해 미연결이면 결정적으로 알려줘요(rules는 AI 판단, hook은 상태 감지). 코치에게 “PurplePrint 연결 확인 hook 심어줘(node로)”라고 하면 돼요.

다른 컴퓨터에서 이어가고 싶어요

설계 문서는 처음 만든 컴퓨터의 프로젝트 폴더에 있어요. 다른 컴퓨터에서도 같은 문서로 이어가려면 문서를 GitHub 저장소에 올려 두면 돼요. 첫 문서가 생기면 코치가 저장소를 만들어 줄지 한 번 물어봐요(원하지 않으면 그냥 이어가도 돼요).

그 컴퓨터의 AI 도구에 PurplePrint 연결: 위 연결 프롬프트를 붙여넣고 앱을 다시 열어요.
이어가자고 말하기: “[저장소 주소]를 받아서 퍼플프린트로 이어가자”라고 하면 AI 도구가 문서를 받아 이어가요.

웹 화면(브라우저)에서 시작한 프로젝트는 어느 컴퓨터에서든 로그인만 하면 그대로 이어져요.

슬래시 명령(`/purpleprint:*`)이 안 보여요

연결은 됐는데(✓ Connected) 명령이 안 뜨면, 순서대로 해봐요:

Claude Code: ~/.claude.json을 열어 mcpServers.purpleprint 안에 "alwaysLoad": true가 있는지 봐요. 없으면 한 줄 추가. (최신 IDE는 이 값이 없으면 새 창에서 슬래시를 못 띄울 수 있어요.)
다시 불러오기: 창을 새로고침하거나, /mcp 입력 → purpleprint에서 Reconnect. 명령 목록이 다시 로드돼요.
그래도면: 에디터를 완전히 껐다 켜고 새 채팅을 열어요.

disconnect(연결 끊기)는 보통 불필요해요. 서버는 목록을 항상 열어둬서 새로고침/Reconnect면 충분해요.

“연결됨”인데 명령이 안 먹어요 (“인증이 필요해요” / 401)

명령은 떴는데 실행이 막히면 = 토큰이 만료됐거나 안 붙은 것(서버는 정상이에요). 쓰는 툴에서 한 번만 다시 로그인하면 풀려요:

Claude Code: /mcp → purpleprint → Authenticate(또는 Reconnect) → 브라우저 로그인
Cursor: 설정 → Tools & MCP → purpleprint → Authenticate. 연결됨처럼 보이면 Logout 한 번 누른 뒤 다시 로그인
VS Code: MCP Servers에서 purpleprint → Login with PurplePrint
Codex: 새 스레드를 열거나 재시작한 뒤 “PurplePrint 시작해줘”

한 번 로그인하면 쓰는 동안 계속 유지돼요(적어도 90일). 매번 안 해도 돼요.

방금 로그인했는데 첫 실행이 “Auth required”예요

로그인은 됐는데 이미 떠 있던 세션이 새 인증을 아직 못 읽은 거예요(특히 Codex). 새 스레드를 열거나 에디터를 재시작한 뒤 다시 실행하면 풀려요.

Codex에서 슬래시(`/`)가 아예 없어요

정상이에요. Codex는 tool 표면이라 슬래시 대신 자연어로 “PurplePrint 시작해줘”라고 하면 pp_start를 써요. 막히면 pp_server_health로 진단할 수 있어요.

그래도 막히면: server-health(자가진단: 서버 도달·소스 버전·인증 상태 + 클라별 회복법)와 manual(설치·인증·문제 해결 상세 매뉴얼) 명령이 회복 경로를 직접 알려줘요.

사용 가이드

툴별 연결

지원하는 도구

툴 안에서는 이 지점을 찾으면 돼요

MCP servers

MCP Servers

Installed MCP Servers

Claude Code

Cursor · VS Code

Codex

빠른 시작: 첫 세션

코치가 해 주는 일

1순위를 먼저 제안해요

단계마다 설계 문서가 쌓여요

필요하면 직접 찾아보고 근거를 남겨요

설계 지도로 핵심을 한눈에 봐요

핀을 찍어 바로 고치고 이야기해요

매 세션마다 자동으로 재귀점검해요

개발 설계의 순서를 먼저 제안해요

과업정의서로 진행 현황과 백로그를 챙겨요

작업의 우선순위를 먼저 제안해요

세션 기억과 컨텍스트 관리는 하네스가 맡아요

빌더로 자라는 과정을 보여줘요

Hyper-Review 리포트는 이렇게 읽어요

Phase 0~9 흐름

어떻게 진행돼요. 직접 보기

그리고, 끝까지 한 세션을 그대로

명령 레퍼런스

시작 · 진행

상태 · 운영

성장

Kits

리서치·검증 엔진

공유 링크

링크로 보이는 것

보이지 않는 것

누가 볼 수 있나요

지금 상태를 보여 줘요

만료와 중지

프라이버시

AI 학습에 쓰지 않아요

쓰는 AI 도구로 하면 내 컴퓨터에 남아요

만든 설계는 내 것이에요

지우면 바로 지워져요

AI 도구에서 쓸 때: content-free

로컬에만: 서버로 안 가요

서버로 가는 것: 진척 메타뿐

성장 측정(my-growth)도 content-free

웹 코치에서 쓸 때: 서버에 보관해요

보관하는 것: 문서와 대화

AI 처리: 보관하지 않는 경로로만

다른 이용자가 볼 때: 내가 공유한 경우만

회사가 볼 때: 정해진 경우만

지우면 바로 지워져요

체험 · 가격 FAQ

트러블슈팅

방금 설치했는데 로그인이 안 잡히거나 명령이 없어요

로그인 화면에서 “Forbidden”이 뜨거나 비밀번호를 물어요

다시 로그인해도 같은 오류가 되풀이돼요

재부팅했더니 PurplePrint 없이 그냥 진행돼요

다른 컴퓨터에서 이어가고 싶어요

슬래시 명령(/purpleprint:*)이 안 보여요

“연결됨”인데 명령이 안 먹어요 (“인증이 필요해요” / 401)

방금 로그인했는데 첫 실행이 “Auth required”예요

Codex에서 슬래시(/)가 아예 없어요

슬래시 명령(`/purpleprint:*`)이 안 보여요

Codex에서 슬래시(`/`)가 아예 없어요