grilling

Files (1)

• SKILL.md

SKILL.md (first lines)

# grilling — 계획을 확정할 때까지 묻는 인터뷰

계획·설계의 모든 갈림길을 **한 번에 하나씩** 물어 함께 확정한다. 결정 트리의 가지를 하나씩 내려가며, 앞 답이 다음 질문을 결정한다. 서로 합의에 도달했다고 확인하기 전에는 계획을 실행하지 않는다.

## 묻기 전에

- **코드·문서를 뒤져 스스로 답할 수 있는 것은 묻지 않는다.** 확인한 결과는 질문 대신 한 줄 공유("~는 이미 ~로 되어 있어 그대로 씁니다")로 바꾼다.
- 남은 갈림길을 중요도순으로 정렬한다: **되돌리기 비싼 결정**(데이터 구조, 외부로 나가는 값, 사용자에게 보이는 계약)이 먼저다.
- 뻔한 질문은 던지지 않는다. 숨은 가정을 드러내고, 사용자가 아직 생각 못 한 엣지 케이스와 트레이드오프를 수면 위로 올리는 질문이 이 인터뷰의 가치다.

## 질문 형식 — 이 스킬의 첫 번째 심장

**선택지를 만들 수 있는 질문은 반드시 AskUserQuestion 툴로 묻는다.** 평문으로 물으면 사용자가 긴 답을 타이핑해야 하지만, 이 툴은 화면에 클릭 가능한 선택지로 렌더링되고 "Other"로 자유 입력도 열려 있다.

- **한 호출에 질문 1개만.** 여러 질문을 묶으면 어리둥절해진다.
- **툴 호출이 곧 질문이다.** 질문이나 선택지를 평문으로 쓴 뒤 툴로 같은 것을 또 묻지 않는다 — 두 번 읽게 만드는 벽 텍스트가 된다. 평문에는 배경 브리핑(아래 난이도 절)만 남긴다.
- 선택지는 2~4개. **내 권장안을 첫 번째에 두고 라벨 끝에 "(권장)"** 을 붙인다.
- 각 선택지의 description 은 "이걸 고르면 화면/데이터/일정이 어떻게 되는지" **결과 중심**으로 쓴다. 구현 방식 나열이 아니다.
- **화면 배치·흐름·데이터 모양이 갈리는 질문에서는 preview 가 기본값이다.** 말로 설명한 구조 차이는 머리에 그려지지 않는다 — 각 option 의 preview 필드에 그 안을 골랐을 때 실제로 보게 될 것(가짜 데이터 몇 줄이 든 표, 화면 목업, 목록 예시)을 담아 눈으로 비교하게 한다. 예:

  ```json
  {
    "label": "한 목록으로 통합 (권장)",
    "description": "수리·교환이 시간순 한 줄로 이어져 보입니다.",
    "preview": "날짜    | 종류 | 내용\n03-02  | 수리 | 세탁기 소음\n03-09  | 수리 | 같은 건 재방문\n03-15  | 교환 | 신품 교환 완료"
  }
  ```

  preview 로 부족한 흐름 비교는, 시각화 위젯(visualize MCP 의 show_widget)이 있는 환경에선 질문 전에 다이어그램으로 보여주고, 없으면 텍스트 표로 대신한다.

자유 서술이 꼭 필요한 질문(이름 짓기, 문구, 우선순위를 말로 듣기)만 일반 텍스트로 묻는다.

## 말의 난이도 — 두 번째 심장

질문이 어려워지는 순간 인터뷰는 죽는다. 트리 깊이 들어갈수록 구현 용어로 미끄러지기 쉬운데, **상대는 지금 코드를 보고 있지 않다.**

- 질문의 주어는 "화면에서 / 사용자가 / 데이터가 어떻게 되나"다. 코드 구조 용어(클래스·트랜잭션·컴포넌트·API 경로 등)는 질문의 주어가 될 수 없다 — 필요하면 괄호 보조로만 쓴다.
- 배경 없이 답할 수 없는 질문이면, 질문 전에 **2~3문장으로 상황을 쉬운 말로** 깔아준다. 3문장으로 안 되면 질문이 너무 큰 것이다 — 더 작은 결정으로 쪼갠다.
- **난이도 초과 신호를 감지하면 즉시 후퇴한다.** 답이 짧아지거나("어…", "글쎄"), 반문이 오면("그게 무슨 말이야?") 같은 질문을 같은 어휘로 반복하지 말고, 더 쉬운 말 + 구체적 예시나 그림으로 **재구성해서** 다시 묻는다. 예시는 실제 도메인의 값(주문 1건, 고객 이름 하나)으로 든다.

## 진행 관리

- 5문항 내외마다 한 번, 지금까지 확정된 것을 쉬운 말로 3~5줄 요약하고 이어간다. 사용자가 어디까지 왔는지 놓치지 않게 하기 위해서다.
- **끝날 때**: 확정된 결정 전체를 정리해 보여주고, AskUserQuestion 으로 승인을 받는다(진행 (권장) / 수정할 것 있음 / 처음부터). 승인 전에는 계획을 실행하지 않는다.

From bigbulgogiburger/caseworker, MIT.

More from bigbulgogiburger/caseworker