Pier_v1/RAG/design system_v0.1.1/revision-backlog.md

# 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` 행에 변형별 표현 규정을 추가한다.<br>· `base` — white 면 + hairline(0.20mm) brown 보더<br>· `emphasis` — base + 보더 `regular`(0.40mm) + **좌측 세로 악센트바 `space.025`(1.5mm)**, 바는 **헤더 밴드 하단부터** 시작하고 하단 라운드 시작점 전에서 끝낸다<br>· `prominent` — green 면 + white 전경 (역상)<br>· `quiet` — sand 면 + hairline 보더, 본문 위계 1단 하향<br>**악센트바는 §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 · **✗ 인접·중첩 금지(텍스트·비텍스트 공통)**<br>② §4.2 하단 주석에 "**악센트(orange)는 sand·white 면 위에만 배치한다**"를 하드룰로 추가<br>③ §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` 행에 다음을 추가한다.<br>· 구조 — **키커 1행 + 진술 1~2행**의 상하 적층. 키커는 `caption`/자간 +0.18em, 진술은 `title-sm`<br>· 높이 — 진술 1행 시 **18mm(3행)**, 진술 2행 시 **24mm(4행)**. 상하 패딩 각 `space.100`(6mm)<br>· 진술이 2행을 초과하면 **예산 위반**으로 판정한다 (BG-A1: 글자 크기를 줄이지 않고 내용을 줄인다)<br>· 진술 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%)<br>② 카드 총 높이는 **6mm 격자 배수**로만 지정한다<br>③ `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)<br>② §6 `connector`에 형태 규정 추가 — 커넥터 존 중앙, 카드 수직 중심선, 길이 ≥ 8mm, 화살촉 폭 3mm<br>③ **브리지 라벨**을 신규 슬롯으로 정의 — 카드 밴드 **직상단 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에 다음을 추가한다.<br>· 밴드 간 간격은 **`space.300`(18mm) 이상**, 그중 상단 6mm는 **절 제목 행**으로 사용할 수 있다<br>· 절 제목은 `title-sm` green + **제목 우측에서 콘텐츠 우단까지 hairline 룰**을 연장한다<br>· 한 면의 밴드는 **최대 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을 **매체별로 분기**한다.<br>· `screen`(HTML/CSS) — 현행 유지. CSS 사용자 정의 속성으로 토큰 참조, 리터럴 0건<br>· `print`·`presentation`(SVG/PDF/PPTX 등 **토큰 참조 기구가 없는 산출 형식**) — 리터럴 사용을 허용하되 **① 파일 상단에 `HEX ↔ 토큰명` 대응표를 주석으로 명시**하고 **② 사용된 전 HEX가 `design.tokens.json` 등재값과 완전 일치**할 것을 판정 기준으로 한다 (**A7′: 미등재 HEX 0건**)<br>· 치수는 **6mm 격자·스페이싱 토큰 값과의 일치**로 판정한다 (**A7″: 토큰 외 치수 0건**)<br>· 상위 CM-1도 같은 취지로 단서를 단다 |
| **근거** | GV-7 (tokens.json이 SSOT) · GV-8 (정합 검증 게이트) · §3.5 매체별 규칙 대조(단위 원칙이 매체마다 다름) |
| **참고** | 본 원장 등재 시점의 임시 조치로, Item 01 SVG v0.1.1은 파일 상단 주석에 토큰 대응표를 이미 기재하였다 |

---

## 4. 반영 이력

| 개정 버전 | 반영 항목 | 반영일 | 비고 |
| :--- | :--- | :--- | :--- |
| — | — | — | 아직 반영된 항목 없음 |

---

## 5. 다음 개정 시 처리 순서 (권고)

1. **P1 먼저** — R2(색 인접 금지), R7(A7 매체 분기). 둘 다 검증 체계의 결함이므로 다른 항목의 판정에 영향을 준다
2. **P2** — R1 → R4 → R3 → R5 순. R4에 `keyvalue` 컴포넌트 신규 등재가 포함되므로 `design.components.md` 확장 절차(§6.7, 12단계 + 14항 체크리스트)를 함께 수행한다
3. **P3** — R6
4. 반영 후 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).