Matt Pocock의 grill-me 사용 가이드: Antigravity IDE에서 AI 코딩 전 설계 검토하기

AI에게 기능 구현을 요청했는데, 정작 필요한 요구사항은 빠져 있거나 기존 프로젝트의 아키텍처와 맞지 않는 코드를 제안하는 경우가 있습니다. 이런 문제를 줄이려면 코드를 작성하기 전에 요구사항과 설계부터 구체화하는 과정이 필요합니다.

mattpocock/skills 저장소의 grill-me는 이러한 사전 검토에 활용할 수 있는 인터뷰형 스킬입니다. 개발자가 생각한 아이디어에 질문을 던지고, 불명확한 요구사항과 기술적 가정을 찾아내도록 돕습니다.

이 글에서는 Windows 11과 Antigravity IDE를 기준으로 스킬 설치, 실행, 기존 ASP.NET Core 프로젝트에 적용하는 방법, 설치 후 확인해야 할 문제까지 정리합니다.

핵심 요약

grill-me: 아이디어와 설계를 질문으로 구체화합니다.
grilling: 질문을 구성하고 의사결정을 진행하는 인터뷰 엔진입니다.
grill-with-docs: 기존 코드베이스를 고려하면서 설계 관련 문서를 작성하는 진입점입니다.
중요: grill-me만 설치하면 인터뷰가 제대로 실행되지 않을 수 있으므로 grilling도 함께 설치해야 합니다.

작성 기준일: 2026년 10월 27일. 설치 명령과 스킬 설명은 공개된 공식 저장소 및 CLI 문서를 기준으로 작성했습니다. 실제 설치와 실행 결과는 대상 PC에서 별도로 확인해야 합니다.

1. grill-me는 어떤 스킬인가?

일반적인 AI 코딩 작업은 개발자가 요구사항을 전달하면 AI가 곧바로 설계안이나 코드를 제시하는 방식으로 진행됩니다. 하지만 요구사항이 충분히 구체적이지 않으면 AI가 빈 부분을 임의로 판단할 수 있습니다.

grill-me는 이 순서를 바꾸는 데 목적이 있습니다. 구현에 앞서 질문과 답변을 반복하며 무엇을 만들 것인지, 어떤 조건을 충족해야 하는지, 아직 결정되지 않은 부분은 무엇인지 확인합니다.

일반적인 AI 코딩

요구사항 전달
AI가 설계 및 구현
누락된 요구사항 발견
코드 수정 및 재작업

grill-me 활용

아이디어와 목표 전달
AI가 설계 관련 질문
개발자가 의사결정
합의한 내용을 바탕으로 구현

예를 들어 다음과 같이 요청할 수 있습니다.

기존 IIS 환경을 유지하면서 ASP.NET Core 8 배포 자동화를 구축하고 싶다. 구현에 앞서 배포 중단 허용 범위, 실패 시 복구 방법, 데이터베이스 변경, 배포 성공 판정 기준을 확인해 줘.

AI는 이러한 요구를 구체화하는 질문을 제시할 수 있습니다. 다만 질문의 내용과 순서는 실제 프로젝트의 구조, 앞선 답변, 사용 중인 모델과 실행 환경에 따라 달라집니다.

이 스킬이 설계의 정확성을 자동으로 보장하는 것은 아닙니다. 핵심은 AI가 확인한 사실과 개발자가 결정해야 할 사항을 구분하고, 중요한 가정을 구현 전에 검토하는 데 있습니다.

2. grill-me, grilling, grill-with-docs 비교

세 가지 이름은 서로 관련되어 있지만 역할이 다릅니다. 특히 기존 코드베이스를 대상으로 작업할 때는 어떤 스킬이 적합한지 구분해야 합니다.

스킬	주요 역할	사용 상황	주요 결과
`grill-me`	인터뷰 시작점	아이디어, 설계, 업무 절차 구체화	대화에서 정리한 설계
`grilling`	인터뷰 진행 엔진	질문과 의사결정 과정을 직접 실행	질문 라운드와 의사결정
`grill-with-docs`	문서화 기능을 포함한 인터뷰 시작점	기존 저장소를 검토하며 설계 정리	프로젝트 맥락에 맞춘 문서 및 결정 기록

공식 문서에서는 grill-me를 저장소가 없어도 사용할 수 있는 독립적인 인터뷰 방식으로 설명합니다. 반면 grill-with-docs는 코드베이스를 고려하고, 합의된 용어와 아키텍처 의사결정을 문서로 남기는 데 초점을 둡니다.

grill-with-docs는 grilling과 domain-modeling을 필요로 합니다. 스킬이 다른 스킬을 참조한다고 해서 실행 환경에서 해당 의존 스킬이 항상 자동으로 로드되는 것은 아닙니다. 따라서 관련 스킬을 함께 설치하고 실제 실행 여부도 확인해야 합니다.

공식 문서:

3. Windows 11에서 Antigravity IDE에 설치하기

설치는 공식 skills CLI를 사용합니다. 이 CLI는 여러 AI 개발 환경에 스킬을 설치할 수 있으며, Antigravity도 지원 대상에 포함됩니다.

3-1. Node.js와 npm 확인

Windows PowerShell 또는 Antigravity IDE의 터미널에서 다음 명령을 실행합니다.

node --version
npm --version

두 명령 모두 버전 문자열을 출력해야 합니다. 명령을 찾을 수 없다는 오류가 발생하면 Node.js 설치 여부와 PATH 설정을 확인합니다.

Node.js 공식 다운로드 페이지에서 Windows용 설치 프로그램을 확인할 수 있습니다. 설치를 마친 후에는 새 PowerShell 창을 열어 다시 확인합니다.

3-2. 프로젝트 단위로 grill-me 설치

Antigravity IDE에서 작업할 프로젝트의 루트 디렉터리를 연 다음 터미널에서 아래 명령을 실행합니다.

npx skills add mattpocock/skills --skill grill-me --skill grilling --agent antigravity

각 옵션의 역할은 다음과 같습니다.

npx skills add: 저장소에서 스킬을 가져와 설치합니다.
mattpocock/skills: 설치할 GitHub 저장소를 지정합니다.
--skill grill-me: 사용자에게 노출되는 인터뷰 시작점을 선택합니다.
--skill grilling: 인터뷰를 진행하는 핵심 스킬을 함께 설치합니다.
--agent antigravity: 설치 대상으로 Antigravity를 지정합니다.

설치 과정에서 확인 메시지가 나오면 표시된 설치 대상과 경로를 확인한 뒤 진행합니다. 위 명령은 설치 요청이며, 설치 성공 여부는 명령 실행 결과와 설치된 스킬 목록으로 확인해야 합니다.

3-3. 여러 프로젝트에서 공통으로 사용하기

특정 프로젝트에 종속되지 않고 여러 프로젝트에서 공통으로 사용하려면 전역 설치를 선택할 수 있습니다.

npx skills add mattpocock/skills --skill grill-me --skill grilling --agent antigravity --global

프로젝트 단위 설치는 팀과 함께 스킬 구성을 관리할 때 유용합니다. 전역 설치는 개인 개발 환경에서 여러 프로젝트에 공통 설정을 적용할 때 적합합니다.

주의: 프로젝트 단위 설치와 전역 설치는 설치 위치가 다릅니다. 기존에 같은 스킬이 설치되어 있다면 중복 설치 여부와 실제로 IDE가 읽는 경로를 확인해야 합니다.

3-4. 기존 코드베이스용 스킬까지 설치하기

기존 솔루션의 구조를 확인하면서 설계 문서를 작성하려면 grill-with-docs와 의존 스킬도 설치합니다.

npx skills add mattpocock/skills --skill grill-with-docs --skill grilling --skill domain-modeling --agent antigravity

이 명령은 프로젝트 단위 설치를 기준으로 작성했습니다. 전역 설치를 원한다면 --global 옵션을 추가할 수 있습니다.

처음부터 모든 스킬을 설치할 필요는 없습니다. 아이디어를 정리하는 작업이라면 grill-me와 grilling부터 설치하고, 코드베이스를 분석하면서 문서까지 남겨야 할 때 관련 스킬을 추가하는 방식이 관리하기 쉽습니다.

3-5. 설치 결과 확인

프로젝트에 설치한 스킬 목록을 확인합니다.

npx skills list --agent antigravity

전역 설치한 스킬만 확인하려면 다음 명령을 사용합니다.

npx skills list --global --agent antigravity

목록에서 grill-me와 grilling이 표시되는지 확인합니다. 문서화 방식까지 설치했다면 grill-with-docs와 domain-modeling도 확인합니다.

공식 CLI 문서에 안내된 Antigravity의 대표 설치 경로는 다음과 같습니다.

프로젝트 단위: .agents/skills/
사용자 전역: ~/.gemini/antigravity/skills/

Windows에서는 사용자 홈 디렉터리가 실제 경로로 변환됩니다. 경로가 예상과 다르다면 설치 명령의 대상, 설치 범위, CLI가 출력한 경로를 우선 확인합니다.

4. grill-me 실행 방법

설치가 끝나면 Antigravity IDE에서 새 대화를 시작하고 /grill-me를 입력합니다. 스킬이 정상적으로 인식되면 설계와 요구사항을 구체화하는 인터뷰를 시작하도록 요청할 수 있습니다.

예제 A. 신규 기능의 요구사항 구체화

다음은 ASP.NET Core 8 프로젝트에 공지사항 검색 및 페이징 기능을 추가하는 상황을 가정한 프롬프트입니다.

/grill-me

ASP.NET Core 8 프로젝트에 공지사항 검색 및 페이징 기능을 추가하려고 한다.

바로 코드를 작성하지 말고, 요구사항과 설계의 빈틈을 찾아 인터뷰를 진행해 줘.

검색 조건, 정렬 기준, 페이징 규칙, 데이터 접근 방식,
성능, 오류 처리, 테스트 범위를 검토해 줘.

각 질문에는 추천 답변과 그 근거를 제시하되,
프로젝트에서 확인할 수 있는 사실과 내가 결정해야 할
사항을 구분해 줘.

내 답변을 반영해 다음 질문을 이어가고,
최종 설계를 요약해 줘.

내가 명시적으로 승인하기 전까지는
코드를 작성하거나 파일을 변경하지 마.

이 프롬프트는 실제 프로젝트의 실행 결과가 아니라 사용 방법을 설명하기 위한 예시입니다. 인터뷰를 진행하면서 검색 대상, 정렬 기준, 페이지 크기, 접근 권한, 성능 요구사항 등을 차례로 확정할 수 있습니다.

예제 B. 기존 ASP.NET Core 솔루션 검토

이미 개발 중인 솔루션의 아키텍처를 고려해야 한다면 grill-with-docs를 사용하는 편이 적합합니다.

/grill-with-docs

현재 솔루션의 기존 코드와 아키텍처를 먼저 확인해 줘.

대상 시스템은 다음 기술을 사용한다.

- ASP.NET Core MVC
- Dapper
- MediatR
- CQRS
- Vue 3
- SQL Server

기존 계층 구조, 인증과 권한 처리, 데이터 접근 방식,
예외 처리, 테스트 전략을 확인해 줘.

코드와 문서에서 확인할 수 있는 사실,
내가 결정해야 할 사항, 아직 확인되지 않은 가정을
구분해서 질문을 진행해 줘.

합의한 용어와 아키텍처 의사결정은
GLOSSARY.md와 ADR 문서로 정리해 줘.

내가 최종 설계를 승인하기 전에는
코드를 변경하거나 기존 파일을 수정하지 마.

실행 전 확인: grill-with-docs는 프로젝트에 문서를 기록할 수 있으므로 작업 디렉터리가 올바른지 확인해야 합니다. 공식 스킬 정의에서 요청하는 grilling과 domain-modeling도 설치되어 있어야 합니다. 실제 문서의 파일명과 생성 위치는 설치된 스킬 정의와 실행 결과를 확인합니다.

5. 인터뷰 질문에 답하는 방법

인터뷰의 목적은 AI의 제안에 모두 동의하는 것이 아닙니다. 개발자가 업무 요구사항을 설명하고, AI가 제시한 선택지의 근거와 위험을 검토하면서 필요한 결정을 내리는 과정입니다.

질문 예시	권장 대응
제목만 검색할까요?	업무 요구사항에 따라 제목과 본문 중 어디까지 검색할지 결정합니다.
페이지 크기를 20개로 할까요?	기존 화면의 규칙과 사용자의 요구를 확인한 후 정합니다.
모든 계층에 인터페이스를 추가할까요?	기존 아키텍처와 테스트 요구사항을 기준으로 필요성을 검토합니다.
검색 결과를 캐싱할까요?	데이터 변경 빈도와 성능 측정 결과를 확인하기 전에는 확정하지 않습니다.

아직 결정할 수 없는 질문에는 다음과 같이 답변할 수 있습니다.

현재 정보만으로는 결정하기 어렵다. 가능한 대안과 각각의 장단점, 운영상 위험을 비교해 줘. 추가로 필요한 정보도 알려 줘.

특히 다음 세 가지를 구분하는 것이 중요합니다.

확인된 사실: 기존 코드, 설정 파일, 공식 문서 등으로 확인할 수 있는 내용입니다.
미결정 사항: 업무 규칙이나 설계 방향처럼 개발자가 결정해야 하는 내용입니다.
검증이 필요한 가정: 실제 실행, 성능 측정, 프로토타입 등 추가 확인이 필요한 내용입니다.

UI처럼 말로 설명하는 것만으로 판단하기 어려운 문제는 간단한 프로토타입을 만들어 검토하는 방법도 있습니다. 모든 결정을 대화만으로 확정할 필요는 없습니다.

6. 인터뷰 종료 후 구현으로 이어가기

질문이 끝났다는 사실만으로 설계가 승인된 것은 아닙니다. 최종 요약을 검토하고, 미결정 사항과 위험 요소를 확인한 다음 구현 여부를 결정하는 편이 안전합니다.

Step 1. 합의한 요구사항 정리

기능 범위, 검색 조건, 정렬, 페이징, 권한, 예외 처리, 테스트 조건을 요약하도록 요청합니다.

Step 2. 미결정 사항과 위험 확인

아직 확정하지 않은 내용, 외부 의존성, 성능 위험, 데이터 변경 영향을 별도로 정리합니다.

Step 3. 설계 승인

요약된 설계가 의도와 일치하는지 검토합니다. 잘못 이해한 요구사항이 있다면 수정하고 다시 확인합니다.

Step 4. 구현과 검증

승인한 범위에서 코드를 작성하고 테스트를 실행하도록 요청합니다. 변경 파일, 테스트 결과, 남아 있는 위험을 함께 보고받습니다.

승인 전에는 다음과 같이 요청할 수 있습니다.

지금까지 합의한 요구사항과 설계를 요약해 줘.

확정된 사항, 미결정 사항, 검증이 필요한 가정을 구분해 줘.
각 기술적 결정의 근거와 대안도 정리해 줘.

아직 구현을 시작하거나 파일을 변경하지 마.

검토를 마친 뒤에는 다음과 같이 구현을 승인합니다.

위 설계를 검토했고 구현을 승인한다.

합의한 범위에서만 구현해 줘.
기존 아키텍처와 코딩 규칙을 유지하고,
필요한 테스트를 실행해 줘.

변경한 파일, 실행한 테스트와 결과,
확인하지 못한 항목 및 남은 위험을 보고해 줘.

이렇게 승인 단계를 분리하면 인터뷰 중에 논의한 설계와 실제 구현 범위가 달라지는 문제를 줄이는 데 도움이 됩니다. 다만 코드 변경을 막는 프롬프트만으로 모든 도구 동작이 제한되는 것은 아니므로, 실제 파일 변경 여부도 확인해야 합니다.

7. 자주 발생하는 문제와 해결 방법

증상	가능한 원인	확인 및 조치
`/grill-me`가 인식되지 않음	설치 대상 또는 스킬 인식 문제	설치 목록, 대상 에이전트, 실제 스킬 경로를 확인하고 IDE가 스킬을 읽을 수 있는지 점검합니다.
인터뷰가 진행되지 않음	`grilling` 누락 또는 로드 실패	`grilling` 설치 여부와 실제 로드 여부를 확인합니다.
질문 없이 바로 구현함	스킬이 로드되지 않았거나 요청 범위가 불명확함	새 대화에서 스킬을 명시적으로 실행하고 승인 전 구현 금지 조건을 전달합니다.
같은 질문이 반복됨	결정 사항이 명확하게 정리되지 않음	확정한 답변과 미결정 사항을 요약하고 기능 범위를 줄입니다.
설계 문서가 생성되지 않음	`grill-with-docs` 또는 의존 스킬 문제	`grilling`과 `domain-modeling`이 설치되어 있는지, 실제로 로드되었는지 확인합니다.

공식 저장소에서는 grill-me와 grill-with-docs의 의존 스킬이 별도로 설치되지 않으면 제대로 작동하지 않을 수 있다는 문제를 다루고 있습니다. 따라서 명령 실행이 성공했다는 사실만으로 인터뷰 기능까지 정상 작동한다고 판단해서는 안 됩니다.

추가 확인 자료:

8. 설치 및 실행 확인 체크리스트

□ PowerShell에서 node --version과 npm --version이 정상 출력된다.
□ 프로젝트 단위와 전역 설치 중 사용할 범위를 결정했다.
□ Antigravity를 설치 대상으로 지정했다.
□ grill-me와 grilling이 설치 목록에 표시된다.
□ /grill-me를 실행했을 때 실제 인터뷰가 진행되는지 확인했다.
□ 기존 코드베이스용 작업이라면 grill-with-docs와 domain-modeling도 확인했다.
□ 구현 전 설계 요약과 승인 단계를 분리했다.
□ 문서 생성 및 코드 변경이 발생하는 위치를 확인했다.

9. 자주 묻는 질문(FAQ)

Q1. grill-me만 설치하면 사용할 수 있나요?

권장하지 않습니다. 공식 저장소에서는 grill-me가 grilling을 호출하는 구조라고 설명합니다. 따라서 두 스킬을 함께 설치하고 실제 실행 여부를 확인하는 편이 안전합니다.

Q2. 기존 ASP.NET Core 솔루션에서도 grill-me를 사용할 수 있나요?

사용할 수 있습니다. 다만 기존 코드베이스와 설계 기록을 함께 다루는 것이 목적이라면 grill-with-docs를 검토하는 편이 적합합니다. 문서화가 필요하지 않은 간단한 설계 논의에는 grill-me를 사용할 수 있습니다.

Q3. 전역 설치와 프로젝트 설치 중 무엇을 선택해야 하나요?

개인 개발 환경의 여러 프로젝트에서 공통으로 사용하려면 전역 설치가 편리합니다. 특정 프로젝트에 설치 구성을 포함하고 팀과 공유하려면 프로젝트 단위 설치를 고려할 수 있습니다. 실제 공유 방식은 저장소에 포함된 설치 파일과 팀의 운영 규칙도 함께 확인해야 합니다.

Q4. 인터뷰가 끝나면 자동으로 코드를 작성하나요?

인터뷰 종료 자체를 구현 승인으로 간주하지 않는 것이 좋습니다. 최종 설계를 검토한 뒤 명시적으로 구현을 요청하고, 실제 변경 파일과 테스트 결과를 확인합니다.

Q5. 질문을 한 번에 여러 개 받지 않고 하나씩 받을 수 있나요?

공식 grilling 문서에는 한 번에 한 질문씩 진행하도록 설정하는 방법이 소개되어 있습니다. 다만 문서에 제시된 CLAUDE.md 설정 예시는 Claude Code를 대상으로 하므로 Antigravity에서 동일한 설정 파일과 규칙이 적용된다고 단정할 수는 없습니다. Antigravity에서는 프롬프트에 한 번에 한 질문씩 진행하도록 요청하고 실제 동작을 확인하는 방법이 있습니다.

10. 정리

grill-me는 AI에게 코드를 빨리 작성하게 하는 도구라기보다, 구현 전에 요구사항과 설계를 검토하는 데 활용하는 스킬입니다. 특히 요구사항이 불명확하거나 기술적 선택이 많은 작업에서 유용합니다.

사용 목적에 따라 다음과 같이 구분하면 됩니다.

새로운 기능의 아이디어와 요구사항을 정리할 때는 grill-me를 사용합니다.
질문과 의사결정 과정을 직접 다루려면 grilling을 확인합니다.
기존 코드베이스를 분석하면서 용어와 아키텍처 의사결정을 문서로 남기려면 grill-with-docs를 사용합니다.

실무에서는 인터뷰 결과를 그대로 신뢰하기보다 기존 코드와 공식 문서에서 확인할 수 있는 사실을 검증하고, 업무 규칙과 설계 방향은 개발자가 결정해야 합니다. 최종 설계를 승인한 후 구현과 테스트를 진행하는 절차를 유지하면 AI가 임의로 정한 가정이 코드에 반영되는 위험을 줄이는 데 도움이 됩니다.

출처 및 참고 자료

업데이트 안내: 스킬 이름, 의존성, CLI 옵션 및 Antigravity 지원 방식은 변경될 수 있습니다. 실제 설치 전 공식 저장소와 CLI 문서를 다시 확인하세요. 이 글의 명령은 공식 문서에 근거해 작성했으며, 특정 PC에서의 설치 성공이나 실행 결과를 보증하지 않습니다.

#Antigravity #MattPocock #GrillMe #AgentSkills #AICoding #ASPNetCore #SoftwareArchitecture #Windows11 #개발자동화 #AI개발도구

LUCKY BLOG

이 블로그 검색

Pinned Post

MoAI-ADK 워크플로우 명령어 사용법: 누가나 이해하는 프로젝트·계획·구현·정리 가이드