Crack Story Architect

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

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

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

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

[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}) 안의 경로다. 여러 문서를 오갈 필요 없이 각 모듈 안에서 원리·템플릿·체크리스트가 완결된다.

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

<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 산출물을 고쳤으면 반드시 검사기를 돌린 뒤에 완료를 보고한다.

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는 자기 위치에서 레포 루트를 스스로 찾으므로 어디서 호출해도 동작한다.

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

🧭 작업 시작 시 참조할 실물

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

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

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

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