Skip to content

v1.27.0

Latest

Choose a tag to compare

@chanmuzi chanmuzi released this 10 Nov 16:25
· 75 commits to main since this release

Changed

  • 기록 문서 점검 가이드 docs/doc-review.md 추가: 크기, 깨진 경로, 목록에 없는 결정 문서, 긴 표 행을 재는 명령 4개와 읽고 판단할 질문. 목록 표의 행과 CHANGELOG 항목은 300자 안에서 쓴다는 규칙을 docs/decisions/README.md, docs/shared-logic.md, docs/skill-rules.md에 넣었다.
  • CHANGELOG 분리: v1.8.0까지의 날짜별 항목 38건(26.6KB)을 docs/changelog/2026-02-to-04.md로 옮겼다. 이 파일에는 버전별 항목만 남는다.
  • 결정 문서 정리: docs/decisions/README.md에 문서 목록과 작성 규칙을 두었다. eli5 결정 문서(73KB)는 현재 상태와 개정 목록을 담은 2026-08-eli5.md와 원본과 개정 본문 19건을 담은 2026-08-eli5-history.md로 나눴다. 내용과 이름이 어긋나던 두 문서를 개명했다(2026-07-visual-doc.md는 2026-07-html-shared-design-rules.md, 2026-07-explain-diff-design-system.md는 2026-07-explain-diff-micro-world-design.md). SKILL.md, 템플릿, 이 파일의 옛 항목에 있던 경로도 새 이름으로 바꿨다.
  • 프로젝트 문서 구조: AGENTS.md(59KB)를 어느 작업에나 적용되는 규칙과 작업별 문서 표만 남긴 6.5KB로 줄이고, 로컬 테스트, 스킬 공통 규칙과 체크리스트, 스킬 간 공유 로직, 터미널 렌더링, 릴리스, 동기화 절차, Skills CLI 운영을 docs/ 아래 문서 7개로 옮겼다. Codex가 프로젝트 지침을 32KiB까지만 읽어 뒤쪽 구역이 전달되지 않던 문제 때문이다. 공유 로직 표는 찾을 표식과 정본 칸으로 줄이고 원래 글은 같은 파일의 상세 절에 뒀다. 정본: docs/decisions/2026-11-doc-routing.md
  • /eli5 그림의 선 한 벌: 흐름 그림, 칸 띠, 막대 그림이 같은 종류로 보이도록 상자와 칸 테두리(.dg-box, .dg-cell, 회색 1px, 흰 채움), 연결선과 화살촉(.dg-arrow, .dg-head, 한 단계 진한 회색 1.1px), 강조(em, bad, 1.2px)를 클래스로 정했다. 도형에 stroke="currentColor"와 굵기를 직접 쓰지 않고, 옛 방식으로 그린 도형은 프레임이 같은 톤으로 맞춘다. 없는 것은 한 단계 진한 점선(absent), 흐린 도형의 불투명도는 .6 이상. 막대와 띠의 행 이름은 상자 라벨과 같은 13px(dg-l dg-row). 번호 배지는 중간 회색에 보통 굵기 숫자.
  • /eli5 마무리 줄의 배지 두 종류: 형광 배지(.lab)는 맨 끝 정리 머리 문장이 다시 말하는 줄에만 쓰고, 그 밖의 마무리 줄은 테두리 배지(.lab.q)로 해설 목록과 구분한다. 테두리 배지의 문구는 고정 목록(실측, 지금은, 선택)을 없애고 판정 기준으로 바꿨다: 그 줄이 그림에 대해 무엇인지 주제의 말로 1~3단어, 다른 beat에 붙여도 말이 되면 너무 일반적, 같은 문구는 페이지에 2번까지. 확인 못 한 것은 세 번째 종류로 그대로다.
  • /eli5 그림 안에는 그린 것과 그 이름만: 그림 맨 아래의 조건, 출처, 그리지 않은 수치 줄과 행 칩이나 표 캡션 옆 꼬리표를 없앴다. 지우면 그림을 잘못 읽게 되는 조건만 패널 아래 접힌 주석(.res-more)으로 내리고, 그 밖의 측정 수치는 페이지에서 빼 Step 6 보고서에 적는다. 다른 곳에 없는 현재 상태나 결정은 마무리 줄로 옮긴다. 표 캡션은 표 이름과 단위만.
  • /eli5 해설의 머리는 그림에서 찾을 수 있는 표시: 번호 배지, 행 칩, 색 조각(.sw), 또는 그림이 적고 있는 이름 그대로. 그림이 이름을 적고 있으면 표시를 더 붙이지 않고, 여백에 걸어야 하는 배지나 괄호선은 쓰지 않는다.
  • /eli5 구성안의 선행 확인: beat마다 "읽기 전에 알아야 하는 것"을 적고 앞 beat의 그림에 나오는지 확인한다. 페이지에서 만든 이름은 처음 나오는 자리에서 정의하고, 결과의 모양을 정하는 고정 조건은 결과보다 먼저 그리며, 앞 beat가 뒤 beat의 것을 가리키지 않는다.
  • /eli5 서브 항목 사이 구분선: 묶음 안의 beat 사이에 왼쪽 120px의 옅은 회색 선. 대분류의 전체 폭 선은 그대로다.
  • /eli5 길이와 개수는 기본값이지 할당량이 아니다: 해설 약 80자, 마무리 줄 약 60자, 접힌 블록 약 3문장, 표 1~2개를 "넘으면 자른다"에서 "보통 이 정도이고, 주제가 요구하면 더 길어진다"로 바꿨다. 안 들어가는 것은 그림, 해설, 접힌 블록 순서로 옮기고, 숫자를 맞추려고 늘리거나 독자에게 필요한 사실을 자르지 않는다. 기본값을 크게 넘으면 Step 6 보고서에 이유를 적는다. 길이 검사는 자를 목록이 아니라 읽을 목록이다. 단위가 다른 세트는 결과 표를 하나 더 둘 수 있다.
  • /eli5 묶음은 beat 수가 아니라 묶음의 이름이 있는지가 정한다. 잰 값이 없는 주제의 대가 beat는 셀 수 있는 것을 그리거나 마무리 줄로 말하고, 값을 지어내 막대를 그리지 않는다.

Fixed

  • /eli5 서로 다르던 길이 기준(본문 80자와 60자, 검사 스크립트 110자와 100자, 그 설명 80자와 70자)을 하나로 맞췄다. 제목 길이 검사(28자 고정)는 식별자가 든 제목을 남기는 읽을 목록으로, 부제 반복 검사는 한 그림 안의 반복만 보도록 고쳤다. 그림의 숫자를 제목에 쓸 수 있는지에 대한 두 문장의 충돌, 옛 절 이름과 차례 마크업을 가리키던 문장을 고쳤다.
  • HTML 스킬 네 개(eli5, visual-doc, explain-diff, micro-world)의 Render check: 말투 검사 스크립트가 코드 칩 안의 마침표(skills/.)에서 문장을 자르던 오탐을 고쳤고, 스크린샷은 내용 높이까지 자른 뒤 조각내도록 적었다(창 높이 전체를 자르면 빈 조각이 대부분이다).
  • /eli5 선행 확인 규칙이 "페이지에서 만든 이름(판 번호, 조건 이름, 약어)"만 대상으로 적혀 있어 그 밖의 것을 앞에서 가리키는 줄이 검사를 통과하던 것: 대상 종류를 나열하지 않고 "어느 줄이든 그 줄보다 위의 보이는 자리에 나온 것만 가리킨다"로 고쳤다. Render check 9(d)도 이름 목록 만들기에서 줄마다 가리키는 것이 위에 있는지 읽는 검사로 바꿨다. 산출물(agentic 파일 검색 입력 경로)의 3-1 마무리 줄이 4-1 접힌 블록에서야 나오는 세 모델과 사전 테스트를 가리킨 사고 반영
  • /eli5 다크 모드에서 터미널 배지가 배경과 구분되지 않던 것: 배지에 가는 테두리를 둘렀다.
  • 프로젝트 문서의 낡은 내용: AGENTS.md의 Codex 동기화와 복원 스크립트가 ~/.claude를 고정해 쓰던 것을 ${CLAUDE_CONFIG_DIR:-$HOME/.claude}로 바꾸고, 다른 PC의 저장소 경로와 테스트 안내 흐름의 cache 탐색 순서(installPath 우선)를 고쳤다. .gitignore에 .omc/를 넣고, 결정 문서 4개 제목의 em-dash를 걷어냈다.