goaljaby

Category: Docs & Knowledge | Uploader: fivetaku | Downloads: 0 | Version: v1.0（Latest）
This skill should be used when the user asks to "/goaljaby", "골잡이", "골잡이 호출", "골 셋업 만들어줘", "골 셋업해줘", "PRD에서 골 만들어줘", "PRD 골 변환", "VALIDATION RECOVERY 만들어줘", "골 실행 준비", "set up goal from PRD", "goaljaby", "prep goal docs", "make goal scaffolding". Use this whenever the user has a PRD folder and wants to bridge into a /goal-driven long-running session — generating Korean VALIDATION/RECOVERY/PLAN/PROGRESS/goal-command.md with a 4,000-character compact-enforced /goal command, then emitting `/goal` on the last line of the assistant reply so the session starts the goal on the next turn after human approval. Make sure to use this skill whenever the user mentions converting PRD to a goal, preparing goal scaffolding, or generating goal validation/recovery docs.
Changelog: Source: GitHub https://github.com/fivetaku/goaljaby
Directory Structure

Current level: tree/main/skills/goaljaby/
📁 references/
- 📄 compact-strategy.md 6.7 KB
- 📄 task-type-classifier.md 3.2 KB
- 📄 task-type-templates.md 3.7 KB
- 📄 templates.md 10.3 KB
📄 SKILL.md 15.1 KB
SKILL.md

---
name: goaljaby
description: This skill should be used when the user asks to "/goaljaby", "골잡이", "골잡이 호출", "골 셋업 만들어줘", "골 셋업해줘", "PRD에서 골 만들어줘", "PRD 골 변환", "VALIDATION RECOVERY 만들어줘", "골 실행 준비", "set up goal from PRD", "goaljaby", "prep goal docs", "make goal scaffolding". Use this whenever the user has a PRD folder and wants to bridge into a /goal-driven long-running session — generating Korean VALIDATION/RECOVERY/PLAN/PROGRESS/goal-command.md with a 4,000-character compact-enforced /goal command, then emitting `/goal` on the last line of the assistant reply so the session starts the goal on the next turn after human approval. Make sure to use this skill whenever the user mentions converting PRD to a goal, preparing goal scaffolding, or generating goal validation/recovery docs.
---

# 골잡이 (goaljaby)

> PRD를 `/goal` 운영 계약으로 변환하는 브릿지 스킬. 한국어 검토 문서 5종을 생성하고, 검토 요약을 대화창에 띄운 뒤 승인하면 어시스턴트가 응답 마지막 줄로 `/goal`을 보내 다음 턴에서 골 작업을 시작한다.

## 이 스킬을 쓰는 이유

PRD가 "무엇을 만들지"라면, `/goal`은 "어떻게 끝났음을 증명하고 실패에서 어떻게 돌아올지"의 운영 계약이다. 두 단계 사이의 빈 구간(VALIDATION/RECOVERY/PLAN 작성 + 4,000자 컴팩트 + 한국어 검토 + 골 시작)을 매번 손으로 채우는 대신 자동화한다.

## 언어 정책

생성되는 모든 검토 문서는 **한국어 본문 + 영어 식별자**(파일명·명령·약어). 사용자가 그냥 넘기지 않고 한국어로 읽고 검토할 수 있어야 승인에 의미가 있다. 영어 헤딩 잔존 금지.

## 입력

- **필수**: PRD 디렉토리 경로 (**절대 경로 권장**, 예: `/Users/<username>/my-project/PRD/`). 최소 1개 `.md` 파일, acceptance criteria 포함 권장.
- **선택**: 작업 유형(자동 추정 가능), 골 엄격도, 출력 위치

상대 경로(`./PRD/`)도 동작하지만, 세션 cwd가 달라질 경우 깨질 수 있으므로 절대 경로가 안전하다.

PRD가 없으면 `/show-me-the-prd`로 위임한다 (Step 0).

## 출력

### 항상 생성되는 5개 파일 (모두 한국어 본문)

```
[output_dir]/
├── VALIDATION.md      — 필수 검증 / 마일스톤별 검증 / 완료 기준 매핑 / 완료로 보지 않는 조건
├── RECOVERY.md        — 기본 원칙 / 실패 루프 / 재시도 한계 / scope 잠금 / 방향 재확인 / 되돌리기 규칙
├── PLAN.md            — 목표 / 참조 문서 / 마일스톤(≤5) / 최종 완료 기준
├── PROGRESS.md        — 빈 초기 템플릿 + Step 8에서 상단에 4줄 요약 prepend됨
└── goal-command.md    — `/goal` 실행 본문 (한국어, 4,000자 강제)
```

검토 요약은 **별도 파일로 만들지 않는다**. Step 8에서 대화창에 직접 표시하고, 핸드오프 용도로 PROGRESS.md 상단에만 4줄 요약을 prepend한다.

**보장사항**:
- `goal-command.md` 본문은 항상 4,000자 이하 (한국어 char 단위, byte 아님).
- 5종 검토 문서는 모두 한국어 헤딩 + 한국어 본문. 영어 헤딩(Required Checks / Not Done If / Core Rule 등) 잔존 시 Step 7 검증에서 실패 → 결과물 폐기.
- PROTECTED_CLAUSES 5종은 한국어/영어 OR 정규식으로 검증 (`compact-strategy.md` 참조).

## 워크플로우 (10단계)

### Step 0: PRD 사전 확인 + 입력 분기
**타입**: Bash + AskUserQuestion (조건부)

PRD 디렉토리 인수와 내용을 확인한다.

**0-A) 인수 있음 + 디렉토리 존재 + `.md` 1개 이상**
- Bash로 acceptance criteria 패턴(`- [ ]`, "Acceptance Criteria", "완료 판정", "completion criteria") 확인. 없으면 Step 1에서 경고하지만 진행은 계속한다.
- 기존 산출물(VALIDATION.md / RECOVERY.md / PLAN.md / PROGRESS.md / goal-command.md 중 하나라도) 존재 시 AskUserQuestion: 덮어쓰기 / 이어가기(기존 PROGRESS.md 읽고 골 재실행만 안내) / 취소.
- → Step 1 진입.

**0-B) 인수 없음 OR 디렉토리 없음 OR `.md` 0개**

AskUserQuestion: "PRD가 아직 없네요. 어떻게 시작할까요?"
- `/show-me-the-prd`로 지금 만든다 (추천) — Skill 도구로 `show-me-the-prd:show-me-the-prd` 위임. PRD 폴더 생성 후 골잡이가 그 경로로 0-A 재진입.
- 수동 작성한 PRD 폴더 경로를 알려준다 — 경로 받아 0-A 재진입.
- PRD 없이 한 줄 목표만 입력하고 진행 — 임시 PRD.md 생성 (한 문장 goal + 자동 추출 1~2 acceptance), `light` 엄격도 + 마일스톤 1개 강제.
- 취소.

### Step 1: PRD 분석
**타입**: prompt + Bash

PRD 본문을 읽고 추출:
- acceptance criteria (없으면 사용자에게 경고)
- non-goals
- open questions
- 작업 유형 추정 (한/영 키워드 동시 매칭 — `references/task-type-classifier.md` 참조)

### Step 2: 운영 컨텍스트 확정 (자동)
**타입**: 자동 (인터뷰 없음)

이 스킬은 Claude Code v2.1.139+ 전용이다. CLI 분기 인터뷰는 없고 `target_cli = claude_code`로 자동 고정한다. 결과적으로:
- RECOVERY.md는 pause/resume을 사용하지 않는다 (Claude Code는 `/goal pause` 미지원).
- `goal-command.md`는 4,000자 강제 (공식 character 단위).
- Step 10에서 어시스턴트가 응답 마지막 줄로 `/goal {본문}`을 보내고, 시스템이 다음 턴 입력으로 처리해 골 작업을 시작한다.

### Step 3: 작업 유형 + 검증 방식 + 엄격도
**타입**: AskUserQuestion (1~2회로 압축)

- 작업 유형 6종: 기능 구현 / 버그 수정 / UI 구현 / 문서 집필 / 마이그레이션 / eval 개선
- 자동 검증 방식 (multiSelect): 단위 테스트 / 빌드 / 수동 재현 / 스크린샷 / 섹션 자가 검토 / eval 스코어 / 통합 / 패리티
- 엄격도: 표준(추천) / 엄격 / 가벼움

### Step 4: 마일스톤 추출 + 사용자 확정
**타입**: prompt + AskUserQuestion

PRD acceptance criteria를 그룹화하여 마일스톤 초안 생성. ≤5개 강제. 5개 초과 시 우선순위 상위 5개만 1차로 가져가고 나머지는 메모로 분리.

사용자에게 마일스톤 목록을 preview로 보여주고 확정.

### Step 5: 5개 파일 슬롯 채움
**타입**: rag + generate

`references/templates.md`의 5개 한국어 템플릿을 PRD 내용에 맞춰 슬롯 치환. 작업 유형에 따라 강조 항목이 달라진다 — 매핑 표는 `references/task-type-templates.md` 참조.

치환 시 빈 슬롯(`{...}`)이 잔존하지 않도록 확인. 빈 슬롯이 남으면 해당 줄 자체 제거.

### Step 6: goal-command.md 4,000자 자동 컴팩트
**타입**: prompt + Bash

`compact-strategy.md`의 5단계를 인라인으로 적용한다. 텍스트 변환은 Claude가 수행, 단계별 길이 측정은 `python3 -c "print(len(open('goal-command.md').read()))"`로 결정론적으로 측정.

우선순위 5단계:

1. 정규화 (공백·줄바꿈)
2. 운영 규칙 외부화 (본문엔 "RECOVERY.md를 따른다"만)
3. 약어 치환 (V.md/R.md/P.md/PR.md + 본문 상단 한국어 범례 `[약어] ...`)
4. 마일스톤 요약 (이름만 두고 상세는 PLAN.md에 위임)
5. 작업 유형별 군더더기 제거

**PROTECTED_CLAUSES**: 정지조건/scope잠금/3회룰/문서참조/PROGRESS업데이트 5종은 절대 삭제 금지. 한·영 OR 정규식 패턴은 `references/compact-strategy.md` 참조.

### Step 7: 자체 검증
**타입**: Bash + Read

LLM 인지에만 의존하지 않는다. Bash 도구로 결정론적 검증한다.

1. **문자수 ≤ 4,000자**: `python3 -c "import sys; print(len(open(sys.argv[1]).read()))" goal-command.md` (UTF-8 char 단위).
2. **PROTECTED_CLAUSES 5종 한·영 OR 정규식 매칭**: `compact-strategy.md` §보호 영역의 5개 정규식을 `grep -P` 또는 Python으로 매칭. 5개 모두 hit 필수.
3. **`/goal ` 시작 검증**: `grep -cE '^/goal ' goal-command.md` 결과가 1 이상.
4. **약어 치환 후 미정의 약어 없음**: 본문에서 `\b[A-Z]+\.md\b` 패턴 추출 후 표준 약어(VALIDATION/RECOVERY/PLAN/PROGRESS/PRD/SDD)와 본문 상단 `[약어]` 범례 정의 외에 등장하는지 확인.
5. **acceptance 매핑 누락 없음**: VALIDATION.md의 `## 완료 기준 매핑` 테이블 행 수가 PRD acceptance criterion 수 이상인지 확인.
6. **영어 헤딩 잔존 검사**: `grep -nE "^## (Required Checks|Targeted Checks|Manual Verification|Acceptance Criteria Mapping|Not Done If|Core Rule|Failure Loop|Retry Limit|Scope Control|Reorientation Rule|Revert Rule|Goal|Source Documents|Final Completion Criteria|Current Goal|Current Milestone|Completed|Last Validation|Failed Attempts|Current Best State|Next Step|Risks|Handoff Notes|Visual Verification)\b"` — 0건이어야 함. 1건 이상이면 한국어 템플릿 치환 실패 → 폐기.

하나라도 실패 → `compact-strategy.md` §구조적 오버플로우 보고로 분기. **5종 파일을 저장하지 않는다.**

### Step 8: 한국어 검토 요약 표시 + PROGRESS.md prepend
**타입**: prompt + Bash

별도 파일을 만들지 않는다. 한국어 검토 요약을 **대화창에 직접 출력**하고, 핸드오프 용도로 **PROGRESS.md 상단에 4줄 요약을 prepend**한다.

**대화창 출력 형식** (5섹션):

```md
# 골 검토 요약 — {PROJECT_NAME}

## 목표 한 문장
{GOAL_ONE_LINER}

## 마일스톤 (≤5)
1. {MILESTONE_1_NAME} — 완료 조건: {M1_COMPLETION}
2. ...

## 필수 검증 명령
- `{VALIDATION_CMD_1}`
- ...

## scope 잠금 / Non-goals
- {NON_GOAL_1}
- ...

## 사람 결정이 남은 항목
- {OPEN_QUESTION_1}
- (없으면 "없음")

## 시작 직전 확인
- goal-command.md: {CHAR_COUNT}자 / 4,000자
- PROTECTED_CLAUSES 5종: 모두 통과
- 영어 헤딩 잔존: 0건
- 생성된 파일: VALIDATION.md, RECOVERY.md, PLAN.md, PROGRESS.md, goal-command.md
```

**PROGRESS.md 상단 prepend (4줄)**:

핸드오프 시 PROGRESS.md만 봐도 컨텍스트를 잡을 수 있도록 다음 블록을 PROGRESS.md 맨 앞에 삽입한다 (기존 본문은 그 아래로 밀린다).

```md
## 골 검토 요약 (Step 8 자동 생성)

- 목표: {GOAL_ONE_LINER}
- 마일스톤: {M1_NAME} / {M2_NAME} / ...
- 필수 검증: {REQUIRED_CHECK_COMMANDS_ONELINE}
- scope 잠금: {KEY_SCOPE_LOCKS_ONELINE}

---

```

이 요약을 화면 출력 후 Step 9로 넘어간다.

### Step 9: 사람 검토 + 승인 / 수정
**타입**: AskUserQuestion (필수 게이트)

질문: "위 요약을 검토하셨나요? 어떻게 진행할까요?"

- **승인 — 지금 골 작업 시작** (추천): Step 10으로 이동, 응답 마지막 줄로 `/goal`을 보내 다음 턴에서 골을 시작한다.
- **수정 필요**: 어느 파일을 어떻게 바꿀지 자유 텍스트 입력 받기. 입력 받은 뒤 해당 파일만 재생성 후 Step 7부터 재검증.
- **나중에 직접 실행**: 골을 시작하지 않음. `goal-command.md` 위치만 안내하고 종료.
- **취소**: 5종 파일을 그대로 두고 종료.

승인 게이트는 우회 불가. 한 번 승인으로 골이 시작되지만, 반드시 사용자 확인을 거친다.

### Step 10: 승인 시 응답 마지막 줄로 /goal 보내기
**타입**: prompt + Bash

승인이 들어오면:

1. **PROGRESS.md에 시작 기록** (Bash로 append):
   ```
   ## 골 시작 기록
   - 시작 시각: {ISO_TIMESTAMP}
   - 사용 CLI: claude_code
   - 컴팩트 후 본문 길이: {CHAR_COUNT}자
   ```

2. **응답 본문은 한국어로 간단히 정리**:
   - "검토하신 골을 지금 시작합니다. 완료 조건 도달 시 PROGRESS.md에 자동 기록되니 그쪽에서 진척을 확인하세요." 정도 한 줄.
   - 검토용 파일 5종 경로도 한 줄로 안내.

3. **응답의 *마지막 줄*에 정확히 `/goal {goal-command.md 본문 한 줄}` 출력**:
   - 코드블럭으로 감싸지 않는다 (백틱 X). 순수 텍스트 한 줄.
   - 앞뒤에 다른 텍스트를 붙이지 않는다.
   - 시스템이 이 줄을 다음 턴의 입력으로 처리해 골 작업을 시작한다.

**예시 응답 끝부분**:

```
검토하신 골을 지금 시작합니다. 완료 조건 도달 시 PROGRESS.md에 자동 기록되니 그쪽에서 진척을 확인하세요.

생성 파일: VALIDATION.md / RECOVERY.md / PLAN.md / PROGRESS.md / goal-command.md

/goal PRD.md의 모든 acceptance criterion이 만족되고 VALIDATION.md의 필수 검증이 통과될 때까지 멈추지 말고 PLAN.md의 기능을 구현한다. 먼저 PRD.md, VALIDATION.md, RECOVERY.md, PLAN.md를 읽는다. ... (이하 한국어 본문)
```

**중요**: `/goal` 줄이 응답의 마지막에 와야 한다. 그 뒤에 어떤 텍스트도 붙이지 않는다.

## Settings (가변 요소)

| 설정 | 기본값 | 변경 방법 |
|------|--------|-----------|
| `task_type` | 자동 추정 | Step 3 AskUserQuestion |
| `strictness` | `standard` | Step 3 AskUserQuestion |
| `output_dir` | PRD 디렉토리와 동일 | 호출 시 인수 |
| `overwrite_existing` | `false` (확인 받음) | Step 0 분기 |

## References

- **`references/templates.md`** — 5개 파일 한국어 템플릿 + F-1~F-6 한국어 본문
- **`references/task-type-classifier.md`** — 한/영 키워드 기반 작업 유형 추정 규칙
- **`references/task-type-templates.md`** — 작업 유형 6종 × 5개 파일 강조 항목 (한국어 additions)
- **`references/compact-strategy.md`** — 4,000자 자동 컴팩트 5단계 + 한·영 OR PROTECTED_CLAUSES 정규식

## 동작 메커니즘

이 스킬은 별도 Python 스크립트 없이 인라인으로 동작한다.

- **PRD 파싱 (Step 0~1)**: Bash + Grep으로 `.md` 파일 목록·acceptance 패턴·작업 유형 키워드 추출
- **자동 컴팩트 (Step 6)**: Claude가 `compact-strategy.md`의 5단계를 순서대로 적용 (텍스트 변환)
- **검증 (Step 7)**: Bash `grep -P` + `python3 -c "print(len(...))"`로 PROTECTED_CLAUSES 정규식·문자수·영어 헤딩 잔존을 결정론적으로 매칭
- **검토 요약 (Step 8)**: 대화창에 한국어 요약 출력 + PROGRESS.md 상단에 4줄 요약 prepend
- **골 시작 (Step 10)**: 응답 마지막 줄로 `/goal {본문}` 텍스트 출력 → 시스템이 다음 턴 입력으로 처리

## 핵심 원칙

- **한국어 검토 우선**: 생성 문서가 100% 영어로 떨어지면 안 된다. 사용자가 검토하지 않고 승인하는 일을 막기 위한 원칙.
- **검토 요약은 채팅에만**: 별도 파일을 만들지 않는다. PROGRESS.md 상단에 4줄 요약을 prepend해 핸드오프 시 컨텍스트만 보존한다.
- **경고로 끝내지 않는다**: 4,000자 초과는 항상 컴팩트로 해결. 못 맞추면 결과물 저장 안 함.
- **PROTECTED_CLAUSES는 불가침**: 5종은 어떤 컴팩트 단계에서도 삭제하지 않는다.
- **Claude Code 전용**: `target_cli = claude_code` 자동 고정. pause/resume 미지원.
- **사람 검토 안전장치 우회 금지**: Step 9 승인 게이트 없이 Step 10이 골을 시작하지 않는다.
- **승인 한 번으로 시작**: Step 10은 응답 마지막 줄로 `/goal`을 보내 다음 턴에서 골을 시작한다. 사용자가 본문을 따로 입력할 필요는 없다.
- **자기 시연 가능**: 이 스킬 자체를 만드는 작업도 골잡이로 가능하다.
Comments 0
Latest | Hot
Please login before commenting.
Loading comments...
goaljaby

Directory Structure

SKILL.md

Report

Notice
