콘텐츠로 이동

ADR-0009 — AI 코칭 v0.2: 단계형 힌트 → 대화형 사고 유도

Context

teams/engineering/concepts/사고력-답변구조 v0.1 (2026-05-18 Notion v0.1)에서 채택한 단계형 힌트 1~5단계 정책을 6모 직전 박현수 작성자가 재검토한 결과 v0.2 (2026-05-19 Notion 365fbb39...3eb6)에서 큰 방향 전환을 명시.

v0.1 단계형 힌트의 한계

박현수가 v0.2 §1 "방향 변경"에서 명시한 진단:

학생 수 부족
→ AI 사용량 부족
→ 검증 어려움
→ 개선 속도 저하

추가로 v0.1 패턴의 본질적 한계: - AI가 5단계 끝에 정답을 노출하는 구조 → 학생이 "끝까지 기다려서 답을 받는" 학습 우회 발생 가능 - 사고력 코치 철학(원칙 1·2)이 "끝까지 막히면 결국 이해시킨다"(원칙 3 v1)와 충돌 — 단계 4·5에서 AI가 답을 주면 학생은 "이해한 척" 가능

v0.2 전환 결정

박현수가 v0.2 §1·§4·§5에서 명시: - 단계형 힌트 → 대화형 사고 유도: AI가 질문, 학생이 답변, AI가 반응 + 다음 질문 ... 반복 - 원칙 3 변경: "끝까지 막히면 이해시킨다" → "학생이 직접 답을 선택한다" (AI는 마지막 답을 대신 안 고름) - MVP 검증 우선순위: B(선생님) → A(학생) → A → B (학생 학습 경험 최우선) - 1차 MVP 범위 재정의: 질문/과제 + AI → 오픈챌린지 + AI 코칭 (질문/과제는 후순위)

Decision

  1. AI 답변 구조 전환: 단계형 힌트 1~5단계 → 대화형 사고 유도 (multi-turn 질문·답변)
  2. AI 자율성 축소 + 학생 자율성 확대: AI는 마지막 답을 대신 선택하지 않음. 학생이 후보 중 직접 선택
  3. 학생 컨텍스트 단순화: strengths·weaknesses → difficulties (체크리스트 부담 ↓)
  4. AI 만족도 수집 신규: 5점 평가 + 자유 의견 (운영 개선 데이터)
  5. API path versioning: /api/v2/qna/{id}/ai-turn 신규, /api/v1/qna/{id}/ai-hint deprecated (12개월 후방 호환 — Anthropic·Notion 패턴)
  6. wiki/concepts versioning: 기존 concepts/사고력-답변구조 status superseded, 신규 concepts/사고력-답변구조-v0.2. 두 페이지 공존 (Karpathy "decisions are forever")
  7. FRD versioning (ADR-0005 case B): 기존 spec.md → archive/spec-v0.1-2026-05-21.md mv, 새 spec.md v0.2 작성
  8. 1차 MVP 채널: 오픈챌린지(teams/engineering/concepts/챌린지식-풀이) 1차 핵심 채널로 격상

Consequences

긍정

  • 사고 과정 강화: AI가 정답 노출 안 함 → 학생이 직접 선택 → "이해한 척" 감소
  • 데이터 수집 풍부: 대화 multi-turn + 만족도 점수 → 6모 시즌 빠른 가설 검증
  • 오픈챌린지 채널 격상으로 비로그인 학생 유입 → AI 사용량 확보 (wiki/domains/challenge 우선순위 ↑)

부정

  • 대화 길이 예측 어려움 → LLM 토큰 비용 증가 (단계형 ~500 토큰 → 대화형 ~2000~5000 토큰 예상)
  • 학생이 답 선택을 안 하고 이탈할 가능성 → 명확한 "답 선택" UX 강조 필요
  • BE/FE 동시 배포 + DB 마이그레이션 필요 (mvp-back:docs/frd/사고력-답변구조/spec §4 Flyway V40~V44)
  • v0.1 단계형 힌트 코드 12개월 후방 호환 부담 (/api/v1/ai-hint deprecated 채널)

영향 페이지

Alternatives 평가

대안 평가
v0.1 단계형 유지 (변경 안 함) ❌ Notion v0.2 방향 전환 반영 안 됨. 박현수 의사결정과 일치하지 않음
하이브리드 (대화형 1~3턴 + 마지막 단계형 답 노출) ❌ 복잡도 ↑, 원칙 3 v0.2 ("학생이 직접 답 선택")과 충돌, 사고력 효과 약화
대화형 + AI가 답까지 선택 (학생 패시브) ❌ v0.2 원칙 3 위반. 사고력 코치 철학 약화
✅ 대화형 + 학생 직접 답 선택 + 만족도 수집 (채택) Notion v0.2 그대로 반영. 사고력 코치 철학 일관

API path 정책 (Notion·OpenAI 스타일)

Path 상태 지원 기간
POST /api/v1/student/qna/{id}/ai-hint deprecated 12개월 (2027-05-21까지)
POST /api/v2/student/qna/{id}/ai-turn active 신규 표준
POST /api/v2/student/qna/{id}/ai-rating active 만족도 수집 신규

Header 기반 versioning (Stripe 패턴)은 채택 X — 작은 팀에 오버헤드, URL 명시가 더 명확.

Status

  • 2026-05-21: accepted

Date

2026-05-21