From 93e3c7b1a606e398ad0ea1e4395bacf85f662cd2 Mon Sep 17 00:00:00 2001 From: DongHyeonka Date: Sun, 8 Nov 2026 22:57:03 +0900 Subject: [PATCH] =?UTF-8?q?docs(vision):=20=EC=86=8C=EC=9C=A0=EC=9E=90?= =?UTF-8?q?=EA=B0=80=20=EC=B1=84=EC=9A=B0=EB=8A=94=20=EB=B9=84=EC=A0=84?= =?UTF-8?q?=C2=B7=EB=AC=B8=EC=A0=9C=20=EC=A0=95=EC=9D=98=20=EB=B9=88=20?= =?UTF-8?q?=EC=96=91=EC=8B=9D=EC=9D=84=20=EB=91=94=EB=8B=A4?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 하네스 자료는 레이어 규칙·훅·스킬과 함께 비전(세 문장)과 문제 정의(고객의 말 그대로, 하지 않는 것, SMART 성공 기준)를 빈 양식으로 템플릿에 두라고 한다. 프론트에는 둘 다 없었다. claude-harness template/docs/의 두 파일을 옮긴다. 프로젝트 이름 자리표시자는 빼고, 결정 기록 위치는 이 repo의 docs/architecture/decisions/로 바꿨다. 루트 AGENTS.md가 한 줄로 가리킨다(다음 커밋). 위험·한계: 채울 것 자리는 소유자 몫이라 비워 둔다. 문서 검사 범위 (docs/README.md 1절) 밖이다. 검증: python3 -m unittest scripts/tests/test_claude_setup.py 통과. --- docs/problem-statement.md | 37 +++++++++++++++++++++++++++++++++++++ docs/vision.md | 10 ++++++++++ 2 files changed, 47 insertions(+) create mode 100644 docs/problem-statement.md create mode 100644 docs/vision.md diff --git a/docs/problem-statement.md b/docs/problem-statement.md new file mode 100644 index 00000000..be7ada58 --- /dev/null +++ b/docs/problem-statement.md @@ -0,0 +1,37 @@ +# 문제 정의 + +> 아이디어가 아니라 고객의 문제에서 출발한다. 좋은 스펙은 헷갈리지 않게 하는 스펙이다. +> 바뀌면 고친다(살아 있는 문서). 왜 바꿨는지는 커밋 본문이나 결정 기록(`docs/architecture/decisions/`)에 남긴다. +> 소유자가 채우는 빈 양식이다. 이 템플릿을 복사한 프로젝트는 자기 문제로 채운다. + +## 고객의 말 그대로 + +- (채울 것: 고객이 실제로 한 말을 따옴표로. 해석하지 않는다) + +## 지금은 어떻게 버티나 + +- (채울 것: 고객이 지금 쓰는 우회 방법과 그 비용) + +## 하지 않는 것 + +- (채울 것: 이번에 일부러 풀지 않는 문제, 만들지 않는 기능) + +## 성공 기준 + +구체적이고, 잴 수 있고, 이룰 수 있고, 목적에 맞고, 기한이 있게(SMART) 쓴다. + +| 기준 | 구체적으로 | 어떻게 재나 | 목표 값 | 기한 | +|---|---|---|---|---| +| (채울 것) | | | | | + +## 세 관점 점검 + +| 관점 | 묻는 것 | 답 | +|---|---|---| +| 비즈니스 | 돈이 되나, 누가 대가를 치르나 | (채울 것) | +| 기술 | 만들 수 있나, 가장 위험한 가정은 | (채울 것) | +| 고객 | 쓸모 있나, 지금 방법보다 나은가 | (채울 것) | + +## 되돌릴 수 없는 결정 + +- (채울 것: 되돌리기 비싼 결정만 여기 적고 결정 기록을 남긴다. 되돌릴 수 있는 결정은 빨리 한다) diff --git a/docs/vision.md b/docs/vision.md new file mode 100644 index 00000000..ce198591 --- /dev/null +++ b/docs/vision.md @@ -0,0 +1,10 @@ +# 비전 + +> 소유자가 직접 쓴다. AI에게 맡기지 않는다. 방향·목적·철학만, 길어야 세 문장이다. +> 에이전트는 이 문서를 읽기만 한다. 고칠 일이 보이면 제안만 한다. 이 템플릿을 복사한 프로젝트는 자기 비전으로 채운다. + +1. 누구의 어떤 문제를 푸는가: (채울 것) +2. 성공하면 무엇이 달라지나(잴 수 있게): (채울 것) +3. 속도보다 먼저 지킬 것: (채울 것) + +점검 질문: 이 목표를 다 이뤘는데도 실패한다면 무엇 때문일까? 그 답이 빠진 목표다.