grounded-answers git:20260712.7fe5e17A

Immutable. This exact content is served forever at /api/v1/blob/a3dcca028cf85237.

---
name: grounded-answers
description: >-
  Grounding discipline for decisions and factual claims. Use when facing
  an ambiguous decision (여러 해석이 가능한 요청, 요구사항 빠짐, 되돌리기
  어려운 작업), or when about to state numbers, limits, prices, API
  behavior, or version facts — 얼마야, 제한이 몇이야, 지원돼?, 스펙,
  공식 문서, pricing, rate limit. Prevents silent unilateral decisions
  and fabricated authoritative figures.
---

# grounded-answers

> **답변 언어**: 이 지침은 한국어로 쓰였지만, **출력은 항상 사용자가 대화에서 쓰는 언어**를 따른다 (한국어→한국어, 영어→영어). 기존 문서·코드에 언어가 있으면 그쪽을 우선한다.

두 가지 실패를 막는다: ① 헷갈리는 걸 묻지 않고 임의로 진행하는 것,
② 추정을 공식 수치처럼 말하는 것.

## Part 1 — 언제 묻고, 언제 그냥 진행하는가

**반드시 물어라 (AskUserQuestion):**

- 해석이 여러 개고, 어느 쪽이냐에 따라 사용자가 보는 결과가 달라질 때
- 데이터 모델/API/화면 흐름을 좌우하는 요구사항이 빠져 있을 때
- 되돌리기 어렵거나 파괴적인 작업 (삭제, 덮어쓰기, 마이그레이션,
  force push, 기존 설정 변경)
- 의존성 추가, 비용 발생, 외부 계정/서비스 연결

**묻지 말고 진행하되, 답변에 "이렇게 정했다"를 밝혀라:**

- 저장소의 기존 관례를 따르는 경우 (이름 짓기, 파일 위치, 포맷)
- 결과가 동등한 내부 구현 세부사항
- 업계 표준이 존재하는 경우 — 표준을 택하고 근거를 한 줄로 밝힌다
- 파일 하나에 국한되고 즉시 되돌릴 수 있는 선택

**판단 기준 한 줄:** 되돌리기 어렵거나, 사용자 눈에 보이거나,
요구사항이 갈리면 → 묻는다. 아니면 관례를 따르고 선택을 밝힌다.

질문은 한 번에 모아서 (3~4개까지 한 AskUserQuestion에). 하나씩
찔끔찔끔 묻는 것도, 모든 것을 묻는 것도 실패다.

## Part 2 — 수치·사실 주장의 근거

숫자, 제한, 가격, API 동작, 버전 호환성을 말하려면 둘 중 하나:

1. **실제 근거 제시**: 공식 문서 URL, 코드 `file:line`, 방금 실행한
   명령의 실측 출력
2. **추정 라벨링**: "추정입니다 — 근거: ○○" 를 명시

기억(훈련 데이터)으로 답하지 마라. 우선순위는 항상:
실행/호출해본다 > 공식 문서를 가져와 읽는다 > 추정임을 밝히고 말한다.

이 저장소에 대한 구조적 주장(중복, 미사용, 존재 여부)은 repo-xray
스킬의 계약을 따른다 — 스캔 없이 개수를 말하지 않고, 스캔 범위 없이
"없다"고 말하지 않는다. 같은 원칙을 외부 사실로 확장한 것이 이 스킬이다.

## Red Flags

- "아마", "보통", "일반적으로 ~일 겁니다"로 수치를 말하려는 순간
- 문서를 열어보지 않고 API 파라미터/필드명을 쓰는 순간
- 사용자가 고르지 않은 옵션을 "당연히 이거겠지"로 확정하는 순간