name	fable-parity
description	Opus 4.8을 Fable 5의 절차·성능으로 운용하는 강제형 워크플로우. spec→analyze→design→implement→verify→done 단계를 훅과 상태머신으로 강제한다. 트리거: "fable parity", "파리티 모드", "분석-설계-구현 절차로", 새 기능·리팩터링 등 비자명한 개발 작업 시작 시.

fable-parity — Fable 5 패리티 워크플로우

이 스킬은 지침이 아니라 강제 장치다. 프롬프트만으로는 절차 이탈을 막을 수 없으므로 세 겹으로 강제한다:

상태머신 (scripts/phase.sh) — 산출물 파일 없으면 단계 전환 자체가 실패 (exit 1)
PreToolUse 훅 — implement 단계 전 코드 Edit/Write를 도구 수준에서 차단 (exit 2)
Stop 훅 — 검증 증거(verify.md) 없이 턴 종료 시도를 차단

훅 설치는 install.sh (아래 §설치). 훅이 없어도 phase.sh 단독으로 상태머신은 동작한다.

실행 절차 (스킬 발동 시 이 순서를 따른다)

bash .claude/skills/fable-parity/scripts/phase.sh start

단계	할 일	산출물 (전환 전제조건)	전환 명령
spec	목표·제약·완료 기준 작성, 사용자 확인	`.claude/fable-parity/spec.md`	`phase.sh set analyze`
analyze	병렬 탐색 서브에이전트로 영향 범위 맵 작성	`.claude/fable-parity/analysis.md`	`phase.sh set design`
design	접근법 2–3개 비교 → 변경 목록·리스크·완료 기준 매핑	`.claude/fable-parity/design.md` + 사용자 승인	`phase.sh set implement --user-approved`
implement	변경 목록 순서대로 구현, 항목마다 빌드·린트	—	`phase.sh set verify`
verify	테스트 + 실제 실행, fresh-context 리뷰 에이전트	`.claude/fable-parity/verify.md` (명령+출력 증거, PASS 포함)	`phase.sh set done`
done	교훈 1건 = 1파일 기록	—	완료

규칙:

--user-approved는 사용자가 design.md를 실제로 승인했을 때만 넘긴다. 임의로 넘기지 마라.
각 산출물 형식과 프롬프트 문구(위임 트리거, 커버리지 검증, no-tidying)는 reference.md §4–§6 참조.
사소한 수정(오타, 한 줄 픽스)은 이 워크플로우 대상이 아니다 — phase.sh off 상태로 그냥 진행.

모델 설정 (성능 패리티)

Claude Code: /model opus (effort 기본 xhigh 유지)
API 직접 호출: thinking={"type":"adaptive"} 필수 명시(생략 = 꺼짐), output_config={"effort":"xhigh"}, max_tokens ≥ 64K + 스트리밍. 상세는 reference.md §2.

설치 (다른 프로젝트에 적용)

bash skills/fable-parity/install.sh /path/to/target-project

스킬을 대상 프로젝트 .claude/skills/fable-parity/ 에 복사
훅 4개(SessionStart, UserPromptSubmit, PreToolUse, Stop)를 .claude/settings.json 에 병합 (백업 생성)

해제: phase.sh off (게이트만) / settings.json에서 훅 제거 (전체).

fable-parity — Fable 5 패리티 워크플로우

이 스킬은 지침이 아니라 강제 장치다. 프롬프트만으로는 절차 이탈을 막을 수 없으므로 세 겹으로 강제한다:

상태머신 (scripts/phase.sh) — 산출물 파일 없으면 단계 전환 자체가 실패 (exit 1)

PreToolUse 훅 — implement 단계 전 코드 Edit/Write를 도구 수준에서 차단 (exit 2)

Stop 훅 — 검증 증거(verify.md) 없이 턴 종료 시도를 차단

훅 설치는 install.sh (아래 §설치). 훅이 없어도 phase.sh 단독으로 상태머신은 동작한다.

실행 절차 (스킬 발동 시 이 순서를 따른다)

bash .claude/skills/fable-parity/scripts/phase.sh start

단계

할 일

산출물 (전환 전제조건)

전환 명령

spec

목표·제약·완료 기준 작성, 사용자 확인

.claude/fable-parity/spec.md

phase.sh set analyze

analyze

병렬 탐색 서브에이전트로 영향 범위 맵 작성

.claude/fable-parity/analysis.md

phase.sh set design

design

접근법 2–3개 비교 → 변경 목록·리스크·완료 기준 매핑

.claude/fable-parity/design.md + 사용자 승인

phase.sh set implement --user-approved

implement

변경 목록 순서대로 구현, 항목마다 빌드·린트

—

phase.sh set verify

verify

테스트 + 실제 실행, fresh-context 리뷰 에이전트

.claude/fable-parity/verify.md (명령+출력 증거, PASS 포함)

phase.sh set done

done

교훈 1건 = 1파일 기록

—

완료

규칙:

--user-approved는 사용자가 design.md를 실제로 승인했을 때만 넘긴다. 임의로 넘기지 마라.

각 산출물 형식과 프롬프트 문구(위임 트리거, 커버리지 검증, no-tidying)는 reference.md §4–§6 참조.

사소한 수정(오타, 한 줄 픽스)은 이 워크플로우 대상이 아니다 — phase.sh off 상태로 그냥 진행.

모델 설정 (성능 패리티)

Claude Code: /model opus (effort 기본 xhigh 유지)

API 직접 호출: thinking={"type":"adaptive"} 필수 명시(생략 = 꺼짐), output_config={"effort":"xhigh"}, max_tokens ≥ 64K + 스트리밍. 상세는 reference.md §2.

설치 (다른 프로젝트에 적용)

bash skills/fable-parity/install.sh /path/to/target-project

스킬을 대상 프로젝트 .claude/skills/fable-parity/ 에 복사

훅 4개(SessionStart, UserPromptSubmit, PreToolUse, Stop)를 .claude/settings.json 에 병합 (백업 생성)

해제: phase.sh off (게이트만) / settings.json에서 훅 제거 (전체).