Claude Code AskUserQuestion

This is the long-form blog cut of a note I originally posted on LinkedIn. The claims, numbers, and product names are the same; the formatting is for reading on the site.

Context

Original framing (translated in place for key technical posts; substance preserved):

Claude Code 에는 Plan 모드에서만 쓰이는 줄 알았던 도구가 하나 있어요. 바로 AskUserQuestion 이라는 내장 도구인데요.

Claude Code 개발자 Tariq 이 예전에 한 번 언급했던 기능이지만, 인디 개발자로 유명하신 Danny Postma 가 이걸 훨씬 더 효과적인 Skill 로 만들어서 공유했길래 직접 따라 만들어봤어요. 기가 막힙니다.

1️⃣ 핵심 아이디어: AI 가 나를 인터뷰하게 만들기

보통 우리가 AI 에게 요구 사항을 전달하잖아요. 이 Skill 은 반대예요. AI 가 먼저 질문을 던지고, 우리가 대답하는 구조로 뒤집어요.

• 기술 구현 방식, UI/UX 고려사항, 우려 지점, 트레이드오프까지 • “뻔한 질문은 하지 말고, 깊이 파고들어라”는 지시가 핵심 • 완료될 때까지 계속 인터뷰를 이어가도록 설계

2️⃣ 왜 이 방식이 효과적인가

제가 직접 써보니, 혼자 요구 사항 문서 쓸 때는 놓치던 부분들이 질문을 통해 드러나더라고요

Claude Code 에는 Plan 모드에서만 쓰이는 줄 알았던 도구가 하나 있어요. 바로 AskUserQuestion 이라는 내장 도구인데요.

Claude Code 개발자 Tariq 이 예전에 한 번 언급했던 기능이지만, 인디 개발자로 유명하신 Danny Postma 가 이걸 훨씬 더 효과적인 Skill 로 만들어서 공유했길래 직접 따라 만들어봤어요. 기가 막힙니다.

1️⃣ 핵심 아이디어: AI 가 나를 인터뷰하게 만들기

보통 우리가 AI 에게 요구 사항을 전달하잖아요. 이 Skill 은 반대예요. AI 가 먼저 질문을 던지고, 우리가 대답하는 구조로 뒤집어요.

• 기술 구현 방식, UI/UX 고려사항, 우려 지점, 트레이드오프까지 • “뻔한 질문은 하지 말고, 깊이 파고들어라”는 지시가 핵심 • 완료될 때까지 계속 인터뷰를 이어가도록 설계

2️⃣ 왜 이 방식이 효과적인가

제가 직접 써보니, 혼자 요구 사항 문서 쓸 때는 놓치던 부분들이 질문을 통해 드러나더라고요. 특히 “당연하다고 생각해서 안 적는 것들”이 문제인데, AI 는 그런 암묵적 가정을 모르니까 계속 물어봐요. 이 과정에서 스펙이 훨씬 촘촘해져요.

3️⃣ 실제 워크플로우 예시

이 Skill 을 만든 Danny Postma 의 작업 흐름이에요:

• /interview 명령으로 인터뷰 시작 • 생성된 스펙 파일을 Plan 모드에 투입 • 구체화된 계획을 기반으로 Ralph 로 그냥 반복해서 구현 진행

저는 이걸 “역방향 요구사항 추출”이라고 부르고 싶어요. 내가 아는 걸 꺼내는 게 아니라, AI 가 내가 모르는 걸 찾아내는 거죠.

4️⃣ Skill 전문 (바로 복사해서 사용 가능)

---

argument-hint: [instructions] description: Interview user in-depth to create a detailed spec allowed-tools: AskUserQuestion, Write

Follow the user instructions and interview me in detail using the AskUserQuestionTool about literally anything: technical implementation, UI & UX, concerns, tradeoffs, etc. but make sure the questions are not obvious. be very in-depth and continue interviewing me continually until it’s complete. then, write the spec to a file. $ARGUMENTS

참고로 AskUserQuestion, Write 는 이미 Claude code 에 내장되어 있던 도구입니다. 그런 점에서 좋은 도구는 새로 만드는 게 아니라, 있는 걸 다르게 조합하는 데서 나와요.

AI 에게 질문 받는 경험, 한 번 해보시길 권해드립니다. 참고로 Plan mode 를 사랑하는 저에게 정말 효과적인 Skill 이었습니다.

다만 해당 내용에서 complete 조건에 대해서 살짝 구체화해보면 더 좋은 SKill 이 될 것 같아 오늘 시도해보려고 합니다. 참고로 너무 구체적으로 작성하면 AI 의 사고 폭이 줄어들 수 있어 주의해 작성할 예정입니다.