create-saas-starter-workspace 0.1.0 → 0.1.2

package/CHANGELOG.md

@@ -1,6 +1,19 @@
 # Changelog
 
-## 0.1.0 (미출판)
+## 0.1.2 (미출판)
+
+- 문서·doctor 안내의 점검 명령을 `pnpm run doctor`로 정정 — `doctor`는 pnpm 내장 명령이라 `pnpm doctor`는 우리 스크립트 대신 내장 명령(무출력)을 실행했다.
+
+- doctor [웹]에 Sentry CLI 점검 추가(`sentry-cli info`의 Unauthorized 파싱 — exit 0이어도 미로그인 판별). setup이 Sentry 로그인까지 처리하게 된 변경과 짝.
+
+## 0.1.1 — 2026-06-12
+
+- doctor [공통]에 브릿지 계약 점검 추가: `ssb/`(원본)와 `web/lib/bridge/`·`mobile/src/bridge/` 사본의 byte-동일성을 단언한다. 템플릿 문서들이 약속하던 "CI checksum"(실재하지 않던 게이트)을 doctor 기준으로 전부 정정.
+- 워크스페이스 루트의 자기명칭도 프로젝트 이름으로 렌더: 루트 `package.json`(`<이름>-workspace`)과 `README.md`·`AGENTS.md` 제목. `pnpm run doctor` 등 루트 명령의 출력에 학생 프로젝트명이 보인다.
+- bin이 `dist/` 부재 시(개발 트리 직접 실행) `npm run stage` 안내와 함께 명확히 실패한다.
+- 패키지 내부 레이아웃 정리: 템플릿 SSOT를 패키지 내 `template/`(소스)로 이동, stage 산출물은 `templates/` → `dist/`(표준 src/dist 관례). 소비자(npx) 영향 없음.
+
+## 0.1.0
 
 - 첫 버전. 통합 워크스페이스(web + mobile + ssb + .claude) 생성, 프로젝트 이름 렌더, pnpm 의존성 설치(`--frozen-lockfile`), doctor 자동 실행.
 - `--agent <claude|codex|opencode>` 선택을 `workspace.json`에 기록하고 doctor가 읽는다.

package/README.md

@@ -12,8 +12,9 @@ npx create-saas-starter-workspace@latest my-service
 
 ## 개발 (강사용)
 
-- 템플릿 SSOT는 형제 폴더 `../saas-starter-workspace`입니다. SSOT를 고친 뒤 `npm run stage`로 `templates/workspace`에 동기화합니다. `templates/`를 직접 고치지 마세요.
+- 템플릿 SSOT는 `template/`(편집용 원본)입니다. 고친 뒤 `npm run stage`로 `dist/workspace`(출판용 산출물)에 동기화합니다. `dist/`를 직접 고치지 마세요. `template/`는 `files` 허용목록에 없어 출판되지 않습니다.
 - `npm test`가 stage를 먼저 실행하고, 작업 트리와 출판 채널(tarball) 양쪽을 검증합니다. `prepublishOnly`가 stage·테스트를 강제하므로 출판 시 드리프트가 끼어들 수 없습니다.
-- `.gitignore`·`.npmrc`는 npm pack이 strip하므로 dotless(`gitignore`·`npmrc`)로 스테이지하고 생성기가 복원합니다.
+- `engines`는 `>=20.12`로 둡니다 — npx로 직접 실행하는 사용자를 막지 않기 위한 하한이고, 부트스트랩 경로는 24 LTS를 설치합니다(doctor는 22 미만에 ⚠).
+- `.gitignore`·`.npmrc`는 npm pack이 strip하므로 dotless(`gitignore`·`npmrc`)로 스테이지하고 생성기가 복원합니다. 단 템플릿 루트의 것은 SSOT에서부터 dotless(`template/gitignore`)입니다 — 화이트리스트 방식이라 .gitignore 그대로 두면 이 레포의 git이 템플릿 소스(web/·mobile/)를 추적하지 못하기 때문입니다.
 
 강의 수강생에게 배포되는 패키지입니다. [LICENSE](LICENSE).

package/bin/index.mjs

@@ -15,7 +15,7 @@ import { scaffold } from "../src/scaffold.mjs";
 
 const PKG_ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), "..");
 const pkg = JSON.parse(readFileSync(path.join(PKG_ROOT, "package.json"), "utf8"));
-const TEMPLATE_DIR = path.join(PKG_ROOT, "templates", "workspace");
+const TEMPLATE_DIR = path.join(PKG_ROOT, "dist", "workspace");
 
 const AGENTS = ["claude", "codex", "opencode"];
 
@@ -136,6 +136,10 @@ async function main() {
   process.on("SIGINT", () => process.exit(130));
 
   const opts = parseArgs(process.argv.slice(2));
+  if (!existsSync(TEMPLATE_DIR)) {
+    // 출판본·npm test 경로에서는 항상 존재한다. 개발 트리에서 bin을 직접 실행한 경우뿐.
+    fail("템플릿 산출물(dist/)이 없습니다. 개발 트리에서 직접 실행했다면 먼저 npm run stage 를 실행하세요.");
+  }
   const name = await resolveName(opts.name);
   const dest = path.resolve(process.cwd(), name);
 
@@ -180,7 +184,7 @@ async function main() {
   if (installFailed.length > 0) {
     console.log(`\n⚠ 의존성 설치가 끝나지 않았습니다 (${installFailed.join(", ")}). 이렇게 마무리하세요:`);
     for (const sub of installFailed) console.log(`   cd ${name}/${sub} && pnpm install --frozen-lockfile`);
-    console.log(`   그다음 cd ${name} && pnpm doctor 로 다시 확인합니다.`);
+    console.log(`   그다음 cd ${name} && pnpm run doctor 로 다시 확인합니다.`);
   }
   console.log(`\n다음 단계:`);
   console.log(`   1. cd ${name}`);

package/{templates → dist}/workspace/.claude/skills/bridge-guide/SKILL.md

@@ -6,7 +6,7 @@ user-invocable: false
 
 # 앱↔웹 대화 규격 (ssb 계약)
 
-앱과 웹은 정해진 형식의 메시지로만 대화한다. 그 형식 정의는 양쪽이 똑같은 파일 하나(`src/bridge/contract.ts` + `reader.ts`)로 공유한다. 어긋나면 CI checksum이 막는다.
+앱과 웹은 정해진 형식의 메시지로만 대화한다. 그 형식 정의는 양쪽이 똑같은 파일 하나(`src/bridge/contract.ts` + `reader.ts`)로 공유한다. 어긋나면 워크스페이스 루트의 `pnpm run doctor`가 잡아낸다.
 
 ## 봉투 & 전달 방식
 
@@ -52,7 +52,7 @@ user-invocable: false
 4. inbound라면 `router.ts`의 `handleInbound` switch에 case를 추가한다. UNKNOWN은 그대로 무시되니 안전하다.
 5. 새 능력이면 `capabilities.ts`의 `APP_CAPABILITIES`에 capability 문자열을 추가한다. 웹이 HELLO로 감지한다.
 6. 네이티브 변경이므로 앱을 재빌드한다(OTA 아님 — `eas-deploy-guide`).
-7. 웹과 동기화한다. `contract.ts`·`reader.ts`를 웹 repo에 바이트 단위로 동일하게 복사하고 checksum을 갱신한다. CI가 불일치를 게이트한다.
+7. 동기화한다. 같은 변경을 `ssb/`(원본)와 `web/lib/bridge/`·`mobile/src/bridge/` 세 곳에 바이트 단위로 동일하게 반영하고, 워크스페이스 루트에서 `pnpm run doctor`로 동일성을 확인한다.
 
 > 새 기능은 앱에 먼저 들어가고(HELLO capability), 웹이 나중에 감지해 쓴다. 순서가 어긋나도 웹 코드가 capability 게이트로 막혀 있어 안전하다.
 
@@ -68,4 +68,4 @@ user-invocable: false
 
 ## 어댑터 (웹 측)
 
-웹 repo에는 v1 기준 아무것도 설치돼 있지 않다. Owner가 `docs/web-adapter/`의 `contract.ts`·`reader.ts`·POST 라우트(`route-app-bridge.ts`)·nonce·CSP를 웹 repo에 직접 복사·설치해야 한다(옵트인). 웹이 추가하는 의존성은 `zod` 하나뿐이다. 네이티브·webview 라이브러리는 웹에 들어가지 않는다. 웹은 `window.ReactNativeWebView` 전역으로만 앱에 닿는다. gronxb 등 라이브러리는 기각한다(네이티브-API-소유·monorepo 전제가 web=SSOT와 충돌한다). 설치하더라도 네이티브-소셜 핸드오프는 idToken 획득 코드가 없어 `requestSessionHandoff` 호출자가 여전히 없는 fast-follow 흐름이다.
+계약(`contract.ts`·`reader.ts`)은 이미 `web/lib/bridge/`에 설치돼 있다. 옵트인은 세션 핸드오프 레이어뿐이다 — 네이티브 소셜 로그인을 켤 때만 `docs/web-adapter/`의 POST 라우트(`route-app-bridge.ts`)·nonce·CSP를 웹 repo에 추가한다. 웹이 추가하는 의존성은 `zod` 하나뿐이다. 네이티브·webview 라이브러리는 웹에 들어가지 않는다. 웹은 `window.ReactNativeWebView` 전역으로만 앱에 닿는다. gronxb 등 라이브러리는 기각한다(네이티브-API-소유·monorepo 전제가 web=SSOT와 충돌한다). 설치하더라도 네이티브-소셜 핸드오프는 idToken 획득 코드가 없어 `requestSessionHandoff` 호출자가 여전히 없는 fast-follow 흐름이다.

package/{templates → dist}/workspace/.claude/skills/go-live/SKILL.md

@@ -11,7 +11,9 @@ dev/prod 클라우드 환경을 뚫어 첫 배포를 진행한다. 최신 외부
 
 ## 1. 이름·GitHub repo
 
-이름을 먼저 결정한다. 이후 모든 리소스가 이 이름을 기반으로 한다. private repo를 생성한다. secret scanning push protection은 private free에서 미지원이고 GitHub Advanced Security 유료 기능이다. 9-6에서 점검만 skip한다.
+이름을 먼저 결정한다. 기본값 = 워크스페이스 루트 `workspace.json`의 `name`(생성 시 입력한 프로젝트명). 이후 모든 리소스가 이 이름을 기반으로 한다: GitHub repo = `<name>`, Vercel 프로젝트 = `<name>`, Supabase = `<name>-dev`/`-prod`, Sentry 프로젝트 = `<name>`. **폴더명(`web`)을 리소스 이름으로 쓰지 않는다** — 특히 `vercel link`는 폴더명 `web`을 기본 프로젝트명으로 제안하므로 그대로 수락하지 말고 `<name>`으로 바꾼다. (앱 단계의 mobile repo는 `<name>-app` — package.json·Expo slug와 일치.)
+
+private repo를 생성한다. secret scanning push protection은 private free에서 미지원이고 GitHub Advanced Security 유료 기능이다. 9-6에서 점검만 skip한다.
 
 ## 2. Supabase dev + prod
 

package/{templates → dist}/workspace/.claude/skills/kickoff/SKILL.md

@@ -44,7 +44,7 @@ Owner confirm. 비용을 알린 뒤 계속할지 확정받고서야 다음 단
 
 ## 4. 웹 어댑터 (web/)
 
-계약(`contract.ts`·`reader.ts`)은 이미 `web/lib/bridge/`에 바이트 단위로 동일하게 설치돼 있고(CI checksum이 드리프트를 막는다) 다시 복사하지 않는다. 웹이 앱과 실제로 대화하게 만드는 얇은 옵트인 레이어만 필요할 때 추가한다. 규약·보안 불변식은 인라인하지 않고 `bridge-guide`를 따른다.
+계약(`contract.ts`·`reader.ts`)은 이미 `web/lib/bridge/`에 바이트 단위로 동일하게 설치돼 있고(`pnpm run doctor`가 동일성을 점검한다) 다시 복사하지 않는다. 웹이 앱과 실제로 대화하게 만드는 얇은 옵트인 레이어만 필요할 때 추가한다. 규약·보안 불변식은 인라인하지 않고 `bridge-guide`를 따른다.
 
 세션 핸드오프는 fast-follow다. v1은 호출자가 없다. 기본 로그인은 웹뷰 안의 웹 로그인이 그대로 동작하고, 핸드오프 라우트(POST `/auth/app-bridge` + nonce)는 네이티브 소셜 로그인을 켤 때만 살아난다. 토큰은 브릿지·URL로 보내지 않는다(1회용 nonce만 보낸다).
 

package/{templates → dist}/workspace/.claude/skills/warmup/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: warmup
-description: Verify the AI agent's tools and environment (CLI installs, logins) and install/audit dependencies in web/ (and mobile/ when present), fixing issues where possible. Use when the Owner runs /warmup, just opened the workspace, or before tasks that depend on external CLIs working.
+description: Verify the AI agent's tools and environment (CLI installs, logins) and install/audit dependencies in web/ and mobile/, fixing issues where possible. Use when the Owner runs /warmup, just opened the workspace, or before tasks that depend on external CLIs working.
 ---
 
 # /warmup
@@ -14,7 +14,7 @@ Owner의 행동이 필요한 부분은 AskUserQuestion으로 해결한다.
 ## CLI
 
 - `node` — 현 LTS
-- `pnpm` — latest (워크스페이스는 pnpm 기준 · 각 repo `package.json`의 `packageManager`로 버전 고정)
+- `pnpm` — 10 이상 (각 repo `package.json`의 `packageManager`로 버전 고정)
 - `git`
 - `gh` — 로그인
 - `vercel` — 로그인
@@ -25,9 +25,9 @@ Owner의 행동이 필요한 부분은 AskUserQuestion으로 해결한다.
 
 ## 의존성
 
-워크스페이스 루트의 `package.json`은 `pnpm doctor`(환경 점검) 진입점만 가진다 — 루트에 의존성을 설치하지 않는다. `web/`과 `mobile/`은 각자 독립 프로젝트이므로 의존성도 각자 설치한다.
+워크스페이스 루트의 `package.json`은 `pnpm run doctor`(환경 점검) 진입점만 가진다 — 루트에 의존성을 설치하지 않는다. `web/`과 `mobile/`은 각자 독립 프로젝트이므로 의존성도 각자 설치한다.
 
 - `web/`에서 `pnpm install` 후 `pnpm audit`.
-- `mobile/`이 있으면(앱 단계 이후) `mobile/`에서도 동일하게 한다.
+- `mobile/`에서도 동일하게 한다.
 
 세부 정책은 각 repo의 `.npmrc`와 CI 설정을 따른다. 보안 게이트(cooldown, audit level 등)는 우회하거나 수정하지 않는다.

package/{templates → dist}/workspace/AGENTS.md

@@ -1,4 +1,4 @@
-# saas-starter-workspace
+# my-space — 워크스페이스
 
 서비스들 위의 컨텍스트 레이어. 이 repo의 git은 공유 맥락(에이전트 도구·계약·문서)만 추적한다. `web/`와 `mobile/`은 각자 자기 git·배포를 가진 독립 repo다.
 
@@ -10,7 +10,7 @@
 - `mobile/` — 배포된 web을 WebView로 감싸는 네이티브 셸 (Expo). 자기 git → EAS → 스토어로 배포한다. 웹뷰가 못 메우는 네이티브 공백(푸시·홈 화면 아이콘·오프라인 화면)만 채운다.
 - `ssb/` — web ↔ mobile postMessage 계약의 SSOT. `web/lib/bridge/`와 `mobile/src/bridge/`에 바이트 단위로 동일하게 복사된다.
 - `.claude/` — 에이전트 도구(스킬·설정). 워크스페이스 루트에만 둔다.
-- `scripts/doctor.mjs` — 환경·로그인 점검(`pnpm doctor`). 진단과 안내까지만 하고 자동 수리는 하지 않는다. Owner가 ✗ 해결을 부탁하면 doctor의 → 안내를 따라 수행하고 다시 doctor로 검증한다.
+- `scripts/doctor.mjs` — 환경·로그인 점검(`pnpm run doctor`). 진단과 안내까지만 하고 자동 수리는 하지 않는다. Owner가 ✗ 해결을 부탁하면 doctor의 → 안내를 따라 수행하고 다시 doctor로 검증한다.
 - `workspace.json` — 생성기가 기록한 메타(프로젝트명·선택한 코딩 에이전트). doctor가 읽는다.
 
 ## 불변식

package/{templates → dist}/workspace/README.md

@@ -1,4 +1,4 @@
-# saas-starter-workspace
+# my-space
 
 웹 SaaS를 만들고, 원하면 그대로 스토어 앱으로 감싸는 스타터입니다. 화면·코드·배포는 AI 코딩 에이전트가 맡고, 당신은 무엇을 만들지 정합니다.
 
@@ -11,10 +11,10 @@
 ├── web/      웹 SaaS (Next.js · Supabase · Vercel). 화면·기능·데이터의 본체.
 ├── mobile/   그 웹을 감싸는 스토어 앱 (Expo · EAS).
 ├── ssb/      web ↔ mobile 통신 계약. 손댈 일은 거의 없습니다.
-├── scripts/  환경 점검 도구(`pnpm doctor`).
+├── scripts/  환경 점검 도구(`pnpm run doctor`).
 └── .claude/  에이전트 도구(스킬·설정).
 ```
 
 `web/`과 `mobile/`은 각자 배포되는 독립 프로젝트입니다. 이 워크스페이스는 둘을 잇는 공유 맥락(에이전트 도구·계약)만 둡니다. 에이전트 운영 규칙은 [AGENTS.md](AGENTS.md)에 있습니다.
 
-수강생에게 배포되는 강의용 템플릿입니다. [LICENSE](LICENSE).
+이 워크스페이스는 강의용 템플릿에서 생성되었습니다. [LICENSE](LICENSE).

package/{templates → dist}/workspace/START-HERE.md

@@ -10,7 +10,7 @@
 2. 처음 열면 에이전트가 로그인(구독 계정)을 안내합니다. 한 번만 하면 됩니다.
 3. 그다음부터는 아래 명령을 입력하거나, 평소 말로 부탁하면 됩니다.
 
-> 환경이 멀쩡한지 궁금할 땐 언제든 터미널에서 `pnpm doctor`를 실행하세요. 도구·로그인 상태를 ✓/✗로 보여주고, ✗마다 해결 방법을 알려줍니다.
+> 환경이 멀쩡한지 궁금할 땐 언제든 터미널에서 `pnpm run doctor`를 실행하세요. 도구·로그인 상태를 ✓/✗로 보여주고, ✗마다 해결 방법을 알려줍니다.
 
 ## 2. 명령 순서
 
@@ -37,7 +37,7 @@
 ├── web/      당신의 웹 서비스 (Next.js → Vercel). 모든 화면·기능·데이터의 본체.
 ├── mobile/   그 웹을 감싸는 스토어 앱 (Expo → 앱·플레이스토어). 푸시·홈 화면 아이콘처럼 앱만의 것.
 ├── ssb/      web ↔ mobile이 주고받는 통신 계약. 손대지 않아도 됩니다.
-├── scripts/  환경 점검 도구(`pnpm doctor`).
+├── scripts/  환경 점검 도구(`pnpm run doctor`).
 └── .claude/  위 명령(스킬)이 있는 곳.
 ```
 

package/{templates → dist}/workspace/mobile/README.md

@@ -8,7 +8,7 @@ Owner가 만든 웹을 감싸는 앱(웹뷰 래퍼)입니다. 화면과 기능
 
 - 웹을 고치면 앱도 같이 바뀝니다. 대부분의 변경은 웹만 다시 배포하면 끝이고, 앱을 다시 만들거나 제출할 필요가 없습니다.
 - 셸이 채우는 것: 외부 링크를 모바일 브라우저로 열기, Android 뒤로가기, 카메라·마이크·파일 올리기 권한, 화면 안전 여백, 오프라인 화면, 첫 로딩·크래시 복구 화면. 웹뷰만으로 막히는 네이티브 빈틈만 메웁니다.
-- 소셜 로그인(구글·애플): 웹뷰 안에서도 동작하지만, 앱의 원클릭 경험을 원하면 네이티브 로그인 화면을 따로 구현합니다.
+- 소셜 로그인(구글·애플): 구글 등은 웹뷰 안 로그인 창을 보안 정책으로 차단할 수 있어, 필요하면 외부 브라우저로 열거나 네이티브 로그인 화면(옵트인)을 켭니다.
 
 ## 시작 전에 (한 번만)
 

package/{templates → dist}/workspace/mobile/docs/web-adapter/README.md

@@ -21,7 +21,7 @@
 | `src/bridge/contract.ts` | `lib/bridge/contract.ts` |
 | `src/bridge/reader.ts` | `lib/bridge/reader.ts` |
 
-두 사본은 바이트 단위로 동일해야 한다. 어긋나면 양쪽이 메시지 형태를 다르게 해석해 브릿지가 오작동하므로, CI checksum으로 강제한다.
+두 사본은 바이트 단위로 동일해야 한다. 어긋나면 양쪽이 메시지 형태를 다르게 해석해 브릿지가 오작동하므로, 워크스페이스 루트의 `pnpm run doctor`가 동일성을 점검한다.
 
 ```bash
 cmp -s mobile/src/bridge/contract.ts web/lib/bridge/contract.ts || exit 1

package/{templates/workspace/ssb → dist/workspace/mobile/src/bridge}/contract.ts

@@ -3,8 +3,9 @@ import { z } from "zod";
 /**
  * App ↔ Web bridge contract — SINGLE SOURCE OF TRUTH.
  *
- * This file is copied byte-for-byte into the web project (docs/web-adapter/contract.ts).
- * The two MUST stay identical; the web adapter ships a checksum check to enforce it.
+ * This file is copied byte-for-byte into the web (web/lib/bridge/) and the app
+ * (mobile/src/bridge/). All copies MUST stay identical; `pnpm run doctor` at the
+ * workspace root checks this.
  *
  * Invariants (never break these):
  *  1. Every message is namespaced (`ns: "ssb"`) so unrelated postMessage traffic on

package/{templates → dist}/workspace/package.json

@@ -1,5 +1,5 @@
 {
-  "name": "saas-starter-workspace",
+  "name": "my-space-workspace",
   "version": "0.1.0",
   "private": true,
   "description": "워크스페이스 루트 명령. 서비스 코드는 web/·mobile/이 각자 가진다.",

package/{templates → dist}/workspace/scripts/doctor.mjs

@@ -1,6 +1,6 @@
 // doctor — 워크스페이스 생성 이후의 환경·로그인 상태를 결정적으로 점검한다.
 //
-// 실행: 워크스페이스 루트에서 `pnpm doctor` (또는 `node scripts/doctor.mjs`).
+// 실행: 워크스페이스 루트에서 `pnpm run doctor` (또는 `node scripts/doctor.mjs`).
 // 의존성 0 — node 내장 모듈만 쓴다. 루트에는 node_modules가 없어도 돈다.
 //
 // 원칙:
@@ -191,7 +191,7 @@ function checkVercel() {
   const r = run("vercel whoami", { timeout: 20000 });
   if (r.ok) return { status: "ok", label: `Vercel CLI — 로그인됨 (${r.stdout.split("\n").pop()})` };
   if (r.timedOut || r.networkIssue)
-    return { status: "warn", label: "Vercel CLI", detail: "네트워크 문제로 확인하지 못했습니다.", fix: "인터넷 연결 후 pnpm doctor 재실행" };
+    return { status: "warn", label: "Vercel CLI", detail: "네트워크 문제로 확인하지 못했습니다.", fix: "인터넷 연결 후 pnpm run doctor 재실행" };
   return { status: "fail", label: "Vercel CLI", detail: "로그인이 안 되어 있습니다.", fix: "vercel login" };
 }
 
@@ -207,7 +207,7 @@ function checkSupabase() {
   const r = run(`"${bin}" projects list`, { cwd: path.join(ROOT, "web"), timeout: 25000 });
   if (r.ok) return { status: "ok", label: "Supabase CLI — 로그인됨" };
   if (r.timedOut || r.networkIssue)
-    return { status: "warn", label: "Supabase CLI", detail: "네트워크 문제로 확인하지 못했습니다.", fix: "인터넷 연결 후 pnpm doctor 재실행" };
+    return { status: "warn", label: "Supabase CLI", detail: "네트워크 문제로 확인하지 못했습니다.", fix: "인터넷 연결 후 pnpm run doctor 재실행" };
   return {
     status: "fail",
     label: "Supabase CLI",
@@ -227,7 +227,7 @@ function checkEas() {
   const r = run("eas whoami", { timeout: 20000 });
   if (r.ok) return { status: "ok", label: `EAS CLI — 로그인됨 (${r.stdout.split("\n").pop()})` };
   if (r.timedOut || r.networkIssue)
-    return { status: "warn", label: "EAS CLI", detail: "네트워크 문제로 확인하지 못했습니다.", fix: "인터넷 연결 후 pnpm doctor 재실행" };
+    return { status: "warn", label: "EAS CLI", detail: "네트워크 문제로 확인하지 못했습니다.", fix: "인터넷 연결 후 pnpm run doctor 재실행" };
   return {
     status: "fail",
     label: "EAS CLI",
@@ -236,6 +236,50 @@ function checkEas() {
   };
 }
 
+function checkSentry() {
+  if (!installed("sentry-cli"))
+    return { status: "fail", label: "Sentry CLI", detail: "설치되어 있지 않습니다.", fix: "npm install -g @sentry/cli" };
+  // sentry-cli info는 미로그인이어도 exit 0 — 출력의 Unauthorized로 판별한다.
+  const r = run("sentry-cli info", { timeout: 15000 });
+  if (r.ok && !/unauthorized/i.test(r.stdout + r.stderr)) return { status: "ok", label: "Sentry CLI — 로그인됨" };
+  if (r.timedOut || r.networkIssue)
+    return { status: "warn", label: "Sentry CLI", detail: "네트워크 문제로 확인하지 못했습니다.", fix: "인터넷 연결 후 pnpm run doctor 재실행" };
+  return {
+    status: "fail",
+    label: "Sentry CLI",
+    detail: "로그인이 안 되어 있습니다.",
+    fix: "sentry-cli login --global → 열린 페이지에서 [Create New Token] → 토큰 복사 → 터미널의 Enter your token:에 붙여넣기",
+  };
+}
+
+// 브릿지 계약 동기 — ssb/(원본)와 web/mobile 사본의 byte-동일성.
+// 어긋난 채 배포되면 앱·웹이 메시지를 다르게 해석해 조용히 오작동한다.
+function checkBridgeSync() {
+  const diverged = [];
+  for (const file of ["contract.ts", "reader.ts"]) {
+    let original;
+    try {
+      original = readFileSync(path.join(ROOT, "ssb", file));
+    } catch {
+      return { status: "warn", label: "브릿지 계약 (ssb)", detail: `ssb/${file}를 읽지 못했습니다.` };
+    }
+    for (const dir of ["web/lib/bridge", "mobile/src/bridge"]) {
+      try {
+        if (!original.equals(readFileSync(path.join(ROOT, dir, file)))) diverged.push(`${dir}/${file}`);
+      } catch {
+        diverged.push(`${dir}/${file} (없음)`);
+      }
+    }
+  }
+  if (diverged.length === 0) return { status: "ok", label: "브릿지 계약 — 3곳 동일 (ssb · web · mobile)" };
+  return {
+    status: "fail",
+    label: "브릿지 계약",
+    detail: `ssb/ 원본과 어긋났습니다: ${diverged.join(", ")}`,
+    fix: '코딩 에이전트에게 부탁: "ssb/의 contract.ts·reader.ts를 web/lib/bridge/와 mobile/src/bridge/에 바이트 단위로 동일하게 복사해줘"',
+  };
+}
+
 // ---------- 실행 ----------
 
 const meta = readWorkspaceMeta();
@@ -245,8 +289,8 @@ console.log(bold(`🩺 doctor — ${meta.name ?? path.basename(ROOT)} 환경 점
 console.log(dim("   각 항목을 점검합니다. 네트워크 확인이 포함되어 몇십 초 걸릴 수 있습니다."));
 
 const sections = [
-  { title: "공통", blocking: true, checks: [checkNode, checkPnpm, checkGit, () => checkAgent(meta), checkGh, checkVercel] },
-  { title: "웹", blocking: true, checks: [() => checkDeps("web"), checkSupabase] },
+  { title: "공통", blocking: true, checks: [checkNode, checkPnpm, checkGit, () => checkAgent(meta), checkGh, checkVercel, checkBridgeSync] },
+  { title: "웹", blocking: true, checks: [() => checkDeps("web"), checkSupabase, checkSentry] },
   { title: "앱", blocking: false, note: "'앱으로 확장' 챕터 전까지는 ✗여도 정상입니다.", checks: [() => checkDeps("mobile"), checkEas] },
 ];
 
@@ -275,13 +319,15 @@ for (const section of sections) {
 
 console.log("");
 if (blockingFails === 0) {
-  console.log(green(bold("✅ 웹 개발 준비 완료")) + (warns ? dim(`  (⚠ ${warns}개는 안내를 참고해 직접 확인하세요)`) : ""));
+  // [앱]까지 전부 ✓면 그 사실도 인정한다 — "웹만 완료"로 읽히지 않게.
+  const verdict = appFails === 0 ? "✅ 웹·앱 개발 준비 모두 완료" : "✅ 웹 개발 준비 완료";
+  console.log(green(bold(verdict)) + (warns ? dim(`  (⚠ ${warns}개는 안내를 참고해 직접 확인하세요)`) : ""));
 } else {
-  console.log(red(bold(`✗ ${blockingFails}개 항목이 남았습니다.`)) + " 위의 → 안내를 따라 해결한 뒤 다시 실행하세요: " + bold("pnpm doctor"));
+  console.log(red(bold(`✗ ${blockingFails}개 항목이 남았습니다.`)) + " 위의 → 안내를 따라 해결한 뒤 다시 실행하세요: " + bold("pnpm run doctor"));
   console.log("");
   console.log("📋 직접 하기 어렵다면, 코딩 에이전트에 아래 문장을 그대로 붙여넣으세요:");
-  console.log(bold('   "pnpm doctor를 실행해서 ✗ 항목을 확인하고, 각 항목의 → 안내를 따라 해결해줘.'));
-  console.log(bold('    브라우저 로그인이 필요한 단계는 멈추고 나에게 알려줘. 끝나면 pnpm doctor로 다시 검증해줘."'));
+  console.log(bold('   "pnpm run doctor를 실행해서 ✗ 항목을 확인하고, 각 항목의 → 안내를 따라 해결해줘.'));
+  console.log(bold('    브라우저 로그인이 필요한 단계는 멈추고 나에게 알려줘. 끝나면 pnpm run doctor로 다시 검증해줘."'));
 }
 if (appFails > 0 && blockingFails === 0) {
   console.log(dim(`📦 [앱] ✗ ${appFails}개는 '앱으로 확장' 챕터에서 해결합니다. 지금은 무시해도 됩니다.`));

package/{templates → dist}/workspace/ssb/README.md

@@ -1,6 +1,6 @@
 # ssb — 앱↔웹 브릿지 계약 (SSOT)
 
-이 폴더가 앱↔웹 통신 계약의 원본이다. 메시지는 `ns: "ssb"` 네임스페이스를 달아 페이지의 다른 postMessage 트래픽과 섞이지 않는다. `/kickoff`이 여기서 app(`src/bridge/`)과 web(`lib/bridge/`)으로 바이트 단위로 동일하게 복사하고, CI checksum이 드리프트를 막는다.
+이 폴더가 앱↔웹 통신 계약의 원본이다. 메시지는 `ns: "ssb"` 네임스페이스를 달아 페이지의 다른 postMessage 트래픽과 섞이지 않는다. 이 원본은 app(`mobile/src/bridge/`)과 web(`web/lib/bridge/`)에 바이트 단위로 동일하게 복사되어 있고, 워크스페이스 루트의 `pnpm run doctor`가 세 사본의 동일성을 점검한다.
 
 불변식 (상세는 `contract.ts` 헤더):
 

package/{templates/workspace/mobile/src/bridge → dist/workspace/ssb}/contract.ts

@@ -3,8 +3,9 @@ import { z } from "zod";
 /**
  * App ↔ Web bridge contract — SINGLE SOURCE OF TRUTH.
  *
- * This file is copied byte-for-byte into the web project (docs/web-adapter/contract.ts).
- * The two MUST stay identical; the web adapter ships a checksum check to enforce it.
+ * This file is copied byte-for-byte into the web (web/lib/bridge/) and the app
+ * (mobile/src/bridge/). All copies MUST stay identical; `pnpm run doctor` at the
+ * workspace root checks this.
  *
  * Invariants (never break these):
  *  1. Every message is namespaced (`ns: "ssb"`) so unrelated postMessage traffic on

package/{templates → dist}/workspace/web/lib/bridge/contract.ts

@@ -3,8 +3,9 @@ import { z } from "zod";
 /**
  * App ↔ Web bridge contract — SINGLE SOURCE OF TRUTH.
  *
- * This file is copied byte-for-byte into the web project (docs/web-adapter/contract.ts).
- * The two MUST stay identical; the web adapter ships a checksum check to enforce it.
+ * This file is copied byte-for-byte into the web (web/lib/bridge/) and the app
+ * (mobile/src/bridge/). All copies MUST stay identical; `pnpm run doctor` at the
+ * workspace root checks this.
  *
  * Invariants (never break these):
  *  1. Every message is namespaced (`ns: "ssb"`) so unrelated postMessage traffic on

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-saas-starter-workspace",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "강의용 SaaS 워크스페이스(web + mobile + 에이전트 도구)를 한 번에 만드는 생성기. 생성 → 의존성 설치 → doctor 점검까지 한 흐름.",
   "type": "module",
   "license": "SEE LICENSE IN LICENSE",
@@ -10,7 +10,7 @@
   "files": [
     "bin",
     "src",
-    "templates",
+    "dist",
     "CHANGELOG.md"
   ],
   "engines": {

package/src/scaffold.mjs

@@ -11,6 +11,9 @@ export const TOKEN = "my-space";
 
 // 토큰을 소비해야 하는 파일 목록. 토큰이 없으면 드리프트로 보고 실패한다(리네임 감지).
 export const RENDER_FILES = [
+  "package.json",
+  "README.md",
+  "AGENTS.md",
   "web/package.json",
   "web/README.md",
   "web/.env.example",