하네스 자료는 레이어 규칙·훅·스킬과 함께 비전(세 문장)과 문제 정의(고객의 말 그대로, 하지 않는 것, SMART 성공 기준)를 빈 양식으로 템플릿에 두라고 한다. 프론트에는 둘 다 없었다. claude-harness template/docs/의 두 파일을 옮긴다. 프로젝트 이름 자리표시자는 빼고, 결정 기록 위치는 이 repo의 docs/architecture/decisions/로 바꿨다. 루트 AGENTS.md가 한 줄로 가리킨다(다음 커밋). 위험·한계: 채울 것 자리는 소유자 몫이라 비워 둔다. 문서 검사 범위 (docs/README.md 1절) 밖이다. 검증: python3 -m unittest scripts/tests/test_claude_setup.py 통과.
38 lines
1.4 KiB
Markdown
38 lines
1.4 KiB
Markdown
# 문제 정의
|
|
|
|
> 아이디어가 아니라 고객의 문제에서 출발한다. 좋은 스펙은 헷갈리지 않게 하는 스펙이다.
|
|
> 바뀌면 고친다(살아 있는 문서). 왜 바꿨는지는 커밋 본문이나 결정 기록(`docs/architecture/decisions/`)에 남긴다.
|
|
> 소유자가 채우는 빈 양식이다. 이 템플릿을 복사한 프로젝트는 자기 문제로 채운다.
|
|
|
|
## 고객의 말 그대로
|
|
|
|
- (채울 것: 고객이 실제로 한 말을 따옴표로. 해석하지 않는다)
|
|
|
|
## 지금은 어떻게 버티나
|
|
|
|
- (채울 것: 고객이 지금 쓰는 우회 방법과 그 비용)
|
|
|
|
## 하지 않는 것
|
|
|
|
- (채울 것: 이번에 일부러 풀지 않는 문제, 만들지 않는 기능)
|
|
|
|
## 성공 기준
|
|
|
|
구체적이고, 잴 수 있고, 이룰 수 있고, 목적에 맞고, 기한이 있게(SMART) 쓴다.
|
|
|
|
| 기준 | 구체적으로 | 어떻게 재나 | 목표 값 | 기한 |
|
|
|---|---|---|---|---|
|
|
| (채울 것) | | | | |
|
|
|
|
## 세 관점 점검
|
|
|
|
| 관점 | 묻는 것 | 답 |
|
|
|---|---|---|
|
|
| 비즈니스 | 돈이 되나, 누가 대가를 치르나 | (채울 것) |
|
|
| 기술 | 만들 수 있나, 가장 위험한 가정은 | (채울 것) |
|
|
| 고객 | 쓸모 있나, 지금 방법보다 나은가 | (채울 것) |
|
|
|
|
## 되돌릴 수 없는 결정
|
|
|
|
- (채울 것: 되돌리기 비싼 결정만 여기 적고 결정 기록을 남긴다. 되돌릴 수 있는 결정은 빨리 한다)
|