Grill Me: 개발 착수 전에 요구사항을 먼저 검증하기

AI가 코드를 쓸 수 있게 됐지만, 옛 문제는 그대로다: Agent가 다 써 놓았는데, 당신이 원한 게 아니다.

문제의 핵심은 대개 이해 편차(misalignment)다 — 당신 머릿속에는 아직 흐릿한 생각뿐인데, Agent는 이미 자기 나름의 이해대로 일을 시작해 버린다.

Matt Pocock의 /grill-me가 바로 이걸 전문적으로 다룬다: 코드를 쓰거나 스펙을 쓰기 전에, 구조화된 문답으로 아이디어를 결정을 내릴 수 있을 때까지 캐물어대는 것이다. 아래에서는 그것이 무엇인지, 어떻게 쓰는지, OpenSpec과 어떻게 엇갈리는지 설명한다 — Demo는 Java 백엔드 시나리오로 한다.

1. Grill Me란 무엇인가?

Grill Me는 독립 저장소가 아니라 mattpocock/skills 컬렉션 안의 Agent Skill이며, 경로는 skills/productivity/grill-me다. SKILL.md는 겨우 몇 줄이고, 실제로 일하는 것은 바닥에 깔린 grilling이다.

차원 설명 명령 /grill-me <주제> 입력 아직 흐릿한 생각, 방안, 신규 기능 출력 결정 트리가 끝까지 돌아감, 기본적으로 어떤 파일도 쓰지 않음 트리거 disable-model-invocation: true, 반드시 수동으로 /grill-me 실행 무엇이 아닌가 Plan 모드의 대체품도 아니고, spec을 쓰는 도구도 아님

핵심 메커니즘: 아이디어 → 결정 트리 → 여러 라운드의 문답 → 미결 분기(frontier) 비우기.

매 라운드는 「선행 조건이 이미 확정된 질문」만 묻는다. 공식 사이트 예시: 46개 질문을 4라운드로 나누는 것이 정상적인 세션이다; 종료 신호는 frontier가 비는 것 — 모든 분기를 지나갔고, 조용한 가정이 없다. frontier가 비었는데도 당신에게 「이해가 정렬됐다」는 확인을 요구하며, Agent가 알아서 이어서 코드를 쓰면 안 된다.

grilling은 바닥에 깔린 interview loop(인터뷰 루프)다: grill-me, grill-with-docs, wayfinder가 모두 이를 호출하며, 각자 또 한 벌의 문답을 새로 쓰지는 않는다.

2. 어떻게 쓰는가?

1) 설치

npx skills@latest add mattpocock/skills # grill-me 체크(자동으로 바닥의 grilling Skill도 딸려옴) # Claude Code 통째 설치 claude plugins install mattpocock-skills

grill-me만 설치하고 grilling을 설치하지 않으면, 「설치했는데 반응이 없다」가 발생한다. 설치 페이지: skills.sh/mattpocock/…

2) 실행

/grill-me 주문 서비스에 내보내기 인터페이스를 추가해야 하는데, 페이징·캐시·멱등성이 아직 미정

- 새 대화 를 열 것, Agent가 이미 써 놓은 Plan 위에 겹쳐서 하지 말 것

- Plan 모드를 끌 것 ——Plan은 계획 산출을 서두르는데, 이는 「먼저 명확히 묻기」와 반대다

- 흐릿함은 이유가 아니다 , 할 가치가 있고 세부가 정해지지 않았을 때가 바로 시작 시점이다

기본적으로 한 라운드에 현재 frontier를 다 묻는다. 한 문제씩 묻는 방식으로 바꾸고 싶으면 CLAUDE.md에 추가한다: When grilling, ask one question at a time.

3) 경계 조건

상황 처리 범위가 너무 크고 질문이 백여 개(공식 사이트 예시 약 200문) 먼저 /wayfinder로 지도를 쪼갠 뒤, 구간별로 캐물음 질문이 나오지 않음(예: 인터랙션 감각) 캐묻기를 멈추고, 먼저 프로토타입을 만든 뒤 다시 봄 모델 선정 grilling은 모델의 판단력을 먹고산다, 좋은 모델을 쓸 것; 구현 단계에서는 저렴한 모델로 바꿔도 됨

4) 세 Skill 중 어떻게 고르나?

명령 적용 시나리오 /grill-me 임의 주제, 저장소 없음, 파일 쓰지 않음 /grill-with-docs 코드베이스 있음: 용어는 CONTEXT.md로, 관문을 통과한 결정은 docs/adr/로 /wayfinder 한 세션에 다 담기지 않음, 먼저 지도를 그린 뒤 구간별로 캐물음

3. Java 백엔드 Demo: 내보내기 인터페이스는 어떻게 캐물어지는가?

다음은 메커니즘 시연이며, 실제 기록이 아니다. 공식 사이트 예시에서는 일반 세션이 약 46문 / 4라운드이고, 여기서는 3라운드만 잘라 의존 관계가 어떻게 이어져 묻는지 본다.

입력:

/grill-me 주문 서비스에 내보내기 인터페이스를 추가해야 하는데, 페이징·캐시·멱등성이 아직 미정 보충: Spring Boot · 기존 MySQL + Redis · QPS 피크 약 500 · 2주 내 출시

1라운드 ——누구를 위해, 무엇을 내보내는가:

? Q1 - 내보내기는 누구에게: 운영 백엔드인가 오픈 API인가? -> 추천: 우선 운영 백엔드만, 인증은 기존 RBAC를 그대로 사용 ? Q2 - 내보내기 단위: 단일 주문 / 조건별 배치 / 전체? -> 추천: 조건별 배치, 단일 주문은 기존 상세 인터페이스로

2라운드 ——반박해도 되고, 모른다고 해도 된다:

? Q3 - 페이징 전략: 커서인가 offset인가? 1회 상한은 얼마인가? -> 추천: 커서 페이징 + 1회 최대 5000건 ※ 반박: 「운영은 Excel 전체 내보내기가 필요한데, 5000건으로는 부족하다」 → 질문 변경: 동기 소량 배치 + 비동기 대량 작업, 두 단계로 나눌 것인가? ? Q4 - 캐시: Redis에 조회 결과를 캐시할 것인가, 메타데이터만 캐시할 것인가? -> 추천: 내보내기 작업 상태만 캐시하고, 결과는 OSS 임시 링크로 떨어뜨림 ※ 「캐시는 내가 확신이 없다」→ 모른다고 하기; 1차 버전은 결과를 캐시하지 않고, 작업 상태는 DB 조회

3라운드 ——MVP 경계:

? Q5 - 멱등성: 같은 조건으로 반복 클릭하면 어떻게 처리? -> 추천: 조건 hash를 멱등 키로 사용, 24h 내 동일 작업 ID 반환 ? Q6 - 1차 버전에서 명확히 안 할 것은? -> 사용자 정의 컬럼 안 함 · 실시간 스트리밍 내보내기 안 함 · 크로스 테넌트 안 함

결정 요약: 운영 백엔드 · 조건별 배치 · 동기 소량 배치 + 비동기 대량 작업 · 결과는 캐시하지 않음, 작업 상태는 DB 조회 · 멱등 키 24h · 사용자 정의 컬럼 안 함.

4. 연달아 「동의」하지 말 것

가장 큰 실패 모드: 수동적으로 연달아 「동의」하기 ——세션이 매우 길고, 전부 Agent가 쓴 계획이며, 당신의 결정이 아니다.

어떤 문제는 대화로 나오지 않는다. 예를 들어 「내보내기 진행 바를 어떻게 표시할 것인가?」——먼저 프로토타입을 만들어 한번 보고 나서 돌아오라. 캐물을 수 없는 문제를 억지로 대화하면, Agent는 말만 바꿔가며 반복할 뿐이고 당신은 추측하게 된다.

세션이 유효하다는 것: 당신이 적어도 한 번은 반박했다; 뒤 라운드가 앞의 답변 위에 세워졌다; 끝났을 때 각 선택을 동료에게 명확히 설명할 수 있다.

5. OpenSpec, Plan 모드와 어떻게 맞물리는가?

grill-me OpenSpec Plan 모드 무엇을 다루나 생각을 명확히 한 뒤 하기 변경 스펙 정렬 단일 작업 계획 영속화 없음 Git에 들어감 창을 닫으면 없음 가장 적합 아이디어가 아직 흐릿함 브라운필드 기능 수정 작은 변경

코드베이스가 있을 때, Matt의 주된 사슬은:

grill-with-docs → to-spec → to-tickets → implement

grill-me가 to-spec으로 이어지는 것은 선택 사항이고, 이 skill의 목적이 아니다; 단일 세션에서 다 끝낼 수 있으면 spec을 건너뛰고 바로 implement해도 된다. 캐묻기가 끝난 뒤 새 session을 열지 말고, 같은 맥락을 다음 단계에 넘겨라.

to-spec은 Matt Skills의 스펙 Skill이고, OpenSpec은 독립 SDD 프레임워크이며, 사고방식은 동형이지만 기록 방식은 다르다: OpenSpec은 /opsx:propose → /opsx:apply로 간다. 한 세트를 고르고, 두 세트의 디렉터리를 섞지 말 것.

6. 참고 내용

- Skill 소스: github.com/mattpocock/…

- grilling 메커니즘: docs/productivity/grilling.md

- grill-with-docs: aihero.dev/skills-gril…

- Skill 컬렉션: github.com/mattpocock/…

- 공식 설명: aihero.dev/skills-gril…

- 설치 페이지: skills.sh/mattpocock/…

- 저자 Matt Pocock: 개인 사이트 mattpocock.com, Total TypeScript 창립자, 현재 AI Hero와 Agent Skills 오픈소스에 집중

2의 10제곱이지

-

72

글

24k

읽음

34

팬