Files
clean-architecture-backend-…/docs/problem-statement.md
T
DongHyeonka d0c3f91a3b docs: 비전과 문제 정의의 빈 양식을 둔다
하네스 설계(design-docs harness/01-harness-design.md)는 검증 진입점
scripts/verify.sh와 비전 문서 docs/vision.md가 함께 생긴다고 했다.
verify.sh는 이 브랜치가 만들었는데 비전과 문제 정의 자리가 없었다.

claude-harness template/docs의 두 양식을 옮긴다. vision.md는 세 문장
자리만 두고 소유자가 쓴다(에이전트는 읽기만 한다). problem-statement.md는
고객의 말 그대로·지금 버티는 법·하지 않는 것·잴 수 있는 성공 기준 칸을
둔다. AGENTS.md 첫 문단과 docs/README.md 「폴더 밖 문서」가 두 파일을
가리킨다.

검증: python3 scripts/check-docs.py, check-work-docs.py 통과.
2026-11-08 22:32:16 +09:00

35 lines
1.2 KiB
Markdown

# 문제 정의 — clean-architecture-backend-template
> 아이디어가 아니라 고객의 문제에서 출발한다. 좋은 스펙은 헷갈리지 않게 하는 스펙이다.
> 바뀌면 고친다(살아 있는 문서). 왜 바꿨는지는 커밋 본문이나 결정 기록에 남긴다.
## 고객의 말 그대로
- (채울 것: 고객이 실제로 한 말을 따옴표로. 해석하지 않는다)
## 지금은 어떻게 버티나
- (채울 것: 고객이 지금 쓰는 우회 방법과 그 비용)
## 하지 않는 것
- (채울 것: 이번에 일부러 풀지 않는 문제, 만들지 않는 기능)
## 성공 기준
| 기준 | 구체적으로 | 어떻게 재나 | 목표 값 | 기한 |
|---|---|---|---|---|
| (채울 것) | | | | |
## 세 관점 점검
| 관점 | 묻는 것 | 답 |
|---|---|---|
| 비즈니스 | 돈이 되나, 누가 대가를 치르나 | (채울 것) |
| 기술 | 만들 수 있나, 가장 위험한 가정은 | (채울 것) |
| 고객 | 쓸모 있나, 지금 방법보다 나은가 | (채울 것) |
## 되돌릴 수 없는 결정
- (채울 것: 되돌리기 비싼 결정만 여기 적고 `docs/adr/`에 결정 기록을 남긴다. 되돌릴 수 있는 결정은 빨리 한다)