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>
65 lines
2.9 KiB
Markdown
65 lines
2.9 KiB
Markdown
---
|
|
kind: REFERENCE
|
|
slug: grades-may-understate-never-overstate
|
|
title: 등급은 네 단계로 나누고 관측보다 높게 적지 않는다
|
|
topic: self-disclosure-grading
|
|
project: clean-architecture-backend-template
|
|
status: 게시 전
|
|
sourceRevision: 21234e38cdb9a926cbc92bb97a2aee2e4a7d2916
|
|
rootTreeNode: reference:grades-may-understate-never-overstate
|
|
verifiedOn: # 이 기록은 이번 회차에 실행 확인을 하지 않았다
|
|
---
|
|
|
|
# 등급은 네 단계로 나누고 관측보다 높게 적지 않는다
|
|
|
|
능력 성숙도를 자기 신고할 때 낙관적으로 적어, 그 표를 읽고 배포를 결정하는 사람이 없는 것을 있다고 믿는 것을 막는다. 단계마다 요구하는 증거를 정의하고, 낮게 적는 것은 허용하되 높게 적는 것은 금지한다.
|
|
|
|
## 목적
|
|
|
|
능력 성숙도를 자기 신고할 때 낙관적으로 적어, 그 표를 읽고 배포를 결정하는 사람이 없는 것을 있다고 믿는 것을 막는다.
|
|
|
|
## 규칙
|
|
|
|
1. 단계마다 요구하는 증거를 정의한다
|
|
코드가 있다는 것과 실행 경로에 있다는 것과 외부 시스템과 검증되었다는 것과 실부하에서 검증되었다는 것을 나눈다.
|
|
|
|
2. 낮게 적는 것은 허용하고 높게 적는 것은 금지한다
|
|
방향을 명시하면 애매한 경우의 처리가 정해진다.
|
|
|
|
3. 증거 칸에 구체적인 수를 적는다
|
|
테스트 이름만으로는 그 테스트가 무엇을 보장하는지 알 수 없다.
|
|
|
|
4. 부재를 함께 적고 테스트로 고정한다
|
|
요청 경로에 없다는 사실을 테스트가 붙들면, 나중에 배선될 때 그 테스트가 깨지고 등급표를 함께 갱신하게 된다.
|
|
|
|
5. 어느 단계에도 못 미치면 미달성으로 적는다
|
|
가장 낮은 등급을 주지 않는다.
|
|
|
|
## 적용 조건
|
|
|
|
능력 성숙도를 문서로 공시하는 모든 모듈
|
|
|
|
플랫폼 가족과 지원 매트릭스
|
|
|
|
## 예외
|
|
|
|
외부 계약으로 등급 어휘가 정해져 있으면 그것을 따른다. 그 경우에도 높게 적지 않는다는 규칙은 유지한다.
|
|
|
|
## 예시
|
|
|
|
GraphQL 리프의 등급표가 열세 행 중 여섯을 modelled 로, 하나를 미달성으로 적는다. 분석이 관측과 대조했을 때 어긋난 것은 한 행이었다.
|
|
|
|
관측 태그 카디널리티 행의 증거가 임의 이름 10,000개가 시계열 1개가 된다는 측정을 적는다.
|
|
|
|
커서 서명 행이 자동설정이 아무것도 생성하지 않는다는 사실과 그것을 고정하는 테스트를 함께 적는다.
|
|
|
|
## 관계
|
|
|
|
- **네 단계 공시 등급 — modelled에서 production-verified까지**
|
|
이 규칙이 나온 개념이다.
|
|
- **등급표 13행 중 일곱을 스스로 강등하고 한 행만 관측과 어긋났다**
|
|
이 규칙이 지켜졌을 때의 결과다.
|
|
- **능력 등급은 코드가 아니라 실행된 증거에서 파생한다**
|
|
같은 원칙을 채택한 결정이다.
|
|
|