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

1.2 KiB

문제 정의 — clean-architecture-backend-template

아이디어가 아니라 고객의 문제에서 출발한다. 좋은 스펙은 헷갈리지 않게 하는 스펙이다. 바뀌면 고친다(살아 있는 문서). 왜 바꿨는지는 커밋 본문이나 결정 기록에 남긴다.

고객의 말 그대로

  • (채울 것: 고객이 실제로 한 말을 따옴표로. 해석하지 않는다)

지금은 어떻게 버티나

  • (채울 것: 고객이 지금 쓰는 우회 방법과 그 비용)

하지 않는 것

  • (채울 것: 이번에 일부러 풀지 않는 문제, 만들지 않는 기능)

성공 기준

기준 구체적으로 어떻게 재나 목표 값 기한
(채울 것)

세 관점 점검

관점 묻는 것 답
비즈니스 돈이 되나, 누가 대가를 치르나 (채울 것)
기술 만들 수 있나, 가장 위험한 가정은 (채울 것)
고객 쓸모 있나, 지금 방법보다 나은가 (채울 것)

되돌릴 수 없는 결정

  • (채울 것: 되돌리기 비싼 결정만 여기 적고 docs/adr/에 결정 기록을 남긴다. 되돌릴 수 있는 결정은 빨리 한다)