DongHyeonkaandClaude Opus 5
ab59130196
이번 파이프라인 작업과 무관하게 작업 트리에 남아 있던 것을 그대로 올린다. 사용자가 「전부 커밋」으로 정했고, 이번 작업과 섞이지 않게 커밋만 나눴다. 대부분은 clean-architecture-backend-template 의 그림 정본 재배치다 — final/assets/diagrams/<이름>/ 에 있던 것이 CLAUDE.md 가 적은 배치인 final/assets/<이름>/ 로 옮겨졌고 .techviz/<이름>/ 이 함께 들어왔다. 삽입 줄의 대부분(3.15M)이 그 .techviz context.json 이다. 그 밖에 ca-tmpl·document-haness 의 정리, .claude/agents/ 열한 개, writing-practitioner-guides 스킬, .playwright-mcp 세션 산출물, scripts/check-ssot-facts.py 와 그 시험이 들어 있다. 이 커밋의 내용은 내가 만든 것이 아니라 이전 세션이 남긴 것이고 검증하지 않았다. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2.8 KiB
kind, slug, title, topic, project, status, sourceRevision, rootTreeNode, verifiedOn
| kind | slug | title | topic | project | status | sourceRevision | rootTreeNode | verifiedOn |
|---|---|---|---|---|---|---|---|---|
| REFERENCE | fix-overstatement-before-understatement | 과대 진술 문서를 과소보다 먼저 고친다 | drift-direction | clean-architecture-backend-template | 게시 전 | 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916 | reference:fix-overstatement-before-understatement |
과대 진술 문서를 과소보다 먼저 고친다
문서 드리프트를 발견 순서대로 고치다가, 읽는 사람에게 위험한 방향의 드리프트를 뒤로 미루는 것을 막는다. 문서를 믿고 자기 방어를 생략한 사람이 손해를 보므로 과대 진술이 먼저고, 과소 진술은 불편을 주지만 안전한 쪽으로 틀린다.
목적
문서 드리프트를 발견 순서대로 고치다가, 읽는 사람에게 위험한 방향의 드리프트를 뒤로 미루는 것을 막는다.
규칙
-
방향을 먼저 판정한다 문서가 실제보다 많이 약속하는가 적게 약속하는가.
-
과대 진술이 먼저다 문서를 믿고 자기 방어를 생략한 사람이 손해를 본다. 과소 진술은 불편을 주지만 안전한 쪽으로 틀린다.
-
강제되는 값의 과대 진술이 가장 위험하다 선언만 되고 아무것도 강제하지 않는 값의 오기와, 실제 분기를 만드는 값의 오기는 무게가 다르다.
-
수치보다 능력 서술이 먼저다 숫자의 드리프트는 신뢰도를 깎지만 동작을 바꾸지 않는다. 능력 서술의 드리프트는 설계 판단을 바꾼다.
-
같은 주장이 여러 문서에 있으면 함께 고친다 하나만 고치면 나머지가 남고, 다음 사람은 어느 쪽이 최신인지 모른다.
적용 조건
지원 매트릭스와 능력 표와 활성화 절차 문서
여러 드리프트를 한 번에 발견해 순서를 정해야 할 때
예외
과소 진술이 실제로 있는 기능을 아무도 쓰지 못하게 만들고 있다면 그것이 더 급할 수 있다. 그 판단에는 그 기능이 필요하다는 근거가 함께 있어야 한다.
예시
능력 표 60칸 중 하나의 오기가 하필 실제 거부를 일으키는 유일한 플래그였다. 그것을 믿은 소비자는 자기 멱등성 처리를 생략한다.
리프 수를 19 라고 적은 문서들은 실제 62 와 다르지만 동작을 바꾸지 않는다.
관계
- 지원 매트릭스가 코드와 반대를 적었고, 그 오해가 소비자에게 자기 멱등성을 생략하게 한다 세 번째 규칙의 사례다.
- 여러 문서가 19개 리프라고 적고 레지스트리는 62다 네 번째 규칙의 사례다.
- 문서의 수치는 세지 말고 파생하거나 게이트로 붙든다 같은 계열의 예방 규칙이다.