Files
DongHyeonka 5757742ed0 docs(work): 하네스 문서를 새 문서 위치와 검사 범위에 맞춘다
문제: 하네스 PR #13이 더한 작업 매뉴얼·규칙은 이 브랜치가 바꾼 문서
체계의 옛 모습을 적는다.
- 옛 경로: `docs/architecture/decisions/`, `docs/superpowers/`, 루트
  `SPEC.md`, 목표 설계였던 `docs/testing/frontend-platform-testing-strategy.md`
- 옛 검사 범위: 「docs/README.md 1절이 링크한 문서, 폴더 링크는 바로 아래
  .md만」. 지금 verify:documentation은 살아 있는 문서 전부를 보고 언어·
  문체·숫자·머리 블록도 본다
- 옛 docs/README.md 절(1절 묶음 / 2절 목표 설계 / 3절 작업 이력)과 README
  절 이름(「Support scope」, 「Updating a copied project」)
- #13의 template-contract-documents 시험은 README 지워도 되는 표를
  `docs/superpowers/` 행으로 찾는데, 그 행은 이제 없다

고른 방법: 그 줄만 새 위치·새 절 이름·새 범위로 고친다(.claude/rules/docs.md,
docs/work의 docs-writing·operate·research-design·reference 다섯,
docs/problem-statement.md). 시험은 `docs/history/` 행으로 표를 찾는다.
docs/work/evidence.md는 백엔드처럼 매뉴얼 규칙의 근거 기록이라 고치지 않고
`HISTORY_HOLDERS`에 넣어 참조·숫자 검사에서 뺀다.

위험: 하네스 문서의 다른 문장은 건드리지 않았다. 하네스 세션이 쓴 뜻을
바꾸지 않으려는 것이다.

검증: 문서 검사 여섯이 0건, `git grep -n -E 'docs/superpowers|architecture/decisions'`가
기록·CHANGELOG·출처 표시 밖에서 0건.
2026-11-11 20:55:32 +09:00

1.4 KiB

문제 정의

아이디어가 아니라 고객의 문제에서 출발한다. 좋은 스펙은 헷갈리지 않게 하는 스펙이다. 바뀌면 고친다(살아 있는 문서). 왜 바꿨는지는 커밋 본문이나 결정 기록(docs/adr/)에 남긴다. 소유자가 채우는 빈 양식이다. 이 템플릿을 복사한 프로젝트는 자기 문제로 채운다.

고객의 말 그대로

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

지금은 어떻게 버티나

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

하지 않는 것

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

성공 기준

구체적이고, 잴 수 있고, 이룰 수 있고, 목적에 맞고, 기한이 있게(SMART) 쓴다.

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

세 관점 점검

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

되돌릴 수 없는 결정

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