grill-me
작성자 alirezarezvanigrill-me는 한 번에 하나의 질문으로 계획과 설계를 집요하게 검증하는 Decision Support skill입니다. 추천 답변 제시, codebase 탐색, decision branches 추출과 sessions 추적을 돕는 helper scripts를 통해 의사결정 과정을 더 체계적으로 점검할 수 있게 해줍니다.
이 skill은 78/100점으로, 일반적인 프롬프트보다 더 체계적으로 계획이나 설계를 검증해 줄 에이전트를 찾는 디렉터리 사용자에게 충분히 추천할 만한 후보입니다. 활성화 패턴이 분명하고, 상호작용 방식이 기억하기 쉬우며, 실무에 쓸 수 있는 지원 파일도 갖추고 있습니다. 다만 완성도 높은 end-to-end 패키지라기보다는 일부 설정이 모호하고 휴리스틱 기반 도구에 의존한다는 점은 감안해야 합니다.
- 트리거가 명확합니다. frontmatter에 사용자가 계획을 스트레스 테스트하고 싶거나, 설계에 대해 집중 질문을 받고 싶거나, “grill me”라고 말할 때 사용하라고 명시되어 있습니다.
- 운영 규칙이 구체적입니다. 한 턴에 질문 하나, 추천 답변 제공, 질문 전 codebase 탐색, decision tree를 깊이 우선으로 따라가는 방식이 정해져 있습니다.
- forcing-question 패턴, 중단 조건, decision branches 추출, 질문 생성, multi-turn sessions 추적을 위한 Python scripts 등 유용한 보조 자료가 포함되어 있습니다.
- skill 경로에 설치 명령이나 README가 없어, 사용자는 상위 저장소나 자신의 Claude Skills 설정을 바탕으로 설치 방법을 추론해야 합니다.
- 함께 제공되는 도구는 휴리스틱 및 정규식 기반이며, 표시된 skill 디렉터리 밖의 persona agent와 slash command를 참조하므로 도입하려면 추가적인 repo 맥락이 필요할 수 있습니다.
grill-me skill 개요
grill-me가 하는 일
grill-me는 Claude 스타일 에이전트 워크플로를 위한 의사결정 심문형 skill입니다. 계획에 대해 넓고 두루뭉술한 피드백을 주는 대신, 불명확한 분기, 의존성, 트레이드오프, 가정이 정리될 때까지 한 번에 하나의 질문만 던집니다. 핵심 동작은 단순하지만 효과적입니다. 답을 피할 수 없는 질문을 하고, 권장 답변을 함께 제시한 뒤, 사용자의 응답을 기다리고, 그다음 의사결정 트리를 따라 계속 진행합니다.
Decision Support에 가장 잘 맞는 경우
제품 계획, 엔지니어링 설계, 아키텍처 제안, 마이그레이션 전략, 출시 체크리스트, 또는 “X를 해야 한다”는 문서를 실행 전에 강하게 검증해야 할 때 Decision Support 용도로 grill-me를 사용하면 좋습니다. 특히 계획 안에 TBD, 모호한 트레이드오프, 숨은 의존성, 의식적으로 선택한 것이 아니라 기본값처럼 굳어진 결정이 들어 있을 때 유용합니다.
이 skill이 다른 점
차별점은 엄격함입니다. grill-me skill은 질문 열 개를 한꺼번에 묶어 던지거나, 일반적인 비평으로 흐르거나, 사용자가 애매하게 답하도록 내버려 두지 않습니다. 불필요한 질문보다 코드베이스 탐색을 우선하고, 분기를 깊이 우선으로 따라가며, “왜 Y가 아니라 X인가?”, “무엇을 보면 이 접근이 틀렸다고 확신할 수 있는가?” 같은 선택을 강제하는 질문을 던집니다. 저장소에는 의사결정 분기 추출, 질문 생성, 멀티턴 세션 추적을 위한 Python stdlib 전용 헬퍼도 포함되어 있습니다.
적합하지 않은 경우
처음부터 완성도 높은 계획을 대신 써 주는 도구, 가벼운 브레인스토밍 파트너, 빠른 “LGTM” 리뷰를 원한다면 grill-me를 설치하지 않는 편이 낫습니다. 이 skill은 의도적으로 불편하게 설계되어 있습니다. 대화를 느리게 만들고, 약한 논리를 드러내며, 결정을 명확히 하도록 압박합니다. 그래서 비용이 큰 의사결정 전에는 강력하지만, 사소한 선택에는 과할 수 있습니다.
grill-me skill 사용 방법
grill-me 설치와 저장소 경로
다음 명령으로 설치합니다.
npx skills add alirezarezvani/claude-skills --skill grill-me
저장소에서 이 skill은 engineering/grill-me/skills/grill-me 아래에 있습니다. 먼저 SKILL.md를 읽고, 더 나은 grill 세션을 운영하는 방법을 설명하는 지원 파일인 references/forcing_question_patterns.md, references/when_to_stop_grilling.md, references/companion_tooling.md를 확인하세요. 스크립트는 scripts/에 있으며 Python stdlib만 필요합니다.
skill에 제공해야 하는 입력
좋은 grill-me usage를 위해서는 막연한 목표가 아니라 계획서나 설계 산출물을 제공해야 합니다. 좋은 입력에는 다음이 포함됩니다.
- 내리려는 결정
- 현재 제안된 접근 방식
- 검토했던 대안
- 알려진 제약, 마감일, 리스크
- 아직 TBD인 부분 또는 정치적으로 민감한 부분
- 관련 코드, 문서, 티켓, 아키텍처 노트로 이어지는 링크나 경로
약한 프롬프트 예시는 다음과 같습니다. “이 아이디어를 grill해 줘.”
더 나은 프롬프트는 다음과 같습니다. “docs/auth-migration.md에 grill-me를 적용해 줘. Q3 전에 세션 저장소를 Redis에서 Postgres로 옮길 계획이야. 롤백, 성능 리스크, billing service 의존성이 실제로 확정된 것인지에 집중해 줘.”
실무 워크플로
신호가 높은 grill-me guide 워크플로는 다음과 같습니다.
- 계획을 markdown 파일에 작성합니다.
- 에이전트에게
grill-me를 사용하고 먼저 계획을 읽으라고 요청합니다. - 답이 저장소나 코드베이스에 있다면, 사용자에게 묻기보다 에이전트가 파일을 확인하게 합니다.
- 한 번에 하나의 질문에만 답합니다.
- 결정이 확정될 때마다 기록합니다.
- 해결되지 않은 분기가 모두 소진될 때에만 멈춥니다.
규모가 큰 계획이라면 헬퍼 스크립트를 로컬에서 실행하세요.
python scripts/decision_tree_extractor.py path/to/plan.md
python scripts/question_generator.py path/to/plan.md --output json
python scripts/grill_session_tracker.py --action start --session auth-migration --plan path/to/plan.md
이 도구들은 LLM을 호출하지 않습니다. 의사결정 분기를 드러내고 긴 리뷰 세션 동안 상태를 보존하는 데 도움을 줍니다.
효과적인 프롬프트 패턴
권한, 범위, 중단 규칙을 함께 주는 프롬프트가 잘 작동합니다.
“Use the grill-me skill for Decision Support on this plan: <path>. Ask one question per turn. Provide your recommended answer with each question. Explore the codebase before asking anything answerable from files. Walk dependencies depth-first. Track resolved decisions and tell me when every branch is answered or when no new questions arise.”
이 점이 중요한 이유는 이 skill의 가치가 순서에 있기 때문입니다. “피드백을 한 번에 모두 달라”고 요청하면 가장 큰 장점을 우회하게 됩니다.
grill-me skill FAQ
grill-me는 엔지니어링 계획에만 쓰나요?
아닙니다. 저장소 경로는 엔지니어링 중심이고, 코드베이스 탐색 규칙도 소프트웨어 프로젝트에서 특히 유용하지만, 이 방법은 제품, 운영, 채용, GTM, 전략 의사결정에도 적용할 수 있습니다. 문장 다듬기보다 숨은 가정이 더 위험한 모든 계획에 잘 맞습니다.
일반 프롬프트보다 나은 점은 무엇인가요?
“이 계획을 비판해 줘” 같은 일반 프롬프트는 보통 관찰 목록을 만들어 냅니다. grill-me는 심문 루프를 만듭니다. 각 질문은 의사결정 분기에 연결되어 있고, 권장 답변을 포함하며, 계속 진행하기 전에 사용자의 응답을 기다립니다. 그래서 모호함을 단순히 찾아내는 데서 그치지 않고 실제로 해소하는 데 더 적합합니다.
초보자도 grill-me를 사용할 수 있나요?
네. 다만 초보자는 짧은 계획으로 시작하는 것이 좋습니다. 이 skill은 트레이드오프, 중단 기준, 대안을 요구하기 때문에 다소 강하게 느껴질 수 있습니다. 아직 도메인을 잘 모른다면 모르는 부분을 솔직하게 답하세요. 그러면 세션에서 “아직 결정하지 않은 것”과 “정보가 부족해 막힌 것”을 분리할 수 있습니다.
설치 전에 무엇을 확인해야 하나요?
사용 중인 에이전트 런타임이 GitHub의 skill을 지원하는지, 그리고 멀티턴 워크플로를 감당할 수 있는지 확인하세요. 또한 SKILL.md와 세 개의 reference 파일을 미리 살펴보세요. 헬퍼 스크립트를 사용할 계획이라면 로컬 Python 명령을 실행할 수 있는지, 세션 JSON을 ~/.grill_sessions/에 쓰는 것이 현재 환경에서 허용되는지도 확인해야 합니다.
grill-me skill 개선 방법
grill-me에 더 선명한 원본 자료 제공하기
grill-me 출력 품질을 가장 빠르게 높이는 방법은 계획을 더 쉽게 점검할 수 있게 만드는 것입니다. 목표, 비목표, 제약, 대안, 의존성, 롤아웃, 롤백, 지표, 열린 질문에 대한 heading을 추가하세요. decision extractor는 “we will”, “TBD”, “vs”, “depends on”, “trade-off” 같은 신호를 찾기 때문에, 명시적인 표현이 워크플로가 분기를 찾는 데 도움이 됩니다.
흔한 실패 모드 피하기
흔한 실패에는 한 번에 너무 많은 질문을 하는 것, 애매한 답변을 받아들이는 것, 코드베이스 탐색을 건너뛰는 것, 처음 불편한 분기에서 멈추는 것이 포함됩니다. 에이전트가 질문을 묶어서 던진다면 바로잡으세요. “Return to grill-me: one question only, with a recommended answer.” 이미 문서화된 내용을 묻는다면 해당 파일을 알려 주고, 계속하기 전에 반드시 확인하라고 요구하세요.
첫 세션 이후 반복하기
첫 grill이 끝나면 확정된 결정과 새로 발견한 리스크를 반영해 계획을 수정하세요. 그런 다음 decision_tree_extractor.py를 다시 실행합니다. 이 두 번째 패스에서는 사용자의 답변 때문에 새로 생긴 분기가 발견되는 경우가 많습니다. 좋은 세션은 TBD를 줄이고, 대안에 대한 명확한 거절 이유를 남기며, 위험한 선택에 대한 명시적인 중단 기준을 만듭니다.
팀에 맞게 skill 조정하기
팀은 로컬 예시를 추가해 도입률을 높일 수 있습니다. 좋은 architecture decision record, 나쁜 모호한 계획, 선호하는 리스크 분류, 표준 출시 기준 등을 넣어 두세요. 핵심 grill-me 규율은 유지하되, 권장 답변의 문체는 조직의 제약에 맞게 조정하면 됩니다. 목표는 더 거칠게 질문하는 것이 아니라, 비용이 큰 작업을 시작하기 전에 더 빠르게 공동 이해를 만드는 것입니다.