ahnyongjooandClaude Sonnet 5.5
964a841de1
- Code\rebar_pipeline, review_pipeline, pier-program을 정션에서 실제 폴더로 전환 - Code\rhino_mcp 및 CLAUDE_rhino배경.md 추가, .mcp.json은 PYTHONPATH로 새 위치 사용 - pier-program 내부 .git 제거(이력은 backup\pier-program_20261028.bundle에 보관) - worktree 가이드 반영(CLAUDE.local.md, HANDOFF.md) - D:\Rhino-MCP 경로 참조를 새 위치로 치환 Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
14 KiB
14 KiB
Prism — 개정 대기 항목 원장 (Revision Backlog)
| 버전 | 수정일 | 수정자 | 주요 변경 내용 | 비고 |
|---|---|---|---|---|
| v0.1.0 | 2026-07-30 | 조선두 | 신규 제정 — M5 A3 설명자료 실제 산출 중 발견된 규정 공백 7항 등재 | 발견 경위: 「시공상세도 공통 부분」 Item 01 슬라이드 SVG 제작 (GV-15) |
| 메타 | 값 |
|---|---|
| 문서 | 개정 대기 항목 원장 |
| 역할 | 산출물 제작 중 발견된 규정 공백·오류·개선 제안을 누적 기록한다. 실제 개정은 본 원장을 근거로 일괄 수행한다 |
| 로드 정책 | 온디맨드 (개정 착수 시) |
| 규약 | GV-1 파일명 무버전 · GV-13 변경 이력 누적 · GV-14 무엇을 왜 · GV-15 발견 경위 · GV-16 근거 병기 |
1. 원장 운용 규칙
| ID | 규칙 |
|---|---|
| RB-1 | 산출물 제작 중 지침에 규정이 없어 제작자가 임의 판단한 지점은 전부 본 원장에 등재한다. 임의 판단을 지침 준수로 간주하지 않는다 (PR-2) |
| RB-2 | 항목은 삭제하지 않는다. 개정 반영 시 상태를 반영으로 바꾸고 반영 버전을 기재한다 |
| RB-3 | 개정 착수 시 본 원장의 대기 항목을 우선순위 순으로 처리하고, 처리 결과를 대상 파일의 변경 이력에 GV-14·GV-15에 따라 기재한다 |
| RB-4 | 한 항목이 여러 파일에 걸치면 가장 상위 계층 파일을 주 대상으로 하고 하위는 종속 갱신으로 표기한다 (AR-1) |
우선순위 기준
| 등급 | 의미 |
|---|---|
| P1 | 규정을 그대로 따르면 산출이 불가능하거나 검증을 통과할 수 없음 (규정 자체의 결함) |
| P2 | 규정이 없어 제작자마다 결과가 달라짐 (결정론성 훼손) |
| P3 | 결과에 큰 차이는 없으나 명문화하면 품질·속도가 개선됨 |
2. 대기 항목 총괄
| ID | 대상 | 항목 | 우선순위 | 상태 |
|---|---|---|---|---|
| R1 | M5 §6 · components | card emphasis 변형의 시각 표현이 미정의 |
P2 | 대기 |
| R2 | M5 §4.2 · Design.md §4.2 | orange–green 인접 금지가 명문화되지 않음 (비텍스트 ΔG 22 < 40) | P1 | 대기 |
| R3 | M5 §6 · §7 | principle 블록 높이·내부 구조 미규정 |
P2 | 대기 |
| R4 | M5 §6 | stagecard 내부 수직 리듬(헤더·뱃지·본문·속성행) 미규정 |
P2 | 대기 |
| R5 | M5 §2.3 · §6 | 4:4:4 등 등간격 분할 시 connector 배치 공간(거터 6mm)이 확보되지 않음 |
P2 | 대기 |
| R6 | M5 §5 PT-A1 | 패턴 혼용(상하 밴드 분할) 시 밴드 간격·절 제목 밴드 규정 부재 | P3 | 대기 |
| R7 | M5 §10 A7 · Design.md §4.1 CM-1 | SVG·인쇄 산출물에 A7(리터럴 0건)을 그대로 적용할 수 없음 | P1 | 대기 |
3. 항목별 상세
R1. card emphasis 변형의 시각 표현 미정의 — P2
| 구분 | 내용 |
|---|---|
| 대상 | A3/module.a3-explainer.md §6 (주) · design.components.md (종속) |
| 현행 규정 | §6 컴포넌트 표: card — 변형 4종 base·emphasis·prominent·quiet. 변형별 시각 표현 규정 없음 |
| 발견 경위 | Item 01 슬라이드에서 3개 카드 중 ②(시공상세도)를 강조해야 했으나, emphasis를 어떻게 그리는지에 대한 규정이 없어 제작자가 임의로 (a) 카드 상단 오렌지 룰 0.6mm → 검토 결과 상단 브리지 라벨의 밑줄로 오독됨 → (b) 헤더 밴드 아래 좌측 세로 악센트바 1.5mm로 변경하여 확정 |
| 문제 | 동일 지침으로 다른 제작자가 만들면 emphasis 표현이 달라진다. 결정론적 파생(Design.md §1.1)이 성립하지 않음 |
| 개정 제안 | §6 card 행에 변형별 표현 규정을 추가한다.· base — white 면 + hairline(0.20mm) brown 보더· emphasis — base + 보더 regular(0.40mm) + 좌측 세로 악센트바 space.025(1.5mm), 바는 헤더 밴드 하단부터 시작하고 하단 라운드 시작점 전에서 끝낸다· prominent — green 면 + white 전경 (역상)· quiet — sand 면 + hairline 보더, 본문 위계 1단 하향악센트바는 §5 PT-A3 악센트 카운트에 1로 계상한다 |
| 근거 | Design.md §1.1 결정론적 파생 · PF-5 토큰만 사용 · PT-A3 악센트 경제 |
R2. orange–green 인접 금지 미명문화 — P1
| 구분 | 내용 |
|---|---|
| 대상 | A3/module.a3-explainer.md §4.2 (주) · Design.md §4.3 · design.foundations.md (종속) |
| 현행 규정 | §4.2 사용 페어 표의 금지 항목은 green / obsidian(2.13, 텍스트 금지) 1건뿐. orange와 green의 조합에 대한 규정 없음 |
| 발견 경위 | R1의 (a)안 검토 중, 카드 ②의 emphasis 악센트바를 green 헤더 밴드 위에 겹쳐 배치하는 안을 검토함. orange G47 / green G69 → ΔG 22로 CM-20(비텍스트 요소 대비 ΔG ≥ 40)에 미달함을 계산으로 확인. 규정에 명시가 없어 제작자가 직접 계산해야 했음 |
| 문제 | CM-20은 Design.md에 있으나 M5 §4.2의 페어 표에는 반영되어 있지 않다. 자기완결형(§자기완결 원칙)을 표방하는 모듈 파일만 보고 작업하면 이 조합을 걸러낼 수 없다 |
| 개정 제안 | ① §4.2 표에 금지 행 추가 — orange / green ΔG 22 · ✗ 인접·중첩 금지(텍스트·비텍스트 공통)② §4.2 하단 주석에 "악센트(orange)는 sand·white 면 위에만 배치한다"를 하드룰로 추가 ③ §10 자동검증에 A6-2 항목 신설 — 비텍스트 요소의 인접 면 대비 ΔG ≥ 40 검사 |
| 근거 | Design.md §4.6 CM-20 (비텍스트 ΔG ≥ 40 = 3:1) · GRADE 척도 (foundations) |
R3. principle 블록 높이·내부 구조 미규정 — P2
| 구분 | 내용 |
|---|---|
| 대상 | A3/module.a3-explainer.md §6 · §7 |
| 현행 규정 | §6 — principle 면당 1개, 키커 ≤ 12자, 진술 ≤ 80자 / §7 — principle 진술 권장 60자·최대 80자, "전폭 1~2행". 블록 자체의 높이·패딩·키커 배치 규정 없음 |
| 발견 경위 | Item 01 v0.1.0에서 결론 존을 **30mm(5행)**로 잡았으나 진술이 1행뿐이라 내부 여백이 과다했음. v0.1.1에서 **18mm(3행)**로 축소하고 확보한 12mm를 카드 본문 5행·요소 스트립 4행으로 재배분함. 어느 쪽도 지침 위반이 아니어서 판단 근거가 제작자 재량에 있었음 |
| 문제 | 결론 존은 PD-1이 정한 면당 유일한 결론 지점인데 크기 규정이 없어 면마다 무게감이 달라진다 |
| 개정 제안 | §6 principle 행에 다음을 추가한다.· 구조 — 키커 1행 + 진술 1~2행의 상하 적층. 키커는 caption/자간 +0.18em, 진술은 title-sm· 높이 — 진술 1행 시 18mm(3행), 진술 2행 시 24mm(4행). 상하 패딩 각 space.100(6mm)· 진술이 2행을 초과하면 예산 위반으로 판정한다 (BG-A1: 글자 크기를 줄이지 않고 내용을 줄인다) · 진술 1행 상한을 자수(80자)가 아니라 존 폭 기준으로 재정의 — 전폭 372mm ÷ 4.48mm ≈ 83자, 좌우 패딩 24mm 반영 시 77자 |
| 근거 | PD-1 결론 존 단일성 · PT-A2 · BG-A1 · §2.2 6mm 격자 |
R4. stagecard 내부 수직 리듬 미규정 — P2
| 구분 | 내용 |
|---|---|
| 대상 | A3/module.a3-explainer.md §6 · §7 |
| 현행 규정 | §6 — stagecard 변형 3종, 단계 3~5개 / §7 — 스테이지 설명 권장 40자·최대 60자. 카드 내부에 어떤 슬롯이 몇 개 들어가는지 규정 없음 |
| 발견 경위 | Item 01 카드에 ① 헤더 밴드(번호+제목+영문) ② 뱃지 ③ 본문 ④ 구분선 ⑤ 속성행 4행 을 넣었으나, 이 구성은 지침에 없는 제작자 설계임. 특히 "속성행"은 §6 컴포넌트 카탈로그에 없는 구조라 A11(카탈로그 외 0건) 판정에 저촉될 소지가 있음 |
| 문제 | 카드 내부 구조가 매 면 달라지면 PF-1(반복 구조에 의한 예측 가능성)이 성립하지 않는다 |
| 개정 제안 | ① §6 stagecard에 슬롯 정의를 추가 — header(밴드 9mm, 번호·제목·보조라벨) / badge(선택, 6mm) / body(3~5행) / rule(hairline) / attrs(선택, 최대 4행 — 라벨 caption green + 값 body-sm brown, 라벨 열 폭 존 폭의 25%)② 카드 총 높이는 6mm 격자 배수로만 지정한다 ③ attrs를 컴포넌트 카탈로그에 keyvalue 신규 등재 (확장 규약 §6.7 컴포넌트 12단계 절차 적용, MINOR) |
| 근거 | PF-1 · PF-2 · §10 A11 (카탈로그 외 0건) · §6.7 확장 규약 |
R5. connector 배치 공간 미확보 — P2
| 구분 | 내용 |
|---|---|
| 대상 | A3/module.a3-explainer.md §2.3 · §6 |
| 현행 규정 | §2.3 — 4:4:4 = 120mm × 3, 거터 6mm / §6 — connector 1종, 획 1.00mm, "귀결 커넥터만 악센트" / §5 P3 — stagecard×4 + connector. 커넥터를 어디에 어떤 크기로 두는지 규정 없음 |
| 발견 경위 | 3단 계보를 그리면서 카드 사이 거터가 6mm뿐이어서 화살표를 넣을 공간이 사실상 없었음. 제작자가 (a) 거터 안에 4.5mm 길이 화살표를 넣고 (b) 커넥터 라벨은 카드 상단의 별도 6mm 밴드로 분리하는 방식을 임의로 고안함 |
| 문제 | P3 패턴은 커넥터를 전제하는데 분할 규정은 커넥터 공간을 남기지 않는다. 패턴과 그리드가 서로 모순 |
| 개정 제안 | ① §2.3에 커넥터 동반 분할 행 추가 — 4:4:4 (connector) = 카드 폭 114mm × 3 + 커넥터 존 12mm × 2 (합계 372, 잔차 0)② §6 connector에 형태 규정 추가 — 커넥터 존 중앙, 카드 수직 중심선, 길이 ≥ 8mm, 화살촉 폭 3mm③ 브리지 라벨을 신규 슬롯으로 정의 — 카드 밴드 직상단 6mm 1행, caption, 커넥터 존 중심 정렬. 라벨은 악센트 카운트에서 제외 |
| 근거 | §2.3 정합 규칙(잔차 0) · §5 P3 · PF-2 정의된 분할만 사용 |
R6. 패턴 혼용 시 밴드 규정 부재 — P3
| 구분 | 내용 |
|---|---|
| 대상 | A3/module.a3-explainer.md §5 PT-A1 |
| 현행 규정 | PT-A1 — "1면 = 패턴 1개. 패턴 혼용 시 상하 밴드를 분할하되 분할선은 컬럼 경계·6mm 격자에 스냅한다". 밴드 간격·밴드 제목 처리 규정 없음 |
| 발견 경위 | Item 01은 상단 P3(3단 계보) + 하단 4:4:4 요소 스트립의 혼용 구성. 밴드 사이에 절 제목("정의를 구성하는 네 요소") + 우측 연장 룰을 두었으나 이는 제작자 설계임 |
| 문제 | 혼용은 허용하면서 그 형식을 정하지 않아, 밴드 경계가 면마다 다르게 표현된다 |
| 개정 제안 | PT-A1에 다음을 추가한다. · 밴드 간 간격은 space.300(18mm) 이상, 그중 상단 6mm는 절 제목 행으로 사용할 수 있다· 절 제목은 title-sm green + 제목 우측에서 콘텐츠 우단까지 hairline 룰을 연장한다· 한 면의 밴드는 최대 2개. 3개 이상이면 면을 나눈다 |
| 근거 | PT-A1 · PF-1 · A3E-2 |
R7. SVG·인쇄 산출물에 A7(리터럴 0건) 적용 불가 — P1
| 구분 | 내용 |
|---|---|
| 대상 | A3/module.a3-explainer.md §10 A7 (주) · Design.md §4.1 CM-1 (종속) |
| 현행 규정 | §10 A7 — "리터럴: 산출물 내 HEX·치수 하드코딩 0건" / CM-1 — "산출물에 HEX·치수 리터럴이 등장하지 않는다" |
| 발견 경위 | Item 01을 SVG로 제작하면서, SVG에는 토큰을 참조할 기구가 없어 모든 색이 fill="#1F524B" 형태의 HEX로, 모든 좌표가 mm 수치로 들어갈 수밖에 없음을 확인함. 규정을 문자 그대로 적용하면 A7은 구조적으로 PASS가 불가능하다 |
| 문제 | 검증 항목이 산출 매체의 실제 조건과 맞지 않는다. 이 상태로는 A7이 형식적으로 무시되거나, 전 산출물이 FAIL로 판정된다. 어느 쪽이든 게이트로 기능하지 못한다 |
| 개정 제안 | A7을 매체별로 분기한다. · screen(HTML/CSS) — 현행 유지. CSS 사용자 정의 속성으로 토큰 참조, 리터럴 0건· print·presentation(SVG/PDF/PPTX 등 토큰 참조 기구가 없는 산출 형식) — 리터럴 사용을 허용하되 ① 파일 상단에 HEX ↔ 토큰명 대응표를 주석으로 명시하고 ② 사용된 전 HEX가 design.tokens.json 등재값과 완전 일치할 것을 판정 기준으로 한다 (A7′: 미등재 HEX 0건)· 치수는 6mm 격자·스페이싱 토큰 값과의 일치로 판정한다 (A7″: 토큰 외 치수 0건) · 상위 CM-1도 같은 취지로 단서를 단다 |
| 근거 | GV-7 (tokens.json이 SSOT) · GV-8 (정합 검증 게이트) · §3.5 매체별 규칙 대조(단위 원칙이 매체마다 다름) |
| 참고 | 본 원장 등재 시점의 임시 조치로, Item 01 SVG v0.1.1은 파일 상단 주석에 토큰 대응표를 이미 기재하였다 |
4. 반영 이력
| 개정 버전 | 반영 항목 | 반영일 | 비고 |
|---|---|---|---|
| — | — | — | 아직 반영된 항목 없음 |
5. 다음 개정 시 처리 순서 (권고)
- P1 먼저 — R2(색 인접 금지), R7(A7 매체 분기). 둘 다 검증 체계의 결함이므로 다른 항목의 판정에 영향을 준다
- P2 — R1 → R4 → R3 → R5 순. R4에
keyvalue컴포넌트 신규 등재가 포함되므로design.components.md확장 절차(§6.7, 12단계 + 14항 체크리스트)를 함께 수행한다 - P3 — R6
- 반영 후 M5 구조 검증 12항 재수행,
design.modules.md§4.4 등록 현황 갱신, 버전은 MINOR 상향(v0.2.0) — 규칙 강화·컴포넌트 추가에 해당 (GV §6.1)
개정 착수 전 확인: 본 원장은 M5 A3 설명자료 1개 모듈의 실사용에서만 도출되었다. 동일 공백이 M1·M2·M3·M4·M6에도 존재할 가능성이 높으므로, R2·R7은
Design.md공통 원칙 층에서 처리하는 것이 반복 개정을 줄인다 (AR-1 · GV-3).