voidlight00/fable-forge/fable-prompt-patterns

fable-prompt-patterns — 추상 입력 → Fable 5 최적 프롬프트 변환 방법론

SSoT는 ~/fable-forge/REQUIREMENTS.md다. 이 스킬은 FR1(4요소), FR2(12패턴), FR6(effort), FR12(사용법), FR14(guide 태그)를 구현한다. 가이드 원문이 필요하면 ~/fable-forge/knowledge/fable5-prompting.md를 읽는다.

이 스킬은 변환 방법론만 담당한다. 사용자 인터뷰(AskUserQuestion), 모드 분기, RUN_MANIFEST 기록은 fable-pipeline이 담당하므로 여기서 직접 질문을 던지지 않는다.

1. 패턴 선택 로직

먼저 입력을 4가지 작업 유형 중 하나로 분류한다. 분류가 애매하면 더 무거운 쪽(장기 자율 실행)을 고른다 — Fable 5는 어려운 작업 범위에서 가장 잘 동작하기 때문이다 [guide: Recommended scaffolding changes].

조합 규칙: 위 표의 기본 조합에서 시작해, 입력에 다음 신호가 있으면 패턴을 추가한다.

• 시스템 상태를 바꾸는 작업(삭제·배포·설정 변경) 신호 → 경계 선언을 어떤 유형이든 추가한다 [guide: State the boundaries].
• 반복 실행될 작업(매일/매주, 파이프라인) 신호 → 메모리 시스템을 추가한다 [guide: Construct a memory system].
• 결과 보고가 길어질 작업 → 가독성 종합을 추가한다 [guide: Readability when communicating with the user].
• 공격적 사이버보안·생물학 실험 방법 도메인 신호 → 의도 명확화 문구(방어·교육·연구 목적, 보유 권한)를 (a) 의도 프레이밍에 넣는다 (FR13) [guide: Capability improvements]. 도메인 경고 자체는 fable-pipeline의 도메인 체크 단계가 담당한다.

패턴을 더할수록 좋은 것이 아니다. Fable 5는 지시 추종이 강해 짧은 지시 하나가 행동 열거보다 효과적이므로, 같은 목적의 패턴이 겹치면 하나로 합친다 [guide: Strong instruction following].

2. FR1 산출 프롬프트 4요소 구조

모든 산출 프롬프트는 아래 4요소를 반드시 포함한다. 게이트(completeness_gate.sh)가 섹션 존재를 grep으로 판정하므로 헤딩을 임의로 바꾸지 않는다.

3. 산출 프롬프트 파일 포맷 템플릿

산출 파일은 runs/<run_id>/prompt.md로 저장한다. 맨 위에 비개발자용 ## 사용법을 둔다(FR12). 각 섹션에 적용 패턴의 [guide:] 태그를 단다(FR14).

# <작업 한 줄 제목>
 
## 사용법
-아래 "프롬프트" 섹션 전체를 복사해서 Claude 채팅창(claude.ai) 또는 Claude Code 입력창에 그대로 붙여넣는다.
-`<꺾쇠괄호>`로 표시된 부분만 본인 상황에 맞게 바꾼다. 나머지 문장은 그대로 두는 것이 좋다 — Fable 5 공식 가이드 패턴이 적용된 문장들이다.
-결과를 고치고 싶으면 같은 대화에서 "수정: <바꾸고 싶은 점>"이라고 이어서 보낸다.
-권장 effort: <레벨> — Claude Code에서는 설정에서, API에서는 effort 파라미터로 지정한다.
 
## 프롬프트
 
### 의도와 배경 [guide: Give the reason, not only the request]
나는 <누구>를 위해 <더 큰 목표>를 진행하고 있다. 이 작업의 결과로 <결과물이 가능하게 하는 것>이 필요하다.
그 맥락에서 요청한다: <구체 요청>.
 
### 경계 [guide: State the boundaries]
<해야 할 것>. <하지 말아야 할 것과 그 이유 — 예: 요청한 범위 밖의 리팩토링이나 기능 추가는 하지 않는다. 이 작업은 <이유> 때문에 범위가 좁을수록 좋다.>
 
### 실행 방식 [guide: Rare cases of early stopping]
되돌릴 수 있는 행동은 묻지 말고 진행한다. 파괴적이거나 되돌릴 수 없는 행동, 실제 범위 변경, 사용자만 줄 수 있는 입력이 필요할 때만 멈춰서 묻는다.
턴을 끝내기 전 마지막 문단을 확인한다 — 계획이나 약속("이제 ~하겠다")이면 지금 도구 호출로 그 일을 한다.
 
### <작업 유형별 추가 패턴 섹션 — §1 조합에 따라 0개 이상>
<예: 진행 보고 규칙 [guide: Ground progress claims during long runs], 보고 가독성 [guide: Readability when communicating with the user] 등.
패턴 원문 인용이 필요하면 references/pattern-library.md에서 가져온다.>

effort 권고는 ## 사용법의 한 줄로 충족된다(FR1-b, FR6). 장기 자율 실행 유형이면 ### 실행 방식 뒤에 메모리·검증·send-to-user 섹션을 references/scaffold-templates.md에서 가져와 붙인다(FR7).

4. 비개발자 입력 해석 지침

입력이 모호하면 다음 3축을 입력 텍스트에서 먼저 추론한다. 추론 가능한 축은 묻지 않는다(FR11 — 인터뷰는 보강이지 차단이 아니다).

1. 목적(왜) — 동사와 불만 표현에서 추론한다. "정리해줘" → 의사결정용 요약일 가능성, "만들어줘" → 실사용 산출물.
2. 대상(누가 쓰나) — 본인/팀/고객/일반 공개 단서. 없으면 "본인 사용"을 기본값으로 한다.
3. 산출 형태 — 파일/문서/코드/대화 답변. 없으면 작업 유형 분류(§1)에서 가장 자연스러운 형태를 기본값으로 한다.

적용한 기본값과 추론 근거는 산출 프롬프트의 의도 섹션에 자연스럽게 녹여 쓴다 — 그래야 사용자가 틀린 추론을 보고 <꺾쇠> 부분처럼 고칠 수 있다. 3축 중 어느 것도 추론할 수 없는 축이 있을 때만 그 축에 대한 질문 후보를 만들어 fable-pipeline에 넘긴다. 인터뷰 실행(AskUserQuestion, 최대 3문항)은 fable-pipeline 담당이다.

5. references/ 읽기 포인터

본문을 작게 유지하기 위해 상세는 references/로 분리한다. 필요한 시점에만 읽는다.

6. 산출 후 검증

산출 프롬프트 파일을 쓴 뒤 반드시 게이트를 돌리고 exit code로만 판정한다 — 산문 자가보고는 증거가 아니다(NFR3).

bash ~/fable-forge/gates/fable_lint.sh runs/<run_id>/prompt.md   # exit 0 필요
grep -c '\[guide:' runs/<run_id>/prompt.md                                      # ≥1 (FR14)
grep -c '^## 사용법' runs/<run_id>/prompt.md                                    # =1 (FR12)

lint가 exit 2면 fable-fallback-lint 스킬의 치유 레시피로 고친 뒤 재실행한다. exit 0이 나올 때까지 완료 보고하지 않는다.