12강. 알려진 문제와 다음 개선: 미완성 항목을 정직하게 관리하기

?1. 이번 강의에서 해결할 문제

모든 문제를 숨기거나 반대로 작은 아이디어까지 버그로 나열하면 현재 완성도를 판단하기 어렵습니다. 실제 영향과 재현 여부를 기준으로 알려진 문제와 다음 개선을 분리합니다.

✓2. 학습 목표

✓이번 강의를 마치면

• 버그, 제한 사항과 개선 아이디어를 구분합니다.
• 영향·재현·우회 방법과 우선순위를 기록합니다.
• README에서 핵심 제한을 쉽게 찾도록 연결합니다.

◇3. 핵심 개념

버그는 의도한 결과와 다른 동작, 제한 사항은 현재 범위에서 지원하지 않는 조건, 개선은 없어도 현재 완료 기준을 통과하는 후속 아이디어입니다. 심각도는 보기 불편함보다 핵심 흐름의 중단 가능성으로 정합니다.

✎4. 단계별 실습

문서 작업 · 산출물: <PROJECT_ROOT>/docs/known-issues.md

docs/known-issues.md

# 알려진 문제와 다음 개선

## 알려진 문제
| ID | 상황·재현 | 영향 | 우회 방법 | 우선순위 |
| --- | --- | --- | --- | --- |
| K-01 | 설정 파일이 없을 때 실행 | 시작 중단 | 예제 설정을 복사 | 높음 |
| K-02 | 매우 긴 제목 표시 | 일부 줄바꿈 어색함 | 제목을 두 줄로 제한 | 낮음 |

## 지원하지 않는 범위
- 로그인, 실제 문의 전송, 온라인 순위표는 구현하지 않았습니다.

## 다음 개선
1. K-01에 이해하기 쉬운 오류 메시지 추가
2. 자동화 가능한 핵심 테스트 한 개 추가
3. 작은 화면의 긴 텍스트 레이아웃 보완

테스트 작업: 표의 재현 절차를 다시 확인합니다. 해결된 항목은 삭제하지 않고 해결 버전과 관련 기록으로 이동할 수 있습니다.

완료 기준: 실제 알려진 문제 또는 현재 확인된 치명적 문제 없음의 검증 범위, 미지원 범위, 우선순위가 있는 다음 개선 3개가 있습니다.

§5. 작성 방식이 필요한 이유

한계를 공개하면 평가자가 실패를 우연히 발견하기 전에 범위와 대응을 이해합니다. 해결하지 못했다는 사실보다 영향을 모르거나 숨기는 태도가 더 큰 위험입니다.

!6. 자주 하는 실수와 해결법

!자주 하는 실수

• 문제를 모두 숨김: 영향과 우회 방법을 함께 공개합니다.
• 아이디어를 현재 기능처럼 표현: 다음 개선 섹션으로 분리합니다.
• 심각도를 감정으로 정함: 핵심 흐름·데이터·접근성 영향으로 판단합니다.
• 기능을 더 넣어 문제를 덮음: 현재 문제를 재현하고 우선순위를 먼저 정합니다.

✎7. 직접 실습

✎직접 실습

docs/known-issues.md를 작성하세요. 완료 기준은 각 문제에 재현 조건, 영향, 우회 방법이 있고 README에서 이 문서로 연결되며 다음 개선 3개가 완료 기준을 가집니다.

?8. 이해 점검 질문 3개

?이해 점검

1. 제한 사항과 버그의 차이는 무엇인가요?
2. 알려진 문제에 우회 방법을 적는 이유는 무엇인가요?
3. 확인된 문제가 없을 때도 검증 범위를 써야 하는 이유는 무엇인가요?

■9. 핵심 요약

■핵심 요약

현재 문제, 미지원 범위와 다음 개선을 구분하고 영향·우회 방법·우선순위를 씁니다. 미완성을 숨기지 않는 기록이 결과물의 신뢰를 높입니다.