goal-setting

Goal Setting Operating Rules

역할

이 스킬은 /goal을 실행하지 않는다. 사용자가 Claude Code의 /goal 명령에 그대로 붙여넣을 수 있는 구조화된 마크다운 프롬프트(Required 4섹션 + 필요 시 추가 섹션)를 함께 설계한다.

사용자의 모호한 요구 → [goal-setting] → 4섹션 구조의 /goal 프롬프트(필요 시 추가 섹션 포함)

산출물은 단일 마크다운 코드블록이며, 구조는 아래 Standard Template을 따른다. 추가 섹션(5)~)은 사용자 요청에 따라 유연하게 편성한다.

시작 시 확인

작업 시작 시 다음을 짧게 확인한다:

1. 사용자가 어떤 작업을 /goal로 자동화하려 하는지 의도 한 줄
2. 작업이 수행될 코드베이스/디렉터리 범위
3. 사용 가능한 검증 명령(테스트·린트·타입체크·grep 등)이 프로젝트에 존재하는지

확인은 1턴에 묶어 처리한다. 답이 다 모이기 전에는 /goal 프롬프트를 출력하지 않는다.

---

기본 원칙

1. 모든 /goal 프롬프트는 Required 4 Sections(목표·범위 / 세부규칙 / 종료조건+방법 / 제약)을 모두 갖춰야 한다.
2. 모든 /goal 프롬프트는 Three Pillars 검증을 통과해야 한다.
3. 평가자는 도구를 실행하지 않고 파일도 직접 읽지 않는다 — 증거는 대화에 드러나야 한다.
4. 종료 조건 절(예: or stop after N turns, budget cap, queue empty)이 없으면 출력하지 않는다.
5. 측정 불가 형용사(better, cleaner, perfect, fully)는 명령 기반 조건으로 환원한다.
6. /goal 프롬프트는 단일 atomic 목표여야 한다 — 복합 목표는 분리된 /goal로 나눈다.
7. 검증 명령은 사용자 프로젝트에 실제 존재하는 것만 사용한다.
8. 출력은 시각적 행 구분자(---)로 4개 영역을 분리한다 — 상세 형식은 아래 Step 5 — Output을 단일 기준으로 따른다.
9. 사용자가 이미 구조화된 장문 요구사항 프롬프트를 제시하면 템플릿에 끼워 맞추지 말고 원 구조를 보존해 <docs>/goals/original-requirements/에 저장한 뒤 ## 2) 작업 세부 규칙에서 그 파일을 참조한다 — 아래 산출물 외부화 규칙 A를 따른다.
10. 생성된 /goal 본문이 4,000자를 초과하면 <docs>/goals/에 저장하고 대화에는 파일 호출 프롬프트만 제공한다 — 아래 산출물 외부화 규칙 B를 따른다.

---

Three Pillars (필수 통과 기준)

모든 /goal 프롬프트는 아래 세 기둥을 동시에 만족해야 한다.

1. Feasibility — 측정 가능한가?

완료 상태가 boolean(yes/no)으로 환원되는가?

표현	판정	환원 방향
make the app perfect	❌ Infeasible	정의 불가, 거부
improve the payment module	❌ Infeasible	"어떤 명령이 통과하면 개선된 것인가?"로 환원
all tests in test/auth pass	✅ Feasible	exit code로 판정
each file under 300 lines in src/payment/parts	✅ Feasible	wc -l로 판정

2. Demonstrability — 대화로 증명 가능한가?

평가자는 transcript에 surface된 내용만 본다. 다음을 항상 확인:

• Claude가 명령을 실제로 실행하고 출력을 대화에 남길 수 있는가?
• 그 출력만 보고 evaluator가 yes라고 말할 수 있는가?

표현	판정	환원 방향
all files are correct	❌ Non-demonstrable	평가자가 파일을 못 봄
the bug is fixed	❌ Non-demonstrable	"고쳤다"를 명령 출력으로 환원
npm test exits 0 and the result is shown in the conversation	✅ Demonstrable	exit code가 대화에 남음
grep -rn legacyAuth src/ returns 0 matches in the conversation	✅ Demonstrable	grep 결과가 대화에 남음