Claude Code의 설계 검증 스킬 『grilling』 소개

서론

Claude Code를 사용하다 보면, 구현 그 자체보다 「구현 전에 어디까지 설계를 다듬어 두었는가」가 결과물에 더 큰 영향을 미치는 상황이 늘어나고 있습니다.

구현 후에 QA에서 "이 조건은 어떻게 되나요?", "이 케이스는 상정하고 있나요?"라는 지적을 받으면, 단순한 수정으로 끝나지 않고 데이터 구조나 화면 설계까지 되돌아가야 할 때가 있습니다. 납기가 정해진 프로젝트에서는 이러한 재작업(rework)이 상당히 치명적입니다.

그래서 최근 사용해 보고 좋았던 것이 Matt Pocock님이 공개한 Claude Code 스킬인 grilling입니다. 구현 전의 플랜이나 설계에 대해 AI가 엄격하게 질문을 던져주는 스킬로, 모호한 사양이나 결정되지 않은 전제를 사전에 파악하는 데 도움이 되었습니다.

grilling이란 어떤 스킬인가

한마디로 말하면, 플랜이나 설계를 AI가 가차 없이 추궁해 주는 스킬입니다.

구현에 들어가기 전의 플랜이나 사양에 대해,

• 어떤 에지 케이스(edge case)를 상정하고 있는가
• 어디는 결정되어 있고, 어디는 아직 결정되지 않았는가
• 이 판단의 전제나 제약은 무엇인가
• 이 결정은 다른 어떤 결정에 의존하고 있는가

와 같은 것들을 설계 트리(design tree)를 위에서부터 순서대로 심층적으로 파고들며 물어옵니다. 혼자 설계할 때 놓치기 쉬운 의존 관계나 암묵적인 전제를 대화 형식으로 찾아내는 이미지입니다.

공식 SKILL.md에는 다음과 같이 적혀 있습니다:

Interview me relentlessly about every aspect of this plan until we reach a shared understanding. Walk down each branch of the design tree, resolving dependencies between decisions one-by-one. For each question, provide your recommended answer.

요점은 세 가지입니다.

• 상호 이해에 도달할 때까지 가차 없이 인터뷰한다
• 설계 트리의 가지를 하나씩 따라가며 의존 관계를 해결해 나간다
• 각 질문에 대해 AI가 "나라면 이렇게 답하겠다"라는 권장안도 함께 제공한다

세 번째 포인트가 매우 유용한데, 답변하기 망설여지는 질문이라도 AI의 권장안을 기점으로 삼을 수 있어 설계 논의를 진전시키기 쉬워집니다.

실제로 사용해 보니 설계의 빈틈이 서서히 가시화되어, 구현 전에 해결할 수 있는 항목이 상당히 늘어났습니다.

Claude Code의 플랜 모드(plan mode)와의 차이점

설계 단계의 브레인스토밍(wall-hitting)이라면, Claude Code에 표준으로 갖춰진 플랜 모드로도 어느 정도 기능합니다. 플랜을 작성하게 하고 대화하며 다듬어 나가는 방식은 평범하게 도움이 됩니다.

하지만 플랜 모드를 통한 브레인스토밍은 내가 신경 쓰고 있는 부분을 기점으로 대화가 진행되기 쉬워, 내 시야 밖에 있는 사양의 빈틈까지는 잡아내기 어려운 면이 있습니다. 나오는 플랜 자체는 정돈된 것처럼 보여서 "이 정도면 충분하겠지"라고 판단해 버리고, 구현에 들어간 뒤 QA 체크에서 "이 부분 사양을 결정하지 않았었다", "이 케이스를 상정하지 못했다"라고 깨닫는 일이 자주 있었습니다.

grilling은 이러한 "스스로는 깨닫지 못하는 잠재적인 설계의 미흡함"을 AI 측에서 능동적으로 찾아내 줍니다. 설계 트리의 가지를 하나씩 따라가며 질문하는 형태이므로, 자신의 사고 범위 안에 없었던 분기나 전제가 표면으로 끌어올려집니다. 플랜 모드가 "사용자 주도의 브레인스토밍"이라면, grilling은 "AI 주도의 심문"과 같은 위치에 있으며, 서로 보완 관계에 있는 도구라는 느낌입니다.

제작자: Matt Pocock님

grilling은 mattpocock/skills에서 공개되어 있습니다.

제작자인 Matt Pocock님은 TypeScript 업계에서 Total TypeScript라는 교재로 알려진 분이며, YouTube와 X에서도 TypeScript 해설을 지속적으로 발신하고 계십니다. 최근에는 Claude Code용 Skill 제작 및 공개에도 힘을 쏟고 있어, grilling 외에도 설계·개발 프로세스를 지원하는 다양한 스킬을 공개하고 있습니다.

grill-me와 grilling 두 가지가 있는 이유

왜 mattpocock/skills 리포지토리에는 grill-me와 grilling이라는, 거의 동일한 용도의 스킬이 나란히 있을까요?

grill-me가 먼저이고, grilling은 그 개량판

역사적 경위: 리포지토리의 커밋 히스토리를 보면,

• 2026-04-28:
  grill-me가 처음 추가됨
• 2026-05-31:
  grilling이 별도의 스킬로 새로 추가됨 (같은 날 grill-me는 내용이 크게 재작성됨)

이러한 흐름을 따르고 있습니다. 즉, grill-me가 먼저 있었고, 나중에 grilling이 만들어진 순서입니다.

그리고 현재 grill-me의 SKILL.md 본문은 실질적으로 다음 한 줄뿐입니다:

Run a `/grilling` session.

즉, 현재의 grill-me는 내부적으로 grilling을 호출하기만 하는 얇은 래퍼 (Wrapper)가 되어 있으며, 본체는 grilling으로 옮겨간 상태입니다.

현재 내용의 차이점

현재 두 파일을 비교하면, 차이점은 frontmatter와 body 모두에 존재합니다.

grill-me/SKILL.md:

---
name: grill-me
description: A relentless interview to sharpen a plan or design.
...

grilling/SKILL.md:

---
name: grilling
description: Interview the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.
...

주요 포인트는 크게 세 가지입니다.

1. disable-model-invocation의 유무

grill-me의 frontmatter에는 disable-model-invocation: true가 포함되어 있습니다. 이는 "Claude 스스로가 이 스킬을 자동으로 호출하는 것을 금지한다"는 플래그로, 즉 grill-me는 사용자가 /grill-me라고 명시적으로 입력했을 때만 작동하는 슬래시 명령어 전용 에일리어스 (Alias)입니다.

grilling에는 이 플래그가 없으므로, Claude가 "지금 이 스킬을 사용해야 한다"라고 판단하면 자동으로 발동할 수 있습니다.

2. description의 상세도

grilling의 description은 다음과 같습니다:

Interview the user relentlessly about a plan or design. Use when the user wants to stress-test a plan before building, or uses any 'grill' trigger phrases.

즉, "언제 이 스킬을 발동해야 하는가"에 대한 힌트까지 적혀 있습니다. 이는 1번 항목과 관련이 있는데, 자동 발동이 가능한 스킬이기 때문에 "어떤 문맥에서 기동할 것인가"에 대한 판단 근거를 description에 작성해 둘 필요가 있는 구조입니다.

반면 grill-me의 description은 A relentless interview to sharpen a plan or design.라는 한 문장뿐이며, 기동 조건은 적혀 있지 않습니다 (명시적 호출 전용이므로 적을 필요가 없기 때문입니다).

3. body: "하나씩"이라는 지침이 얼마나 강력하게 작성되었는가

grill-me의 body는 Run a /grilling session. 한 줄이므로, 본체의 동작을 결정하는 것은 grilling의 body 측입니다.

grilling의 body에서 중요한 부분은 바로 여기입니다:

Ask the questions one at a time, waiting for feedback on each question before continuing. Asking multiple questions at once is bewildering.

"질문은 한 번에 하나씩 던지고, 다음으로 넘어가기 전에 각 질문에 대한 피드백을 기다려라", "한 번에 여러 질문을 던지는 것은 (사용자를) 혼란스럽게 만든다"라고 명확하게 주의를 주는 방식으로 작성되어 있습니다.

참고로, 구버전 grill-me의 body (grilling이 분리되기 전의 초기 버전)에도 동일한 취지의 지시가 적혀 있었습니다:

Ask the questions one at a time.

다만 실제로 사용해 보면, AI가 '하나씩'이라는 지시를 다소 느슨하게 해석하여 여러 논점을 한꺼번에 던져오는 경우가 많았습니다. grilling

여기서는 "waiting for feedback on each question before continuing" (각 질문에 대한 피드백을 받은 후에 계속 진행하기) 또는 "Asking multiple questions at once is bewildering" (여러 질문을 동시에 하는 것은 혼란스럽다)와 같이 더 강하고 구체적으로 수정되었으며, 문구상의 차이는 작지만 AI의 행동은 이 차이로 눈에 띄게 달라집니다.

체감되는 차이: 질문 폭격 → 일문일답

실제로 비교해 보면, 이 문구상의 차이는 체감상 상당히 큽니다.

grill-me를 사용했을 때는 텍스트 기반으로 질문들이 우르르 한꺼번에 쏟아져 나오는 스타일이었습니다. 한 번에 여러 논점이 나열되기 때문에, 답변하는 입장에서는 '어디부터 답해야 할까', '이건 나중에 해도 괜찮을까'라며 정리하면서 대답할 필요가 있었고, 이 부분이 힘들게 느껴졌던 부분입니다.

반면 grilling은 Claude Code의 플랜 모드에 가까운 느낌으로, 질문이 하나씩 제시되고 답변한 후에 다음 질문이 오는 인터뷰 형식으로 체계화되어 있습니다. 실제로 사용해 보면,

• 하나의 논점에 집중해서 생각할 수 있고
• 답변할 때마다 다음 질문이 나오기 때문에 사고의 리듬이 흐트러지지 않으며
• '여기는 아직 결정하지 않았다'고 답했을 때, AI가 그 분기를 포착하여 더 깊게 파고들어 줍니다.

와 같은 경험을 하게 되면서, grill-me 시절에 느꼈던 '질문 폭격에 압도되는 느낌'이 사라졌습니다. 마치 설계 리뷰를 대면으로 받고 있는 듯한 감각에 가깝습니다.

grill-me는 필요 없는가

그렇다면 현재의 grill-me는,

• 본체 로직은 가지고 있지 않으며
  grilling을 호출하는 역할만 함 -
  disable-model-invocation: true로 인해 자동 발동되지 않으며 -
  /grill-me로 명시적으로 실행했을 때만 작동한다는 구조입니다.

따라서 '/grill-me'라는 슬래시 커맨드나 'grill me (나를 심문해 줘)'와 같은 호출 방식에 익숙한 사람들을 위해, 자동 발동 없이 존재하는 별명(alias)으로 남겨둔 것으로 보입니다.

그러므로 새로 도입한다면 grilling을 직접 사용하는 것이 좋고, 이미 grill-me에 익숙한 사용자도 그대로 사용해도 문제없습니다 (호출하는 곳은 동일한 grilling이기 때문입니다).

요약

• AI가 구현까지 맡아주는 시대가 되면서, 개발 효율을 높이는 핵심 열쇠는 '설계를 얼마나 촘촘하게 다질 수 있는가'로 옮겨오고 있습니다.
• Matt Pocock이 공개한 grilling은 플랜이나 설계를 AI에게 가차 없이 추궁당함으로써 구현 전에 누락된 부분을 제거할 수 있는 스킬입니다. -
  grill-me는 같은 작가가 만든 선행 스킬로, 현재는 grilling을 호출하는 역할만 하는 얇은 래퍼(wrapper) + 슬래시 커맨드 전용 별명으로 되어 있습니다. - 두 가지의 차이는 주로 세 가지 지점입니다 (disable-model-invocation 유무, description의 구체성, body에서 '하나씩 질문하기'를 얼마나 강력하게 지시하는지 여부). - 체감상으로는 grilling의 일문일답 스타일이 답변자의 인지 부하가 상당히 낮아져서, 설계 리뷰를 대면으로 받고 있는 느낌에 가깝습니다.

참고 기사

Discussion