prompt-coach
/coach 로 요청을 대상·완료 기준·제약이 분명한 프롬프트로 다듬는다
newcommandpromptmodel
/coach 로 요청을 대상·완료 기준·제약이 분명한 프롬프트로 다듬는다
A Claude Code mod that draws a usage HUD above the prompt. Two ASCII dogs keep an eye on your limits.
Claude Code 프롬프트 위에 사용량 HUD를 그려주는 mod입니다. 강아지 두 마리가 한도를 지켜봅니다.
__ 5h ████░░░░ 13% / \__ 7d █████░░░ 64% ctx ██░░░░░░ 23% 226k/1.0M
o-''|\_____/) ↻ 40m ( @\___ ↻ 17h40m last 1m54s · tools 13 +$0.80 2.2M↑ 10k↓
\_/|_) ) “공 물어올게” / O “장부 정리 중” cache 99%
\ __ / / (_____/ Opus 5.5 · medium AUTO $7.06 ⎇ main ✓
(_/ (_/ /_____/ UClaude Code 터미널 세션의 프롬프트에서 다음을 입력합니다.
/plugin install usage-hud --marketplace Jang-seungminn/usage-hudAdd marketplace?에 y를 입력하고, scope를 고릅니다. 모든 세션에서 쓰려면 user scope를 선택합니다. 설치한 세션에서 바로 동작합니다.
같은 marketplace에 다른 mod도 있습니다. 필요한 것만 같은 방식으로 설치합니다.
/plugin install plan-board --marketplace Jang-seungminn/usage-hud| mod | 하는 일 |
|---|---|
| plan-board | 사이드 패널: 목표, superpowers 플랜 진행률, 작업, 서브에이전트, 핀, 다음 단계, 인수인계 |
| auto-handoff | /handoff로 대화를 .claude/handoff/HANDOFF.md에 정리, 새 세션에서 /pickup으로 이어받기, /note로 메모. 컨텍스트 70%·90%에서 알림 |
| pinboard | /pin <결정>, /pin 할일: <내용>, /unpin <번호>, /pins. 핀은 .claude/pinboard.md에 저장되고 매 요청의 시스템 프롬프트에 실림 |
| next-steps | 작업을 끝낸 응답 끝에 다음 단계 체크박스 2~3개를 제안. /next로 목록, /next <번호>로 입력창에 넣기 |
| prompt-coach | /coach <요청>(또는 입력창의 내용)을 대상·완료 기준·제약이 분명한 요청으로 다듬어 입력창에 넣기. 실행 전 불명확하면 질문하라는 규칙 포함 |
| korean-ui | 한국어 응답 규칙, 기본 슬래시 명령 설명을 한국어로 |
auto-handoff, pinboard, next-steps, prompt-coach, korean-ui는 시스템 프롬프트에 짧은 규칙을 하나씩 덧붙입니다. 쓰지 않는 것은 설치하지 않는 편이 요청당 토큰을 아낍니다.
| 항목 | 내용 |
|---|---|
| 5h / 7d | 사용 한도 게이지, 리셋까지 남은 시간, 리셋 전에 한도가 바닥날 것 같으면 ⚡N 후 소진 |
| ctx | context window 사용량 |
| 턴 | 진행 중에는 경과 시간과 도구 호출 수, 끝난 뒤에는 그 턴의 비용과 입출력 토큰 |
| cache | 마지막 응답의 prompt cache 적중률 |
| 세션 | 모델 · effort, 권한 모드 배지, 누적 비용 |
| git | 브랜치, ahead/behind, staged/수정/추적 안 된 파일 수 |
| agents / bg | 실행 중인 서브에이전트와 백그라운드 작업 수 |
알림(toast):
수치에 따라 상태가 바뀝니다.
| 상태 | 조건 |
|---|---|
| 여유 | 기본 |
| 작업 중 | Claude가 일하는 동안 |
| 완료 | 턴이 끝나고 20초 동안 |
| 진땀 | 50% 이상 |
| 패닉 | 80% 이상 |
| 소진 | 100% |
| 수면 | 10분 넘게 쉬는 중 |
/hud를 입력하면 강아지를 끄고 켭니다. 강아지는 band가 5줄을 쓸 수 있을 때만 나오고, 터미널이 130칸 이상이면 모든 정보가 한 줄로 나란히 배치됩니다.
사이드 패널(fullscreen에서는 transcript 옆, 아니면 프롬프트 위)에 이 세션이 무엇을 하려는지와 어디까지 왔는지를 보여줍니다. 보여줄 것이 처음 생길 때 패널이 한 번 열리고, 닫은 뒤에는 /board로 다시 엽니다.
◎ 목표
GitHub 로그인 붙이기
plan Users can sign in with GitHub.
/goal bun test exits 0
▤ 플랜 2026-10-11-auth.md
plan Auth Feature Implementation Plan
task ██████░░░░░░ 1/3
step ██████████░░ 3/5
▶ Task 2: Session cookie
✓ Step 1: Write the failing test
○ Step 2: Implement setCookie
○ Task 3: Logout
☰ 작업 ████░░░░ 1/2
▶ Writing plan
✓ Write spec
⚙ 에이전트 실행 1 · 완료 2
● Explore auth code [Explore] 1m05s
✓ Review spec 42s| 영역 | 어디서 오나 |
|---|---|
| 목표 | /mission <목표>로 정한 목표. 없으면 세션의 첫 프롬프트. 플랜 파일의 Goal: 줄, 내장 /goal(또는 ProposeGoal)의 완료 조건도 함께 |
| 플랜 | …/plans/*.md 파일을 Write/Edit 하면 읽어서, 체크박스가 있는 제목(### Task N: …)을 작업으로, 체크박스를 단계로 셉니다. 매 턴이 끝날 때 다시 읽으므로 sed 등으로 체크해도 반영됩니다. superpowers의 docs/superpowers/plans/, docs/plans/ 모두 해당 |
| spec | …/specs/*.md 또는 *-design.md를 쓰면 제목을 표시 |
| 작업 / 할 일 | TaskCreate·TaskUpdate·TaskList, TodoWrite. 진행 중 → 대기 → 완료 순으로, 완료는 최근 3개만 |
| 에이전트 | Agent 호출과 SubagentStart/Stop. 실행 중인 것은 경과 시간, 끝난 것은 최근 3개 |
| 핀 | pinboard의 .claude/pinboard.md (10초마다, 턴이 끝날 때 다시 읽음) |
| 다음 단계 | 마지막 응답의 다음 단계 아래 체크박스 (next-steps가 제안하게 함) |
| 인수인계 | auto-handoff의 .claude/handoff/HANDOFF.md 작성 시각과 NOTES.md 메모 수 |
핀·다음 단계·인수인계는 해당 mod가 없어도 파일이나 응답 형식만 맞으면 표시됩니다.
명령:
/board 패널 열기, /board clear 작업·플랜·에이전트 목록 비우기/mission <목표> 목표 정하기, /mission 현재 목표 보기, /mission clear 지우기각 mod는 plugins/<이름>/에 있고, 저장소 루트는 marketplace입니다.
claude --plugin-dir ./plugins/usage-hud --plugin-dir ./plugins/plan-board
claude plugin validate . # marketplace
for m in plugins/*; do claude plugin validate $m && claude plugin test $m; doneMIT
hooks/register.ts 79 lines1import type { Register } from 'claude-code'
2
3const RULES = `# Prompt-coach
4요청을 실행하기 전에 아래 항목을 점검한다. 불명확하고, 잘못 추측했을 때 되돌리는 비용이 크면 실행하지 말고 질문한다(최대 3개, 선택지 형태).
5- 대상: 어느 저장소·모듈·파일인가, 또는 어느 문서의 어느 절인가
6- 완료 기준: 무엇이 되면 끝인가 (빌드 통과, 테스트 추가, 분량, 양식)
7- 제약: 바꾸면 안 되는 것(공개 인터페이스, 의존 방향, 기존 동작), 따라야 할 컨벤션·문서 양식·용어
8불명확하지만 되돌리기 쉬우면 질문하지 말고, 가정을 첫 줄에 한 문장으로 밝히고 진행한다.`
9
10const COACH = `너는 프롬프트 편집자다. 사용자의 요청을 실행하지 말고, 코딩 에이전트에게 그대로 보낼 수 있는 명확한 요청으로 다듬는다.
11요청은 코드 작업일 수도, 문서 작업일 수도 있다. 언어·프레임워크는 요청과 대화에 드러난 것만 쓴다.
12다듬은 요청에는 대상(저장소·모듈·파일 또는 문서의 절), 완료 기준(빌드·테스트 통과, 분량, 양식 등), 제약을 담는다. 사용자가 말하지 않은 사실을 지어내지 말고, 모르는 부분은 [확인 필요: ...]로 남긴다.
13아래 형식만 출력한다.
14<<<요청>>>
15(다듬은 요청)
16<<<메모>>>
17- 가정: (채워 넣은 내용, 없으면 "없음")
18- 확인 필요: (추정으로 채울 수 없는 항목, 최대 3개, 없으면 "없음")`
19
20export const split = (reply: string): { prompt: string; notes: string } => {
21 const [head = '', notes = ''] = reply.split('<<<메모>>>')
22
23 return { prompt: head.replace('<<<요청>>>', '').trim(), notes: notes.trim() }
24}
25
26export const register: Register = on => {
27 on('session.start', async ($, e, next) => {
28 await $.command.register({
29 name: 'coach',
30 description: '요청을 실행하지 않고 더 명확한 프롬프트로 다듬어 입력창에 넣는다',
31 argumentHint: '<다듬을 요청>',
32 })
33
34 return next(e)
35 })
36
37 on('prompt.compose', async ($, e, next) => {
38 const composed = await next(e)
39
40 return {
41 sections: [
42 ...composed.sections,
43 { id: 'prompt-coach:rules', text: RULES, scope: 'session' },
44 ],
45 }
46 })
47
48 on('command.run', { command: 'coach' }, async ($, e) => {
49 const draft = e.args.trim() || (await $.prompt.read()).text.trim()
50
51 if (draft === '') {
52 return { text: '사용법: /coach <다듬을 요청>' }
53 }
54
55 const reply = await $.model.complete({
56 model: await $.session.model(),
57 system: COACH,
58 prompt: draft,
59 maxTokens: 1500,
60 })
61
62 if (!reply.isAnswered) {
63 return { text: `다듬지 못했습니다 (${reply.reason}). 원래 요청은 그대로입니다.` }
64 }
65
66 const { prompt, notes } = split(reply.text)
67
68 if (prompt === '') {
69 return { text: `다듬은 결과를 읽지 못했습니다. 모델 응답:\n${reply.text}` }
70 }
71
72 await $.prompt.fill({ text: prompt, mode: 'replace' })
73
74 return {
75 text: `다듬은 요청을 입력창에 넣었습니다. 확인·수정 후 Enter로 보내세요.\n${notes}`,
76 }
77 })
78}
79