English | [한국어](README.ko.md) | [中文](README.zh.md) | [日本語](README.ja.md) | [Español](README.es.md)
# goaljaby (골잡이)
<p align="center">
<img src="assets/goaljaby-hero-01.png" alt="goaljaby" width="320">
</p>
> **PRD-to-/goal bridge for Claude Code — review docs in your language, then the goal starts right after your approval.**
goaljaby takes a PRD folder (manual or from `/show-me-the-prd`) and auto-produces five review documents **in your language** (auto-detected from your request; Korean and English are first-class with deterministic heading validation, other languages are best-effort) wrapping a verify/recover loop — VALIDATION, RECOVERY, PLAN, PROGRESS, and the `/goal` command body. The review summary is shown directly in chat (no extra file), and a 4-line summary is prepended to PROGRESS.md for handoff. You read it in your own language, approve once, and the goal starts right away — the assistant emits the `/goal` line and the plugin's hook runs it (no copy-paste).
[Quick Start](#quick-start) • [Why goaljaby?](#why-goaljaby) • [How it works](#how-it-works) • [Outputs](#outputs) • [Task types](#task-types) • [Commands](#commands) • [Requirements](#requirements)
---
## Quick Start
### 1. Add the marketplace
```
/plugin marketplace add https://github.com/fivetaku/gptaku_plugins.git
```
### 2. Install
```
/plugin install goaljaby
```
### 3. Restart Claude Code
### 4. Run
With an existing PRD directory — **absolute path recommended**:
```
/goaljaby /Users/<username>/my-project/PRD/
```
Without a PRD — goaljaby offers to delegate to `/show-me-the-prd`:
```
/goaljaby
```
Or just say it naturally:
- "골잡이 호출"
- "골 셋업 만들어줘"
- "PRD에서 골 만들어줘"
- "set up goal from PRD"
---
## Why goaljaby?
- **A PRD alone isn't enough** — A PRD says *what* to build. `/goal` requires *how to prove it's done* and *how to recover when it goes wrong*. Missing either, the goal stops at "looks plausible" or drifts off-scope.
- **Review in your language, not foreign boilerplate** — Output language follows your request (`output_lang`), never a hard-coded default: Korean users get 필수 검증 / 완료 기준 매핑, English users get Required Checks / Acceptance Criteria Mapping. A review you can't read makes the approval gate meaningless, so the docs are generated in the language you'll actually read.
- **Review summary lives in chat** — No extra brief file. Step 8 shows the review summary directly in chat and prepends a 4-line summary to PROGRESS.md so handoff still works.
- **Approve once, work begins** — After your approval, the assistant emits `/goal {body}` on the last line of its reply and the plugin's hook runs that line as the `/goal` command the moment the turn ends (0.8.0+, no retyping). You read the review summary, approve, and the work begins.
- **4,000-char compact is enforced, not warned** — Claude Code's `/goal` has a 4,000-character ceiling. goaljaby applies a 5-stage compact and aborts cleanly with a structural-overflow report if it still cannot fit. No silent truncation.
- **PROTECTED_CLAUSES are uncuttable** — Stop condition, scope lock, 3-attempt rule, doc-read directive, and PROGRESS update are verified by Korean+English OR regex after compact (headings are cross-checked ko↔en; other languages fall back to section-key presence checks). If any clause is missing post-compact, the output is discarded.
- **Mandatory human approval gate** — Step 9's AskUserQuestion is non-bypassable. The goal only starts after your explicit approval.
---
## How it works
```
PRD directory
│
▼
[Step 0-1] Pre-check + analysis
│ No PRD? → delegate to /show-me-the-prd
│ Extract acceptance / non-goals / task type
▼
[Step 2-4] Interview (1-2 rounds)
│ task_type, validation methods, strictness, milestones
▼
[Step 5] Slot-fill 5 documents in output_lang (+ inherit design references / kkirikkiri gates if present)
│ VALIDATION / RECOVERY / PLAN / PROGRESS / goal-command
▼
[Step 6] Auto-compact goal-command.md to ≤4,000 chars
│ normalize → externalize → abbreviate → summarize → trim
▼
[Step 7] Deterministic self-verification
│ grep -P against 5 Korean+English OR PROTECTED_CLAUSES
│ + character count + English-heading-leak check
│ On failure → structural overflow report + DISCARD
▼
[Step 8] Show review summary in chat (output_lang)
│ + prepend 4-line summary to PROGRESS.md (handoff)
▼
[Step 9] AskUserQuestion — approve / revise / later / cancel
▼
[Step 10] On approval:
• Record start time in PROGRESS.md
• Emit `/goal {body}` as the last line of the reply
• The hook runs that line as /goal → the goal starts
```
---
## Outputs
```
[PRD directory]/
├── VALIDATION.md ← 필수 검증 / 완료 기준 매핑 / 완료로 보지 않는 조건
├── RECOVERY.md ← 기본 원칙 / 실패 루프 / 재시도 한계 / scope 잠금
├── PLAN.md ← 목표 / 마일스톤(≤5) / 최종 완료 기준
├── PROGRESS.md ← 빈 초기 템플릿 + Step 8 4-line summary prepended
└── goal-command.md ← /goal body (output_lang, ≤4,000 chars)
```
All five are rendered in `output_lang` (your request language; ko/en headings validated deterministically). The Step 8 review summary is shown in chat only (no extra file).
**Inherited context (v0.6.0+ / v0.6.2+)**: if the PRD folder carries `references/` + `sources.json` from `/show-me-the-prd` v0.10+, the style keywords and kept images are inherited into PLAN.md/VALIDATION.md (with a copyright guard). If kkirikkiri v0.23+ is installed, RECOVERY.md also gets the multi-agent gate rule (wf-lint before Workflow, boundary blocks for teammates, read-only reviewers) — silently skipped when kkirikkiri is absent. File names, command identifiers, and shell commands stay as-is.
---
## Task types
| Task type | VALIDATION emphasis | RECOVERY emphasis | /goal template |
|-----------|---------------------|-------------------|----------------|
| 기능 구현 (Feature) | Unit + integration tests | scope lock | F-2 |
| 버그 수정 (Bugfix) | Original repro + regression | No unrelated module edits | F-1 |
| UI 구현 | Screenshots + viewport checks | design token protection | F-3 |
| 문서 집필 | Section-by-section review | Frozen-once-approved sections | F-4 |
| 마이그레이션 | Parity check + rollback | public API immutability | F-5 |
| eval 개선 | Score vs baseline | One prompt change at a time | F-6 |
Task type is auto-estimated from PRD content (weighted Korean + English keyword matching) and finalized by the user in Step 3.
---
## Core promises
- **Generated docs are single-language** — Step 7 cross-checks headings (ko↔en): a Korean run with leftover English headings, or an English run with leftover Korean headings, is discarded. No half-translated output.
- **Review summary stays in chat** — No separate brief file. PROGRESS.md gets a 4-line summary at the top for handoff.
- **`goal-command.md` is always ≤4,000 characters** — If compact can't fit, the file is not saved; a structural-overflow report is printed instead.
- **PROTECTED_CLAUSES are inviolate** — Stop condition, scope lock, 3-attempt rule, doc references, and PROGRESS update are protected by Korean+English OR regex.
- **Step 9 approval gate cannot be bypassed** — Step 10 only fires after explicit human approval.
- **Self-demonstrating** — building this skill itself is a valid goaljaby target.
---
## Commands
| Command | Description |
|---------|-------------|
| `/goaljaby [PRD directory]` | Start with an existing PRD directory |
| `/goaljaby` | Interactive — offers to delegate to `/show-me-the-prd` if no PRD |
### Natural language triggers
- "골잡이 호출"
- "골 셋업 만들어줘"
- "PRD에서 골 만들어줘"
- "VALIDATION RECOVERY 만들어줘"
- "set up goal from PRD"
- "make goal scaffolding"
- "prep goal docs"
---
## Requirements
- [Claude Code](https://docs.anthropic.com/claude-code) CLI **v2.1.139+**
- Hooks active (`disableAllHooks` / `allowManagedHooksOnly` unset)
### Optional plugins (recommended)
| Plugin | What it adds |
|--------|--------------|
| `show-me-the-prd` | goaljaby auto-delegates in Step 0 when no PRD exists |
The plugin works without it — Step 0 falls back to a manual PRD path or a single-line light-mode goal.
---
## Source
Claude Code `/goal`: https://code.claude.com/docs/en/goal
---
## License
MIT
---
<div align="center">
**Read in your language. Approve. The goal begins.**
</div>