Files
clean-architecture-frontend…/docs/problem-statement.md
T
DongHyeonka 93e3c7b1a6 docs(vision): 소유자가 채우는 비전·문제 정의 빈 양식을 둔다
하네스 자료는 레이어 규칙·훅·스킬과 함께 비전(세 문장)과 문제 정의(고객의
말 그대로, 하지 않는 것, SMART 성공 기준)를 빈 양식으로 템플릿에 두라고
한다. 프론트에는 둘 다 없었다.

claude-harness template/docs/의 두 파일을 옮긴다. 프로젝트 이름 자리표시자는
빼고, 결정 기록 위치는 이 repo의 docs/architecture/decisions/로 바꿨다.
루트 AGENTS.md가 한 줄로 가리킨다(다음 커밋).

위험·한계: 채울 것 자리는 소유자 몫이라 비워 둔다. 문서 검사 범위
(docs/README.md 1절) 밖이다.

검증: python3 -m unittest scripts/tests/test_claude_setup.py 통과.
2026-11-08 22:57:03 +09:00

38 lines
1.4 KiB
Markdown

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