fix: 종류 이름을 기록의 톤에 맞는 말로 바꾼다

앞선 커밋의 「직접 해보니 · 다음에 쓸 기준」 은 기술 기록의 톤에 비해
가벼웠다. 역할은 그대로 말하되 문어체로 세운다:

  CASE → 검증 기록        CONCEPT → 동작 원리
  REFERENCE → 적용 기준    DECISION → 설계 결정
  QUESTION → 열린 질문

계약의 kind 는 그대로 둔다. 바꾸는 것은 화면에 보이는 이름뿐이다 —
CASE 와 CONCEPT 는 데이터 모델에서 서로 다른 것을 뜻하고 독자가 얻는
것도 다르므로, 다섯을 셋으로 합치지 않는다. 상태 셋(확인됨·정리됨·미해결)은
색을 다섯 칠하지 않기 위한 시각 계층으로만 쓴다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
This commit is contained in:
DongHyeonka
2026-09-01 16:06:54 +09:00
co-authored by Claude Opus 5
parent a6413d0301
commit af5a6bbf23
7 changed files with 21 additions and 18 deletions
@@ -25,7 +25,7 @@ export function PublicRecordList({
<Link to={record.path}>
{/*
다섯 종류가 같은 회색 11px 로 나오면 목록이 스캔되지 않는다. 색을 다섯 개 칠하는
대신 지식의 상태 셋으로만 가른다 — 그중 「아직 모르는 것」만 강조한다. 이 기록에서
대신 지식의 상태 셋으로만 가른다 — 그중 「열린 질문」만 강조한다. 이 기록에서
가장 정직한 신호인데 지금까지 가장 안 보였다.
*/}
<span className="record-kind" data-state={DOCUMENT_KIND_STATES[record.kind]}>
@@ -9,17 +9,20 @@ type RecordKind = components["schemas"]["RecordKind"];
* 담아 둔 방식의 이름이지 읽는 사람의 말이 아니다 — 종류 이름이 스스로 설명하면 "어떤 맥락으로
* 읽을까요?" 같은 범례가 따로 필요 없다.
*
* <p>다만 계약의 kind 자체는 그대로 둔다. 여기서 바꾸는 것은 화면에 보이는 이름뿐이다 —
* `CASE` 와 `CONCEPT` 는 데이터 모델에서 서로 다른 것을 뜻하고, 독자가 얻는 것도 다르다.
*
* <p>표가 화면마다 복사되어 있던 시절에는 같은 `QUESTION` 이 화면마다 네 가지 이름으로 나왔다.
*
* <p>한 곳에 두면 다음에 종류가 늘어날 때도 한 번만 고친다. 종류를 더하면 이 표가 비어 있는 것을
* 타입이 잡는다 — `Record<RecordKind, string>` 이므로 빠진 종류가 있으면 컴파일되지 않는다.
*/
export const DOCUMENT_KIND_LABELS: Record<RecordKind, string> = {
CASE: "직접 해보니",
REFERENCE: "다음에 쓸 기준",
QUESTION: "아직 모르는 것",
CONCEPT: "어떻게 동작하나",
PROJECT_DECISION: "이렇게 하기로",
CASE: "검증 기록",
CONCEPT: "동작 원리",
REFERENCE: "적용 기준",
PROJECT_DECISION: "설계 결정",
QUESTION: "열린 질문",
};
/**