# Crack Story Architect

> Design, compile, or audit production-grade Crack interactive story chats from story.md and characters.md into platform-limited prompts and keyword books. Use for worldbuilding, psychologically generative characters, player agency, pacing, combat loops, adult boundaries, prompt compression, cinematic openings, and Crack showcase sites, image hosting, banners, and onboarding descriptions.

- Skill: `cree1116/crack-story-architect` (Agent Skill, multi-file: 6 files)
- Install (CLI): `npx skillmds@latest add cree1116/crack-story-architect`
- Raw SKILL.md: https://api.skillmd.com/api/skills/cree1116/crack-story-architect/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: CREE1116 (https://skillmd.com/u/cree1116)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/cree1116/crack-story-architect

---


# 크랙 스토리챗 아키텍트 (Crack Story Architect)

두 저작 원본 `story.md`·`characters.md`로부터 플랫폼 규격(7K/1K/400자)에 맞춘 **프로덕션급 인터랙티브 스토리챗과 키워드북**을 설계·컴파일한다.

---

## 🚀 3단계 파이프라인 (3-Stage Production Pipeline)

> [!IMPORTANT]
> **스토리+캐릭터를 창작하는 단계(Authoring)와, 그것을 7,000자 시스템 프롬프트로 압축 컴파일하는 단계(Compiling)는 철저히 분리되어야 합니다.**
> 두 단계를 섞으면 인물의 심리적 깊이가 얕아지거나 프롬프트 분량이 폭발합니다.

```text
[Phase 1. 원작 창작 (Authoring)]  story.md + characters.md  (글자 수 제한 없음)
       ↓ 인지심리학 모델, 8대 심리 슬롯, 10단계 심리 생성 루프, 하드 룰, 위협 분류학 구축
[Phase 2. 프롬프트 컴파일 (Compiling)] build/* + start-sets/* (7K / 1K / 400자 엄수)
       ↓ 전보체 명부 기호학, 3단 파싱, 샌드위치 하네스, 2대 키워드북, 다중 시작 세트
[Phase 3. 파생 에셋 생성 (Derived Assets)] build/assets/*   (크랙 웹 등록 및 온보딩)
         단부루 태그 위키 검증 프롬프트 시트, 상세설명(3대 블록), 고정 댓글(4대 블록), 플레이 팁
```

---

## 🧭 진입 즉시 적용할 8대 핵심 기준

1. **원작 창작과 프롬프트 컴파일의 철저한 분리**:
   - `story.md`와 `characters.md`는 인물의 심리적 모순과 세계의 물리적 법칙을 구축하는 **글자 수 무제한의 정본(Canon)**이다.
   - `build/`는 이를 7,000자 / 1,000자 / 400자 규격에 맞춰 기계 실행용으로 압축 컴파일한 **사본 및 파생물**이다.
2. **인지심리학 기반 인물 설계 (3개 층위 & 8대 슬롯)**:
   - 세계의 진실 ➔ 캐릭터의 정신 상태(Belief/Desire/Self/Memory) ➔ 관찰 가능한 행동(대사/행동/침묵) 3단 인지 모델을 따른다.
   - 인물의 충돌하는 욕구(Competing Desires)와 역린(발작버튼), 슬로우본 트라우마 회복 곡선을 정본에 반드시 구축한다.
3. **GREED식 단일 상태창 하네스 (Info 작업 기억 루프)**:
   - 매 턴 최하단 ```Info``` 상태창(시각·위치·성장·소지·인물관계·목표·상황)으로 작업 기억을 갱신한다.
   - LLM의 내부 상태 장부가 없으므로, 직전 턴에 출력한 Info 상태창이 다음 턴의 유일한 **작업 기억(Working Memory)**이다.
4. **3단 입력 파싱 규약 & OOC**:
   - `[지시: 내용]`(메타 연출/속도 조율)은 대사화하지 않고 연출 지침으로 즉각 반영한다.
   - `*행동 지문*`과 `"대사"`를 명확히 분리하며, `/OOC` 입력 시 역할극을 멈추고 설정/사실을 중립적으로 안내한다.
5. **PC 주권 & 안티메리수**:
   - {user}의 모든 대사, 속마음(`💭`), 행동, 감정, 결정을 AI가 대신 연기·대필·임의조작하는 것을 엄격히 금지한다.
   - 유저 발화를 나레이터 지문에서 직접 복붙하지 않고 간접 서술로 전환하며, 이유 없는 숭배(메리수)를 차단한다.
6. **전보체 인물 명부 (Telegraphic Roster — GREED 표준)**:
   - `▶이름｜나이·신분｜외형·무장｜MBTI｜戀慾｜望｜화법｜「능력」` 형식으로 압축한다.
   - 인물의 핵심 욕망(`望`), 인정 잣대(`認`), 연애/성애 적극성(`戀/慾`) 3대 축으로 NPC 보이스 평준화(Same-face)를 원천 차단한다.
7. **다중 시작 세트(2~3 루트) & 키워드북 2대 축**:
   - 단일 시작 강제를 탈피하여 2~3개의 다중 시작 세트(`01_default`, `02_alternate`, `03_crisis`)를 표준으로 구성한다.
   - 키워드북은 **[설정 압축형]**(인물/지리)과 **[문체 조절형]**(전투/스킨십 톤)으로 분리하며, `.` 상시 트리거 핵을 배제한다.
8. **크랙 파생 에셋 폴더(`build/assets/`) 및 정보 한도 준수**:
   - 상세설명(마크다운 3대 블록)과 첫 고정 댓글(플레인 텍스트 4대 블록)을 엄격히 분리한다.
   - 비밀·트라우마 스포일러를 차단하고 Day 1 유저 정보 한도 안에서 4대 플레이 팁(동료/탐색/자원/자유도)으로 치환한다.
   - `tools/images/search_tag.py` 단부루 위키를 검색해 검증된 공식 태그로 비주얼 에셋 시트를 완성한다.

---

## 🗺️ 핵심 모듈 라우팅 맵

작업하려는 단계의 모듈을 열고, 연결된 제작·배포가 필요할 때 관련 모듈을 추가로 읽는다. 링크는 스킬 기준 디렉터리(`${CLAUDE_PLUGIN_ROOT}`) 안의 경로다. 여러 문서를 오갈 필요 없이 각 모듈 안에서 원리·템플릿·체크리스트가 완결된다.

| 단계 | 작업 내용 | 열람할 모듈 | 모듈에 담긴 핵심 지식 |
|:---:|---|---|---|
| **Phase 1** | **원작 스토리·인물 심리 설계** | [authoring-story-and-characters.md](references/authoring-story-and-characters.md) | 인지심리학 모델(3층위), 8대 심리 슬롯, 10단계 인지 루프, 충돌하는 욕구, 역린/트라우마 회복 곡선, 위협 분류학, 정본 작성법 |
| **Phase 2** | **올인원 마스터 프롬프트 컴파일** | [master-prompt-template.md](references/master-prompt-template.md) | GREED 규격 백지 마스터 템플릿(Clean Canvas), 3단 파싱, Info 상태창 하네스, 전보체 명부 기호학, 실전 GREED 헌터 레이드 완성본 |
| **Phase 2** | **키워드북 컴파일 / 슬롯 관리** | [keyword-book-guide.md](references/keyword-book-guide.md) | 설정 압축형 + 문체 조절형 템플릿, 부분문자열 충돌 방지, 1~5개 키워드 룰, 3슬롯 예산 관리, `.` 핵 배제 |
| **Phase 2** | **서사 속도 / NPC 능동성 / PC 주권** | [narrative-and-agency.md](references/narrative-and-agency.md) | PC 주권, 간접 인용, 비피학적 현실저항 가드, 발화자 1~3명 상한, 시간 Desync 방어, HUD 작업 기억 루프 |
| **Phase 2** | **다중 시작 세트 / 프롤로그 / 오프닝** | [openings-and-start-sets.md](references/openings-and-start-sets.md) | 다중 시작 세트(2~3개 루트) 표준 규약, 7단 줌인 프롤로그, 4단 핫스타트 오프닝, 세트별 추천 답변 3종 결속 |
| **Phase 3** | **크랙 파생 에셋 / 쇼케이스 / 플레이 팁** | [derived-assets-and-showcase.md](references/derived-assets-and-showcase.md) | `build/assets/` 7대 산출물 규약, 상세설명 3대 블록(마크다운), 고정 댓글 4대 블록(텍스트), 30자 후크, 4대 플레이 팁 치환 |
| **Phase 3** | **단부루 태그 위키 / 캐릭터·배경 CG** | [image-prompt-and-assets.md](references/image-prompt-and-assets.md) | `search_tag.py`(태그 검색), `compose_scene.py`(배경 컴파일), `crop_backgrounds.py`(1024x400 크롭), `name_card_cinematic.py`(시네마틱 명함), 태그 가감(+a/-소거) 원칙, 캐릭터·배경 이미지 프롬프트 및 CDN 규약 |
| **Phase 3** | **작품 연장형 사이트 설계 / 공개 정보 경계** | [immersive-showcase-design.md](references/immersive-showcase-design.md) | 네 참고 사이트 기반 프리셋, 기록자·시점·열람 권한, 관측·소문·비밀 분리, 사이트에서 플레이로 이어지는 설계 양식, HTML/CSS 템플릿 3종 |
| **Phase 3** | **이미지 호스팅 / 소개 사이트 / 배너** | [hosting-showcase-and-banner.md](references/hosting-showcase-and-banner.md) | 공개 파일 계약, 기존 배포 도구 한계, 반응형 소개·갤러리, 배너 제목·구도, 배포 및 링크 검증 |
| **Common** | **플랫폼 규격 / 글자 수 / 단축어 / 검증** | [platform-spec-and-lint.md](references/platform-spec-and-lint.md) | 7K/1K/400자 규격, UTF-16 측정법, 비가시적 조향 주석, 단축어 6대 표준 레시피, 빌드 체크리스트 |

---

## 📦 프로젝트 표준 디렉토리 및 산출물 체계

```text
<project>/
├── story.md                       # [Phase 1 정본] 세계관 물리 법칙, 갈등 엔진, 서사 아크 (무제한)
├── characters.md                  # [Phase 1 정본] 8대 심리 슬롯, 충돌 욕구, 역린, 연대기 앵커 (무제한)
├── start-sets/                    # [Phase 2 표준] 다중 시작 세트 (루트별 파일 완전 결속)
│   ├── 01_default/                # 정규 / 입문 루트 (default: true)
│   │   ├── meta.md                # 제목, 설명, 순서 (order: 0)
│   │   ├── prologue.md            # 7단 줌인 도입 원고 (≤ 1,000자)
│   │   ├── start-prompt.md        # 4단 핫스타트 첫 턴 상황 압박 (≤ 1,000자)
│   │   └── recommended-replies.md # 세트 전용 추천 첫 답변 3개 (--- 구분)
│   ├── 02_alternate/              # 대안 / 전략 루트
│   │   └── meta.md, prologue.md, start-prompt.md, recommended-replies.md
│   └── 03_crisis/                 # 위기 / 하드코어 루트 (선택적)
└── build/                         # [Phase 2 & 3 컴파일 생성물]
    ├── integrated-prompt-safe.md  # 전연령 통합 시스템 프롬프트 (≤ 7,000자)
    ├── integrated-prompt-unsafe.md# 19+ 성인 통합 시스템 프롬프트 (≤ 7,000자)
    ├── keyword-book*.md           # 키워드북 등록표 (항목당 ≤ 400자)
    ├── prologue.md                # 기본 시작 세트 사본 (≤ 1,000자, 단일 세트 뷰어 호환)
    ├── start-prompt.md            # 기본 시작 세트 사본 (≤ 1,000자, 단일 세트 뷰어 호환)
    └── assets/                    # 🌟 [Phase 3 파생 에셋 공식 디렉토리]
        ├── story-description.md   # 크랙 상세설명란 (마크다운 3대 블록: 배너/통계표, 단축어, 코멘트)
        ├── summary-comment.md     # 크랙 첫 고정 댓글 (플레인 텍스트 4대 블록: 인물소개, CG안내, 세계관, 등급)
        ├── play-guide.md          # 크랙 [시작 설정] 탭 플레이어 안내문
        ├── recommended-replies.md # 세트 공통 첫 추천 답변 3종 (--- 구분)
        ├── build-stamp.json       # 컴파일 시점 소스 해시 기록
        ├── characters.json        # NAI 가중치 베이스 프롬프트 + UC JSON (GREED 표준)
        ├── image-prompts.md       # 단부루 검증 공식 태그 기반 일러스트 프롬프트 시트
        ├── prompts.json           # 기계 판독용 이미지 프롬프트 JSON
        ├── character-design.md    # 인물 시각 디자인 명세표
        └── scene-design.md        # 배경 및 장면 시각 디자인 명세표
```

---

## ✅ 컴파일 후 필수 검증 (Validation Gate)

규격 위반은 플레이 중에 아무 신호도 내지 않는다. 프롬프트만 조용히 잘리고, 모델만 조용히 옛 설정을 연기한다.
**Phase 2 또는 Phase 3 산출물을 고쳤으면 반드시 검사기를 돌린 뒤에 완료를 보고한다.**

```bash
S="${CLAUDE_PLUGIN_ROOT:-.}"          # 플러그인 설치 경로. 레포에서 직접 쓰면 레포 루트.

"$S"/scripts/validate.sh <project>                  # 전체 검사
"$S"/scripts/validate.sh <project> --allow-unbuilt  # 아직 컴파일 전인 프로젝트
python3 "$S"/scripts/checks/check_freshness.py <project> --stamp   # 컴파일 직후 기준점 기록
```

> [!NOTE]
> `<project>`는 유저의 작업 디렉터리에 있는 스토리챗 프로젝트 경로다. 검사기는 플러그인 쪽에,
> 검사 대상은 유저 쪽에 있으므로 두 경로를 섞지 않는다. `validate.sh`는 자기 위치에서 레포 루트를
> 스스로 찾으므로 어디서 호출해도 동작한다.

| 검사기 | 잡는 것 |
|---|---|
| `check_freshness.py` | 원본을 고치고 재컴파일을 잊은 상태. 바뀐 섹션 → 다시 볼 산출물까지 지목 |
| `check_project_layout.py` | 정본 2개 / `build/` 산출물 6개 규약 |
| `check_build.py` | 7K·1K 한도, SAFE↔UNSAFE 섹션 제목 일치, 우회 문구 혼입 |
| `check_keyword_book.py` | 항목당 UTF-16 400자, 키워드 1~5개, `.` 상시 트리거 핵, 단축어 슬래시·한도 |
| `check_symbols.py` | 정의 없이 쓰인 기호·이모지, 범례보다 먼저 등장한 기호 |
| `check_image_assets.py` | 명부↔이미지 슬러그 불일치, 시드 중복, 선두 태그 충돌 |
| `check_showcase.py` | 공개정보 장부 필수값, 역할·시작 장소·상황·첫 행동, 사이트↔정본/시작세트 신선도 |
| `check_naming.py` | 폐기된 `char.` / `canon.` 점 표기 잔존 |

> [!IMPORTANT]
> `build/`에는 위 6개 산출물과 `assets/` 외의 파일을 두지 않는다. 중간 메모나 초안을 남기면 구조 검사가 실패한다.
> 기호를 새로 도입하면 `# 표기` 범례에 먼저 정의한다. 범례보다 먼저 등장한 기호는 실패로 잡힌다.

## 🧭 작업 시작 시 참조할 실물

아래 경로는 모두 **스킬 기준 디렉터리**(`${CLAUDE_PLUGIN_ROOT}`, 위 안내의 `$S`) 기준이다.
유저의 프로젝트 디렉터리가 아니다.

| 목적 | 경로 |
|---|---|
| 새 프로젝트 빈 양식 | `$S/templates/story-chat-template/` |
| `build/` 산출물 규약 | `$S/templates/build-dir-contract.md` |
| `build/assets/` 규약 | `$S/templates/build-assets-contract.md` |
| **완성된 참조 프로젝트** | `$S/examples/apocalypse/` — 정본부터 통합 프롬프트·키워드북·파생 에셋까지 전부 채워져 있고 CI가 검증한다 |
| 바로 사용하는 사이트 템플릿 | `$S/templates/showcase-sites/` — 전술 단말기·길드 게시판·기록관 HTML/CSS 및 디자인 지침 |
| 이미지 툴체인 | `$S/tools/images/` |
| 레퍼런스 | `$S/references/` |

새 프로젝트는 빈 양식을 유저 작업 디렉터리로 복사해서 시작한다:

```bash
cp -r "$S"/templates/story-chat-template <유저가 지정한 경로>
```

빈 양식만 보고 감이 오지 않으면 `$S/examples/apocalypse/`의 같은 파일을 먼저 읽는다.