Commit Graph
3 Commits
Author SHA1 Message Date
DongHyeonkaandClaude Opus 5 0b0c5cb42d feat: 홈이 길을 보여 주고, 활동이 사람 말로 적힌다
홈의 첫 문장은 글 쓰는 태도를 말했다 — "문제를 재현하고 검증해 정리합니다". 맞는
말이지만 처음 온 사람이 알아야 하는 것은 태도가 아니라 길이다. 이 사이트에서 기록은
한 편으로 끝나지 않고 프로젝트 안의 주제에 속하고 주제 안에서 서로 이어진다. 그 구조를
설명하는 문장보다 실제 사슬 하나가 빠르므로, 최근 기록이 가장 많이 모인 주제를 골라
프로젝트 → 주제 → 기록으로 편다. 예시를 코드에 적어 두지 않는다 — 그 기록을 지우는
순간 홈이 죽은 링크를 가리킨다.

프로젝트 활동은 종류 자리에 `CONCEPT_PUBLISHED` 를 그대로 찍고 있었다. 그것은
데이터베이스 제약(`project_activity_activity_type_check`)이 허용하는 값이지 방문자에게
할 말이 아니다 — 감사 로그처럼 읽히고, 정작 무슨 일이 있었는지는 알 수 없었다.

포트의 타입은 `"PUBLICATION" | "PROJECT UPDATE" | "QUESTION"` 셋으로 적혀 있었는데
서버는 그중 무엇도 보내지 않는다. 매퍼가 단언으로 통과시켜서 타입 검사도 이것을 잡지
못했다. 실제 값 열하나로 맞추고, `Record<ProjectActivityType, string>` 표로 사람이 읽는
문장을 만든다. 픽스처도 같은 값을 쓰게 했다 — 픽스처가 자기만의 말을 쓰던 동안 화면은
픽스처에서만 멀쩡했다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015c8cBFUaVr7KLVUx6ujz7D
2026-09-15 20:15:05 +09:00
DongHyeonkaandClaude Opus 5 fe1f23520e feat: 기록마다 이 조사의 어디쯤인지를 제목 아래에 세운다
이 사이트의 차별점은 "기록 하나에 아무 데서나 들어와도 그 결론을 만든 맥락의 사슬을
잃지 않는다"는 것이다. 그런데 그 사슬이 화면에서는 제목 위 얇은 breadcrumb 한 줄과
문서 맨 아래 「다음에 읽을 것」으로만 표현돼 있었다 — 검색으로 Case 하나에 들어온
사람은 바닥까지 내려가야 이 기록이 어느 프로젝트의 어느 질문에서 나왔는지 알 수
있었다. 저장은 되어 있는데 겪게 되지는 않는 상태였다.

제목·요약 바로 아래에 맥락을 하나의 덩어리로 세운다. 프로젝트 → 주제로 올라가는
길과, 같은 조사 안에서 이웃한 기록들을 함께 보인다. 이웃에는 작성자가 그 관계에 남긴
문장을 붙인다 — 「다음에 무엇을」보다 「왜 그것을」이 먼저 있어야 목록이 아니라 사슬로
읽힌다. 지금 보는 기록도 목록에 남겨 자기 자리가 보이게 한다.

여섯 종류 전부에 들어간다. 종류마다 하나씩 픽스처를 둔 `Record<RecordKind, …>` 검사로
막았다 — 한 종류에서만 빠지면 그 종류로 들어온 방문자에게만 조용히 사슬이 끊긴다.
Question 에서 빼 보고 그 검사만 실패하는 것을 확인했다.

화면 촬영기(`scripts/capture-screens.ts`)도 함께 넣는다. 라우트 레지스트리를 돌며
공개·Studio 전 화면을 찍는다. 찍을 목록을 손으로 적지 않고 `Record<RouteId, …>` 로
두어 라우트가 늘면 컴파일러가 빈 자리를 잡는다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015c8cBFUaVr7KLVUx6ujz7D
2026-09-15 20:03:01 +09:00
DongHyeonkaandClaude Opus 5 344dadb17a fix: 구역 규칙이 제목까지 잡던 것을 행에만 건다
`.home-comparison a { display: grid; grid-template-columns: 200px … }` 는 비교 행을 위한
규칙인데 선택자가 구역 전체라 제목 안의 링크까지 잡았다. 제목이 200px 칸에 갇혀 두 줄로
접히고 행용 padding 까지 물려 h2 높이가 199px 이 됐다 — 디자인이 빠진 것처럼 보였지만
규칙이 샌 것이었다. 같은 이유로 주제 화면의 안내 문단도 행의 크기·색으로 덮여 있었다.

CSS 로 막는 것은 임시방편이라 구조도 바꾼다. 제목 안에 링크를 두지 않고, 주제로 가는 길은
아래 한 줄이 맡는다 — 최근 기록이 이미 쓰는 배치다. em-dash 로 두 가지 일을 한 줄에
욱여넣을 이유도 함께 없어진다.

제목의 말도 고친다. 「무엇을 견줬나」는 의문형 꼬리가 붙었고 「견주다」는 이 기록의 다른
문장에 쓰지 않는 낱말이다. 작성자가 Case 의 소제목에 쓰는 말은 「이 구조에서 감수한 것」
처럼 「~한 것」 명사형이라 그쪽에 맞춘다. 주제 화면도 같은 이름을 쓴다 — 같은 네 줄을 두
화면이 다른 이름으로 부르고 있었다.

같은 모양이 다른 구역 아홉 곳에도 있었다. 배치를 거는 규칙은 그 배치를 쓰는 요소까지
좁혀 적도록 51개를 고치고, 그 습관을 지키는 검사를 둔다.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_011nAjrqNHGPNngN4aUbcyvJ
2026-09-01 20:24:15 +09:00