Files
get-shit-done/docs/ko-KR/workflow-discuss-mode.md
2026-03-24 11:42:48 +09:00

3.1 KiB

Discuss 모드: Assumptions vs Interview

GSD의 discuss 단계는 플래닝 전에 구현 컨텍스트를 수집하는 두 가지 모드를 제공합니다.

모드

discuss (기본값)

기존의 인터뷰 방식 흐름입니다. Claude가 단계에서 불명확한 영역을 파악하고 선택지를 제시한 뒤 영역당 약 4개의 질문을 합니다. 다음 상황에 적합합니다.

  • 코드베이스가 새로운 초기 단계
  • 사용자가 사전에 강한 의견을 표현하고 싶은 단계
  • 안내된 대화식 컨텍스트 수집을 선호하는 사용자

assumptions

코드베이스 우선 방식의 흐름입니다. Claude가 서브에이전트를 통해 코드베이스를 깊이 분석하고 (관련 파일 5~15개 읽기) 근거가 있는 가정을 도출하여 확인 또는 수정을 위해 제시합니다. 다음 상황에 적합합니다.

  • 명확한 패턴이 있는 기존 코드베이스
  • 인터뷰 질문이 당연하게 느껴지는 사용자
  • 빠른 컨텍스트 수집 (1520번 대신 24번의 상호작용)

설정

# assumptions 모드 활성화
gsd-tools config-set workflow.discuss_mode assumptions

# interview 모드로 전환
gsd-tools config-set workflow.discuss_mode discuss

설정은 프로젝트별로 적용되며 .planning/config.json에 저장됩니다.

Assumptions 모드 동작 방식

  1. Init — discuss 모드와 동일 (이전 컨텍스트 로드, 코드베이스 스카우트, todo 확인)
  2. 심층 분석 — explore 서브에이전트가 단계와 관련된 코드베이스 파일 5~15개를 읽음
  3. 가정 제시 — 각 가정에는 다음이 포함됩니다.
    • Claude가 할 작업과 그 이유 (파일 경로 인용)
    • 가정이 틀렸을 때 발생하는 문제
    • 신뢰도 수준 (Confident / Likely / Unclear)
  4. 확인 또는 수정 — 사용자가 가정을 검토하고 변경이 필요한 항목을 선택
  5. CONTEXT.md 작성 — discuss 모드와 동일한 출력 형식

플래그 호환성

플래그 discuss 모드 assumptions 모드
--auto 권장 답변을 자동으로 선택 확인 단계를 건너뛰고 Unclear 항목을 자동으로 처리
--batch 질문을 배치로 묶어서 처리 해당 없음 (수정 사항이 이미 배치로 처리됨)
--text 일반 텍스트 질문 (원격 세션) 일반 텍스트 질문 (원격 세션)
--analyze 질문별 트레이드오프 표 표시 해당 없음 (가정에 근거가 포함됨)

출력

두 모드 모두 동일한 6개 섹션을 포함하는 CONTEXT.md를 생성합니다.

  • <domain> — 단계 범위
  • <decisions> — 확정된 구현 결정사항
  • <canonical_refs> — 하위 에이전트가 반드시 읽어야 할 스펙/문서
  • <code_context> — 재사용 가능한 자산, 패턴, 통합 지점
  • <specifics> — 사용자 참고 자료 및 선호사항
  • <deferred> — 향후 단계를 위해 기록된 아이디어

하위 에이전트(researcher, planner, checker)는 모드에 관계없이 동일하게 이 파일을 사용합니다.