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