배경 / 문제
docs/F007_CHATBOT.md는 F-007 결과 기반 챗봇의 설계 및 기획 문서입니다. 현재 일부 내용이 PR 번호와 선행 작업 나열 중심으로 작성되어 있어, 시간이 지나면 작업 이력 문서처럼 보일 수 있습니다.
설계 문서에는 구현 이력보다 목표, 경계, 데이터 흐름, 안전 원칙, 검증 전략이 남아야 합니다.
제안 내용
docs/F007_CHATBOT.md를 설계 중심으로 정리합니다.
- PR 번호 중심의 선행 작업 설명 제거 또는 축소
- 현재 구조를 역할/컴포넌트 관점으로 정리
- 구현 순서 섹션을 향후 단계/검증 흐름 중심으로 정리
- 스모크 CLI는 작업 내역이 아니라 검증 방법으로 짧게 반영
고민 (기술 선택 이유)
| 후보 |
장점 |
단점 |
| PR 이력 유지 |
변경 추적이 쉬움 |
설계 문서가 작업 로그처럼 변함 |
| PR 이력 제거 후 설계 중심 정리 |
문서 목적이 명확해짐 |
GitHub PR 링크 기반 맥락은 줄어듦 |
| 별도 변경 이력 문서 생성 |
작업 기록과 설계를 분리 가능 |
현재 규모에 비해 문서가 과해짐 |
이번 작업은 F007_CHATBOT.md를 설계 문서로 유지하는 것이 목적이므로, PR 이력은 제거하고 필요한 구현 상태는 역할/검증 관점으로만 남깁니다.
평가 지표
| 지표 |
목표값 |
측정 방법 |
| PR 번호 중심 서술 |
0건 |
`rg "PR # |
| 스모크 검증 경로 표시 |
1곳 이상 |
rg "chat_answer_smoke" docs/F007_CHATBOT.md |
| 문서 링크/마크다운 오류 |
없음 |
Markdown 구조 수동 검토 |
완료 조건
배경 / 문제
docs/F007_CHATBOT.md는 F-007 결과 기반 챗봇의 설계 및 기획 문서입니다. 현재 일부 내용이 PR 번호와 선행 작업 나열 중심으로 작성되어 있어, 시간이 지나면 작업 이력 문서처럼 보일 수 있습니다.설계 문서에는 구현 이력보다 목표, 경계, 데이터 흐름, 안전 원칙, 검증 전략이 남아야 합니다.
제안 내용
docs/F007_CHATBOT.md를 설계 중심으로 정리합니다.고민 (기술 선택 이유)
이번 작업은
F007_CHATBOT.md를 설계 문서로 유지하는 것이 목적이므로, PR 이력은 제거하고 필요한 구현 상태는 역할/검증 관점으로만 남깁니다.평가 지표
rg "chat_answer_smoke" docs/F007_CHATBOT.md완료 조건
docs/F007_CHATBOT.md의 PR 이력 중심 섹션 정리