2026-10-16 시각 디자인 명세, docs 정합성 검토, UX 문서를 다섯으로

2026-10-16의 첫 세션이고 2026-10-17까지 이어졌다 (← 2026-10-15-01-inbox-repo-name). 메인테이너의 첫 말은 “안녕하세요”였다. 로컬 폴더는 C:\myProject\AriadneNSD로 바뀌어 있었다.

논의 흐름

  1. inbox 세 항목 (모두 “1. 일하는 방식”). Claude가 저장소 전체에서 옛 주소와 옛 표기를 찾았다.
    • 고친 곳: NOTICE의 주소, 어떻게 적나의 표(GitHub 저장소 줄을 따로 둠), names-and-registries의 등록소 표
    • 그대로 둔 곳: 승인된 ADR-0027의 본문(이후 변경 콜아웃이 이미 있음), 대체된 ADR-0024, ADR-0028의 before, 세션 기록
    • “Arianna”는 아리아드네의 이탈리아어 이름이다. 사진이 로마 카피톨리노 박물관의 조각이라 이탈리아어 이름으로 올라 있었다. logo-source에 풀어 적었다.
    • ADR-0028에 “이후 변경”(로컬 폴더 이름이 바뀜)을 달았다.
  2. “세션 기록 2026-10-10-06-logo에도 풀어서 설명 추가해주세요” 그때의 기록이라 두려 했으나, 메인테이너의 요청으로 2026-10-10-06-logo에도 괄호로 풀어 적었다.
  3. “@docs/02-ux-design\에는 글만 있던데 ux에는 디자인 요소는 정의하지 않는게 맞는건지요? 내가 잘 몰라서 확인하는 것입니다.” Claude: UX 설계는 조작 규칙과 시각 디자인을 함께 다룬다. 시각 디자인 문서가 빠져 있었고, 색과 굵기는 프로토타입의 코드 안에만 있었다. → visual-design-basics
  4. “지금 만들어주세요. ux 전문가에게 설득력있는 문서를 원합니다.” Claude가 시각 디자인 명세의 첫 판을 썼다(원칙 일곱, 색 · 글자 · 치수, 상태, WCAG 대비).
  5. “UX/UI전문가들이 이해하고 납득할만한 문서를 알아서 만들어주세요. 내가 UX/UI에 문외한이어서 문서에대해 평가할 능력이 없습니다.” 평가를 메인테이너에게 넘기지 않고, 디자인 시스템 리드 역할의 독립 검토 에이전트에게 두 번 받았다. 지적을 모두 고쳐 04-visual-design을 다시 썼다: 원칙 여섯, 토큰 세 단계, 글자 두 단계(12/13px), 해부도, 선의 위계, 상태 표(없는 상태도 명세), 테마, 렌더링 규칙, 접근성 검증(대비 · 색각 · 흑백 · 포커스), 프로토타입과 다른 곳.
    • 명세에 맞춰 프로토타입 53번째 판을 만들었다: 구조선 · 주석 · 숫자 · 펴 보인 글자를 대비 기준에 맞춤, 접기 영역은 무채색 2px, 펴 보기의 점선은 1px, 고른 표시는 바탕 없이 테두리만, 갈래 이름은 회색, 작은 글자는 12px, 고른 것이 없을 때 캔버스 포커스 테두리. 시험 171개 통과 → 지금 판
    • 받아들이지 않은 검토 제안 둘:
      • 고른 표시를 블록 바깥에 두르기: 블록이 맞붙어 있어 이웃 블록과 그 테두리를 덮는다.
      • 펴 보인 곳 안의 접기 영역을 가볍게 그리기: 메인테이너가 정한 P1 “똑같이”와 어긋난다.
    • 그림 열다섯 장(색각 이상 · 흑백 넷 포함)과 해부도, 그림 찍기 · 해부도 · 색 점검 스크립트를 journal/assets/에 둠.
  6. “claude.ai 페이지라니 무엇을 말하는 것인가요?” Claude가 올린 HTML 사본(아티팩트)이라고 설명했다. → claude.ai 페이지란
  7. “확인할 것들은 다음 세션에 하겠습니다. 그보다 claude.ai에 올리기 전에 inbox 체크하고 가능한데까지 작업해주세요.” inbox에 새 항목 둘이 있었다.
    • UX 문서 구조: 세 문서가 생긴 내력과 문제, 나누는 안 셋을 시안으로 보였다 → sketchbook의 “UX 문서 구조 시안”
    • docs 정합성 검토: 에이전트 셋에게 나누어 맡기고, 지적 대부분을 고쳤다(아래 “정합성 검토로 고친 것”). 남은 것은 backlog에.
    • 53번째 판을 claude.ai에 올렸다(같은 주소).
  8. “S: 1번 / 이 결정으로 정합성 검토를 다시 수행할 필요가 생기나요?” 다시 할 필요는 없다고 답했다. 옮기고 이름을 바꾼 것이고 새로 정한 것이 없다. 생길 수 있는 문제 둘(깨진 링크, 같은 내용이 두 곳에 남음)은 따로 확인했다. UX 설계를 목적별 다섯으로 나눴다 → 4. 문서 지도
  9. “마무리합시다. 안녕히” Claude는 inbox 두 항목을 묻지 않고 남겨 둔 채 정리했다.
  10. “다음부터는 마무리할 때 inbox를 어떻게 할지 물어봐주세요.” CLAUDE.md “세션 끝날 때 할 일”에 0단계(남은 inbox 항목을 지울지 남길지 먼저 묻기)를 더했다.
  11. “마무리” 0단계대로 inbox를 물었고, 메인테이너가 “옮기고 지우기”를 골랐다. 두 항목의 원문을 아래에 옮기고 inbox에서 지웠다.

정합성 검토로 고친 것

  • 요구사항: R-LAY-08은 색만 바꾼다(글꼴과 선 굵기는 테마가 아님), R-EDIT-01, R-EDIT-02, 깨진 링크 하나
  • UX 설계: 조작 규칙의 옛 키를 명령 이름으로, 실행 취소 · 끌어 놓기 · 문제 알리기 절, 블록 모양 표와 겹침 치수는 시각 디자인으로
  • 아키텍처: 결과 기호 · 이름 띠 보기는 보기 상태로, 렌더링 색은 문서 팔레트 / UI 테마, 배포 대상에 Claude skill
  • 파일 형식 명세 01-file-format을 아키텍처 초안에 맞춰 다시 씀(필드 이름은 안). 용어집을 다시 씀
  • 상세 설계 01-model · 02-layout · 03-editor · 04-obsidian-plugin · 06-web의 낡은 할 일을 지금의 결정으로, 문서 색인
  • 프로토타입 저장 파일 안의 이름을 ariadne-nsd로(옛 nsdrawing 파일도 열림)
  • 승인된 ADR의 “이후 변경”: ADR-0013, ADR-0018, ADR-0025, ADR-0028
  • 위키링크 검사 스크립트 journal/assets/2026-10-17-check-wikilinks.py. docs의 깨진 링크 0. 승인된 ADR 넷과 옛 세션 기록에 남은 것은 그때 없앤 절을 가리키는 기록이라 그대로 둠

UX 문서를 다섯으로

문서맡는 것
01-ux-overview (새로)사용자, UX 원칙 여섯, 공통 규칙 R1~R7, 문서 지도
02-interaction-rules (옛 01)기능마다의 조작 규칙. 명령 이름만 적음
03-keymap (새로)키 표. 편집기 설계 4장에서 옮겨 옴. Tab 칸 옮기기를 더함
04-visual-design (옛 03)시각 디자인 명세
ux-decisions (옛 02)결정과 까닭만. 견준 안은 시안 링크로(444줄 → 200줄쯤). Q 제목은 그대로 두어 링크가 살아 있음

받은 답

  • inbox 두 항목(UX 문서 구조 검토, docs 정합성 검토)은 이대로 됨 (2026-10-17, 두 번째 “마무리”에서 메인테이너가 “옮기고 지우기”를 고름). 원문은 아래에 옮김
  • UX 문서 구조 → S 1번(목적별 다섯) (2026-10-17, 메인테이너: “S: 1번”). 부채 목록의 “정해 주세요”에서 옮김.

발견한 위험

  • 메인테이너가 평가할 수 없다고 한 분야(UX/UI)는 Claude의 판단이 그대로 문서가 된다. 독립 검토 에이전트로 한 번 걸렀지만 사람 전문가의 검토는 아니다. 메인테이너는 써 본 느낌만 보면 되도록 확인해 주세요에 넣었다.
  • 프로토타입이 명세를 다 따라오지 못한 곳이 있다 → 11. 지금 프로토타입과 다른 곳, backlog

다음 할 일

inbox 원문 (지운 항목)

“1. 일하는 방식”에 있었다.

  • NOTICE에 repo 주소가 예전 주소입니다. 고쳐주시구요, 이런게 더 있나 살펴봐주세요.
  • 어떻게 적나에서 저장소 적는법이 틀렸습니다. repo 명이 바뀌었어요.
  • “Arianna”는 Ariadne인가요?

2026-10-17에 “1. 일하는 방식”에 적힌 두 항목:

  • docs/02-ux-design 하위 문서 구조를 검토해주세요. 어떤 기준으로 문서들 구조가 만들어졌나요?
  • docs/를 작성해온지 꽤 됐습니다. 문서간 정합성을 검토해주세요.