@simplysm/sd-claude 14.0.79 → 14.0.80

package/claude/skills/sd-spec/SKILL.md

@@ -5,13 +5,15 @@ description: SI/업무시스템 요구사항을 분석해 spec.md 로 구조화
 
 # sd-spec
 
-요구사항 → spec.md 1개. 사이클(임의안 → 합의 → 반영)의 반복으로 채움.
+요구사항 → spec.md 1개. 사이클 반복으로 채움.
 
 ## 입출력
 
 - **Input**: Requirement Source (회의록·메일·문서·PDF·발화 등 비정형) + 사용자 대화 + (재진입) 기존 spec.md
 - **Output**: spec.md 1개 (후속 도구 sd-impl·sd-demo 의 입력 계약)
-- **폴더**: `.specs/{yyMMddHHmmss}_{slug}/` — `yyMMddHHmmss` 는 Bash `date +%y%m%d%H%M%S`, slug 는 한·두 단어 (sd-base-rules "slug")
+- **폴더**: `.specs/{yyMMddHHmmss}_{slug}/`
+  - `yyMMddHHmmss`: Bash `date +%y%m%d%H%M%S` (예: `260513204500` = 2026-05-13 20:45:00)
+  - `slug`: 짧은 한·두 단어. 허용 문자 = 한글·영문·`_`·`-`·공백 (그 외 금지)
 
 ## 사이클 (본체)
 
@@ -27,28 +29,39 @@ description: SI/업무시스템 요구사항을 분석해 spec.md 로 구조화
 
 #### 큰 순서 (권장)
 
-| 순서      | spec.md 매핑                          |
-| --------- | ------------------------------------- |
-| 분석 분할 | §2/§3 헤더 분할 + spec.md 골격 생성   |
-| 분석 명세 | §1 + §2/§3 본문                       |
-| 설계 분할 | §4/§5/§6 헤더 분할                    |
-| 설계 명세 | §4/§5/§6 본문                         |
+| 단계      | 진입                     | spec.md 매핑                        | 절차 위치               | 다음             |
+| --------- | ------------------------ | ----------------------------------- | ----------------------- | ---------------- |
+| 분석 분할 | Requirement Source 수집  | §2/§3 헤더 분할 + spec.md 골격 생성 | §2 안 "분할 절차"       | §x.x 분석 명세   |
+| 분석 명세 | 분석 분할 완료 §x.x      | §1 + §2/§3 본문                     | §별 작성법 (사이클 2~5) | §x.x 설계 분할   |
+| 설계 분할 | 분석 명세 §x.x 본문 확정 | §4/§5/§6 헤더 분할                  | §4 안 "설계 분할 절차"  | §x.x 설계 명세   |
+| 설계 명세 | 설계 분할 §x.x [OPEN]    | §4/§5/§6 본문                       | §별 작성법 (사이클 2~5) | (반복 / 종료)    |
+
+- **분할 단계 사이클** (분석 분할 / 설계 분할 공통, 5 단계 적용):
+  1. 임의안 = 분류 평면 채팅 출력 + 순서·명칭
+     - 분석 분할 = §2 후보 / §3 후보 / 미분류 (분류 룰 = §2 "분할 절차")
+     - 설계 분할 = §4 후보 / §5 후보 / §6 후보 (분류 룰 = §4 "설계 분할 절차")
+  2. 사용자 피드백 = 분류 이동 / 순서 / 명칭 / 추가·제거 / "전부 확정"
+  3. 피드백 → 구성 갱신 → 채팅 재출력 → 2 재진입 (**루프**)
+  4. "전부 확정" → 헤더 일괄 Write ([OPEN: 날짜] + 본문 = 분석 방법 자동)
+     - 분석 분할 = spec.md 골격 신규 + §2.x/§3.x 헤더 일괄
+     - 설계 분할 = §4.x/§5.x/§6.x 헤더 일괄
+- **명세 단계**: §x.x 본문을 §별 임의안 단위 따라 1건씩 사이클 (2~5단계).
 
 #### 자유 진입
 
 - 큰 순서 안 §x.x 선택 = 사용자 자유 (지시 없으면 LLM 권장)
 - 큰 순서 간 §x.x 단위 파이프라인 — 전체 완료 강제 X
   - 예: §2.1 본문 확정 → §2.1 관련 §4/§5/§6 분할 진입 (§2.2 본문 미시작 OK)
-  - 의존성 strict: 다음 큰 순서는 해당 §x.x 직전 순서 완료 후
+  - 의존성 strict: §x.x 단위로 직전 큰 순서 완료 후 다음 큰 순서 진입 (예: §4.1 본문 진입 = §4.1 헤더 분할 + §2.1 본문 완료 후)
 - 서브섹션끼리는 자유 (§4.1 안 와이어·항목·동작 등 순서)
 - §7/§8/§9 = 작업 중 자연 도출 (다른 § 영향, 5단계 참조)
-- §10 = 결정 발생 시 누적
+- §10 = 결정 발생 시 누적 (각 결정 항목 = 1 사이클)
 
 #### 재진입 분기 (spec.md 첨부 시)
 
 | 상황                                       | 권장 진입점                                                       |
 | ------------------------------------------ | ----------------------------------------------------------------- |
-| 헤더 `[OPEN: 날짜]` 있음                   | 첫 OPEN 섹션 본문 포인터로 자료 재독 → 임의안 → 사이클 진입       |
+| 헤더 `[OPEN: 날짜]` 있음                   | 첫 OPEN 섹션 본문 분석 방법대로 재분석 → 임의안 → 사이클 진입     |
 | 본문 인라인 `[OPEN]` 만                    | 첫 OPEN 항목부터 1건씩                                            |
 | 모두 `[확정]`                              | 사용자 추가 요구 대기                                             |
 
@@ -60,9 +73,9 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 
 #### 자가검증 게이트
 
-매 임의안 출력 직전 자문. 하나라도 실패 = 폐기 후 재작성 또는 사용자 질문.
+매 임의안 출력 직전 자문. 하나라도 실패 = 폐기 후 재작성 또는 사용자 질문. sd-base-rules "출력 직전 자가검증" 위에 추가되는 sd-spec 고유 검증.
 
-1. **형식** — § 작성법 규약 따랐는가 (헤더 구조·표 형식·마커 표기)
+1. **형식** — § 작성법 규약 따랐는가 (해당 § 작성법 절 재독 후 헤더 구조·표 형식·마커 표기 점검)
 2. **출처** — 각 항목·필드·동작 1건마다 사용자 발언·자료 인용 가능한가
    - 인용 불가 = As-Is 답습 / 다른 §·example 패턴 복제 의심 → 제거 또는 별도 질문
    - As-Is (회의록·매뉴얼·현행 화면) 는 추정 자료 (sd-base-rules "결정 근거 안티패턴")
@@ -81,28 +94,33 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 #### 확정 → Write
 
 - 헤더 마커 `[확정: YYYY-MM-DD]` 부착 (Bash `date +%Y-%m-%d`)
-- Write 직전 출력 1줄 (sd-base-rules "진행 근거 인용"):
+- Write 직전 출력 1줄 (sd-base-rules "사용자 발언 의도 파악" — 의도 표기):
 
-  `> 진행 근거: 사용자 발언 "<verbatim 인용>" 의 "<신호 부분>"`
+  `> 사용자 의도: 승인. 근거: 사용자 발언 "<verbatim 인용>" 의 "<실행 신호 부분>"`
 
 #### 수정 → 재작성
 
 - 사용자 정정 반영 → 2단계 임의안 재작성 → 3단계 재진행
 
-#### 보류 → Write (재분석 포인터)
+#### 보류 → Write (분석 방법)
 
-- 헤더 마커 `[OPEN: YYYY-MM-DD]`
-- 본문 = 재분석 포인터만 (임의안 X):
-  - **자료 위치**: Requirement Source 파일·범위 (예: `회의록.md L12-30`, `첨부A.pdf p.3`)
-  - **대화 발췌**: 사용자 보류 즈음 또는 사이클 중간 끊김 시 사용자 의견·정정·근거 1~2줄 (Requirement Source 발화 X — 그건 자료 위치)
-  - **자료 연결 메모**: 한 섹션이 여러 자료에 걸치면 연결 추정 한 줄
-  - **다른 § 확정 영향 메모**: OPEN 유지 중 다른 § 확정이 본 OPEN 재분석에 영향 시 누적 한 줄. 형식: `§X.Y <섹션명> 확정 — <결정 한 줄>` (운용 = 5단계 OPEN 푸시)
+OPEN 섹션 본문 = **분석 방법** (임의안 X) — 재분석할 절차 또는 접근 방식 자유 작성. 헤더 마커 `[OPEN: YYYY-MM-DD]`.
 
-발생 경로:
-- 사용자 명시 보류 (임의안 후 보류 지시)
-- 헤더 분할 직후 자동 (분석 분할 §2.x/§3.x · 설계 분할 §4.x/§5.x/§6.x 헤더 분할 시 본문 미작성 상태로 일괄 OPEN)
+분석 방법 가이드 (해당 시 자유 조합):
 
-재개 시 본문 포인터로 자료 재독 → 임의안 도출 → 확정되면 본문 임의안 교체 + 헤더 `[확정: 날짜]`.
+- 자료 참고 시 자료 위치 명시 (예: `회의록.md L12-30`, `As-Is 매뉴얼 X.pdf p.3`)
+- 사용자 보류 발언 인용 (1~2줄)
+- 한 섹션이 여러 자료에 걸치면 자료 연결 추정 한 줄
+- 다른 § 확정이 본 OPEN 재분석에 영향 시 한 줄 누적 (운용 = 5단계 OPEN 푸시. 형식: `§X.Y <섹션명> 확정 — <결정 한 줄>`)
+
+**발생 경로** (본문 = 분석 방법 공통):
+
+- 사용자 명시 보류 (임의안 후 보류 지시) — 분석 방법 자유 작성
+- 헤더 분할 직후 자동 (본문 미작성 일괄 OPEN):
+  - 분석 분할 §2.x/§3.x — 분석 방법 = Requirement Source 자료 위치·접근 방식
+  - 설계 분할 §4.x/§5.x/§6.x — 분석 방법 = 관련 §2.x/§3.x 본문 참고
+
+**재개**: 본문 분석 방법대로 자료 재독·분석 → 임의안 도출 → 확정되면 본문 임의안 교체 + 헤더 `[확정: 날짜]`.
 
 ### 5단계: 부산물 점검
 
@@ -127,11 +145,15 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 
 영향 §가 현재 §와 다르면 "다른 § 영향" 절차.
 
+#### 진행 방법 누적
+
+사이클 중 사용자가 진행 방식 합의 시 즉시 누적. 형식·운용 = `## spec.md 형식` 안 "진행 방법 누적" 절 참조.
+
 #### OPEN 섹션 영향 푸시
 
 확정 결정이 OPEN 상태 다른 § 재분석에 영향 줄 수 있는지 자문.
 
-- 영향 있으면 해당 OPEN 본문 포인터에 `§X.Y <섹션명> 확정 — <결정 한 줄>` 메모 추가
+- 영향 있으면 해당 OPEN 본문 분석 방법에 `§X.Y <섹션명> 확정 — <결정 한 줄>` 메모 추가
 - 같은 작업에 함께. 사용자에 한 줄 보고
 - 별도 "맞나요?" X (확정 기록일 뿐, 임의안 X)
 
@@ -175,7 +197,7 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 | 마커                                   | 의미                                                                                                                                                                       |
 | -------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
 | `[확정: YYYY-MM-DD]`                   | 섹션 확정. 본문 인라인 `[OPEN]` 있어도 무방.                                                                                                                               |
-| `[OPEN: YYYY-MM-DD]`                   | 섹션 미확정 (사용자 보류 또는 헤더 분할 직후 자동). 본문 = 재분석 포인터만. 임의안(BPMN/와이어프레임/항목 등) 채우지 X.                                                    |
+| `[OPEN: YYYY-MM-DD]`                   | 섹션 미확정 (사용자 보류 또는 헤더 분할 직후 자동). 본문 = 분석 방법. 임의안(BPMN/와이어프레임/항목 등) 채우지 X.                                                          |
 | `[확정: YYYY-MM-DD, 구현: YYYY-MM-DD]` | §4/§5/§6 한정. `[확정]` 에 `구현: 날짜` 콤마 결합. sd-impl 시연 검증 통과 시 부착. 본문 변경 시 `, 구현: …` 제거 (구버전 구현 무효화). 운용 = 5단계 구현 마커 제거.       |
 
 대괄호 쌍 연달은 표기(`[확정: …][구현: …]`) 마크다운이 reference-style 링크로 해석 → 단일 대괄호 안 콤마 결합 형식.
@@ -200,6 +222,35 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 - `[화면.재고 확인]`·`[프로세스.입고]`·`[기타.과거 재고 조회]`
 - `[자동 처리.재고 스냅샷]`·`[횡단 처리.DataLog 기록]`·`[외부인터페이스.ERP 입고 통보]`·`[공통 정의.Location 라벨]`
 
+**관련 섹션 한 줄**: §2~§9 본문에 `관련 섹션: [카테고리.이름], ...` 한 줄로 참조/의존 섹션 콤마 나열 (카테고리 제한 없음). **임의안 단위 X** — 다른 sub-section 작성 부산물로 자동 누적.
+
+### sub-section 헤더 레벨
+
+§별 sub-section 의 spec.md 본문 표기 룰 통합 — 평문 (헤더 없이 라벨·한 줄·bullet 직접) / h4 마크다운 헤더 (`####`).
+
+| §  | 평문 sub-section (형식)                                       | h4 sub-section                                                       |
+| -- | ------------------------------------------------------------- | -------------------------------------------------------------------- |
+| §2 | BPMN (mermaid fence) · 흐름 설명 bullet · 관련 섹션 (한 줄)   | (없음)                                                               |
+| §4 | 헤더 인덱스 (한 줄씩) · 기능 개요 (라벨 + bullet)             | 와이어프레임 · 항목 · 동작 · 시각 규칙 · 도메인 규칙·로직 · 자유 추가 |
+| §5 | 목적 (라벨 + 한 줄) · 트리거 (라벨 + 본문) · 관련 섹션 (한 줄) | 처리 · 예외 처리 · 자유 추가                                         |
+| §6 | 목적 (라벨 + 한 줄) · 트리거 (라벨 + 본문) · 관련 섹션 (한 줄) | 처리 · 예외 처리 · 자유 추가                                         |
+| §9 | 기본 정보 (라벨 bullet 3) · 관련 섹션 (한 줄)                 | 자료 매핑 · 예외 처리                                                |
+
+SKILL.md 안 `#### BPMN`·`#### 목적` 등 표기는 작성법 sub-section 분류. spec.md 본문 표기는 위 표 룰.
+
+### 진행 방법 누적
+
+사이클 중 사용자가 진행 방식 합의 시 (예: "시트별로 분석", "시트별 분석 = 6단계 답습") 즉시 누적. 범위에 따라 2 경로:
+
+**spec 전체 적용** → §10 진행 방법 항목 (`- YYYY-MM-DD: ...` bullet)
+
+**분석 단위 한정** (§X.Y 또는 안 sub-section/sub-단위) → 해당 단위 도입부 NOTE blockquote:
+- 형식: `> **NOTE** (진행 방법): <한 줄 요약>` blockquote + 다단 (`> 1. ...`·`> 2. ...` 형식)
+- 분석 단위 헤더가 `[OPEN]` 상태면 본 NOTE 가 다른 대화 재진입 시 진행 룰 회복 출처
+- 본 단위 모든 sub-단위 합의 후 `[확정]` 환원 시 NOTE 유지 (진행 이력 기록 보존) 또는 제거 (분석 단위 룰)
+
+별도 "맞나요?" X (사용자 발언 직접 기록).
+
 ## §1 개요
 
 **임의안 단위**: §1.1·§1.2·§1.3·§1.4 4건. §1.4 = ASCII 구성도 1 + 장치 목록 1 (총 2).
@@ -226,6 +277,8 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 
 ### §1.4 환경/장치
 
+분석 단계 초안 합의 → 설계 단계 진행 중 보강 가능 (5단계 다른 § 영향).
+
 구성도와 장치 목록 목적 별개 → 각각 독립 작성.
 
 - **ASCII 구성도**: 현장이 어떻게 생겼는지 시각화 — 이해당사자 간 그림 맞추기
@@ -239,7 +292,6 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 **임의안 단위**: §2.x 1개당 위→아래 1건씩:
 1. BPMN (사용자에겐 ASCII, 확정 후 mermaid 저장)
 2. 흐름 설명 bullet
-3. 관련 섹션
 
 **모범**: example-spec.md §2.1.
 
@@ -291,24 +343,21 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 
 ### 본문 구조
 
-#### 1. BPMN
-
-- 사용자에겐 ASCII, 확정 후 mermaid 저장
-- 노드 = 최종 사용자 액션·시스템 핵심 트랜잭션 (1행 동사구). 줄바꿈 `<br/>` X
-- Actor·장치·매체(PDA·PC·종이)는 액션 컨텍스트로 노드에 명시 OK (예: `창고 작업자: PDA 박스 바코드 스캔`). OS·해상도·API·DB 등 시스템 내부 디테일 X
-- 외부 채널 송신(메일·파일 다운로드)·외부 응답 수신(다음 사이클 자료 도착)도 노드. 처리 노드 = 사각(`T[...]`), 이벤트 노드 = 둥근(`E([...])`)
-- 분기 = 사용자 의사결정 분기만
-
-#### 2. 흐름 설명 bullet
-
-- BPMN 아래·관련 섹션 위에 자유 나열 (별도 헤더 X)
-- 노드 동사구만으로 안 잡히는 룰·조건·계산식·외부 약속·자료 출처 인용 등 1줄씩
-- §4/§5/§6 본문 작성 시 이 bullet 들을 근거로 매핑 → 누락 방지
-- 단, §4/§5/§6 자체 디테일(필드·UI·파일 확장자) / §7/§8/§9 정형 명세는 여기 X — 각 § 본문에선 이름 참조
+sub-section 헤더 레벨 = `## spec.md 형식` 안 "sub-section 헤더 레벨" 표 참조.
 
-#### 3. 관련 섹션
+**평문 sub-section** (§2.x 헤더 바로 아래, 위→아래):
 
-`관련 섹션: [카테고리.이름], ...` 한 줄. 본 섹션이 참조/의존하는 다른 섹션을 콤마 나열 (카테고리 제한 없음).
+- **BPMN** (mermaid fence):
+  - 사용자에겐 ASCII, 확정 후 mermaid 저장
+  - 노드 = 최종 사용자 액션·시스템 핵심 트랜잭션 (1행 동사구). 줄바꿈 `<br/>` X
+  - Actor·장치·매체(PDA·PC·종이)는 액션 컨텍스트로 노드에 명시 OK (예: `창고 작업자: PDA 박스 바코드 스캔`). OS·해상도·API·DB 등 시스템 내부 디테일 X
+  - 외부 채널 송신(메일·파일 다운로드)·외부 응답 수신(다음 사이클 자료 도착)도 노드. 처리 노드 = 사각(`T[...]`), 이벤트 노드 = 둥근(`E([...])`)
+  - 분기 = 사용자 의사결정 분기만
+- **흐름 설명 bullet** (BPMN 아래·관련 섹션 위에 자유 나열):
+  - 노드 동사구만으로 안 잡히는 룰·조건·계산식·외부 약속·자료 출처 인용 등 1줄씩
+  - §4/§5/§6 본문 작성 시 이 bullet 들을 근거로 매핑 → 누락 방지
+  - 단, §4/§5/§6 자체 디테일(필드·UI·파일 확장자) / §7/§8/§9 정형 명세는 여기 X — 각 § 본문에선 이름 참조
+- **관련 섹션** (`관련 섹션: [카테고리.이름], ...` 한 줄, 자동 누적): 본문 내 참조 절 룰 따름
 
 ### 안티패턴 (분할)
 
@@ -332,23 +381,26 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 ### 본문 구조
 
 - 요구 의도 (한 줄~한 문단)
-- `관련 섹션: [카테고리.이름], ...` 한 줄
+- 관련 섹션 한 줄 (본문 내 참조 절)
 - 구현 디테일은 §4 화면 / §5 자동 처리 / §6 횡단 처리 본문에서
 
 ## §4 화면
 
 **임의안 단위**: §4.x 1개당 §4.x 표준 구조 절 단위로 위→아래, 각 확정 후 다음:
-1. 헤더 인덱스 (Actor·관련 섹션) — 1건 (본문 짧으면 기능 개요와 묶기 가능)
-2. 기능 개요 — 1건
-3. 와이어프레임 — 1건
-4. 항목 — 영역(좌/우 등) → 하위 요소(필터·시트 컬럼·입력/상세 폼) 단위로 쪼개기. 각 영역의 각 하위 요소별 1건
-5. 동작 — 1건
+1. 기능 개요 — 1건
+2. 와이어프레임 — 1건
+3. 항목 — 다단 분할:
+   - 1차: 영역 (좌/우 등) 단위 — 와이어프레임 영역 라벨 기준
+   - 2차: 영역 안 하위 요소 (필터·시트 컬럼·입력/상세 폼) 단위
+   - 1 임의안 = 1 (영역, 하위 요소) 쌍 — 예: `좌측 영역 — 필터` 1건, `좌측 영역 — 시트 컬럼` 별건
+4. 동작 — 1건
+5. 시각 규칙 (해당 시) — 1건
 6. 도메인 규칙·로직 (해당 시) — 규칙별 1건
-7. 양식 매핑 (해당 시) — 양식별 1건
+7. 자유 추가 sub-section (해당 시) — sub-section 별 1건 (예: 업로드 양식·다운로드 양식 각각). 복잡 양식 안 sub-단위 (시트 등) = sub-단위별 1건.
 
-신규 작성·정정·골격 신설 무관 동일 적용.
+(헤더 인덱스 = Actor + 관련 섹션 모두 자동 누적 — 임의안 단위 X)
 
-설계 분할 단계 헤더 분할 시 §4.x 헤더 `[OPEN: 날짜]` 일괄 + 본문 = 관련 §2.x/§3.x 1줄 참조 포인터. 임의안 본문(와이어프레임·항목·동작) X.
+신규 작성·정정·골격 신설 무관 동일 적용.
 
 **모범** (와이어 패턴별):
 - 시트 화면: example-spec.md §4.1·§4.3
@@ -356,6 +408,19 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 - PDA: §4.5
 - 분석 시트: §4.6
 
+### 설계 분할 절차 (§4/§5/§6 공통)
+
+설계 분할 단계에서 §4/§5/§6 헤더를 §2/§3 본문 (+ §8 마스터 엔티티) 에서 도출. 절차:
+
+1. **§4 화면 도출**:
+   - §2 BPMN 최종 사용자 액션 노드 + §3 사용자 직접 요구 → 트랜잭션/조회 화면
+   - §8 마스터 엔티티 → 마스터 화면
+   - 도메인 묶음/장치별 그룹화 → 화면 목록 표
+2. **§5 자동 처리 도출** — §2/§3 의 시스템 백그라운드 처리 (스케줄·이벤트 트리거·외부 자료 수집·적재) 추출
+3. **§6 횡단 처리 도출** — §3 시스템 전반 자동 룰 + §4/§5 부수효과 동작 추출
+
+각 § 헤더 분할 직후 자동 OPEN (4단계 보류 발생 경로 참조).
+
 ### 화면 목록 표 (§4 첫머리)
 
 5컬럼: `§ | 분류 | 화면 | 유형 | 장치`
@@ -367,16 +432,18 @@ sd-base-rules "단위 흡수 금지" 적용 — 단번에 yes/no 가능한 최
 
 ### 화면 정의 (§4.x 표준 구조)
 
-#### 헤더 인덱스 (한 줄씩)
+화면 헤더에 (장치) 표기 유지: `### N.N 화면명 (PC) [확정: 날짜]` 또는 `(PDA)`.
 
-- `Actor: <역할>`
-- `관련 섹션: [카테고리.이름], ...` — 모달 호출·시트 영역 재활용 등 화면 간 의존 포함
+sub-section 헤더 레벨 = `## spec.md 형식` 안 "sub-section 헤더 레벨" 표 참조.
 
-화면 헤더에 (장치) 표기 유지: `### N.N 화면명 (PC) [확정: 날짜]` 또는 `(PDA)`.
+**평문 sub-section** (§4.x 헤더 바로 아래, 위→아래):
 
-#### 기능 개요
+- **헤더 인덱스** (한 줄씩, 자동 누적 — 임의안 단위 X):
+  - `Actor: <역할>` — §2 BPMN swim lane 또는 §3 사용자 직접 요구에서 자연 도출
+  - `관련 섹션:` 본문 내 참조 절 룰 따름 — 모달 호출·시트 영역 재활용 등 화면 간 의존 포함
+- **기능 개요**: `기능 개요:` 라벨 다음 bullet 로 화면 기능 설명
 
-bullet 로 화면 기능 설명.
+**h4 sub-section** (평문 아래, 고정 순서, 위→아래):
 
 #### 와이어프레임 (텍스트)
 
@@ -417,7 +484,10 @@ ASCII 그림 공통 규칙은 output-style `sd-tone` "ASCII 그림" 절 참조.
 
 #### 동작
 
-액션 버튼·이벤트별 처리.
+bullet `- <트리거>: 처리 내용` 형식.
+
+- 트리거 예: `` `[버튼]` 클릭 ``, `박스 바코드 스캔`, `Enter 키`
+- 처리 내용: 동사구 + 대상 (예: `[화면.X] 을 모달로 띄움`, `검색 필터 조건으로 목록 갱신`)
 
 #### 시각 규칙 (해당 시)
 
@@ -425,18 +495,19 @@ ASCII 그림 공통 규칙은 output-style `sd-tone` "ASCII 그림" 절 참조.
 
 #### 도메인 규칙·로직 (해당 시)
 
-표준 절(항목/동작/양식 매핑)로 안 담기는 화면 고유 도메인 요구. 자유 명칭 절 필요한 만큼 추가. 누락 없이 적는 게 핵심.
-
-#### 양식 매핑 (해당 시)
+표준 sub-section 으로 안 담기는 화면 고유 도메인 요구. 자유 명칭 절 필요한 만큼 추가. 누락 없이 적는 게 핵심.
 
-외부 양식 파일을 다루는 동작(업로드·다운로드)별로 매핑 표.
+**자유 추가 sub-section** (`#### 도메인 규칙·로직` 아래, 화면별 필요 시 h4 자유 추가):
 
-- 컬럼: `파일 컬럼` + `도메인 모델 ([모델.X.Y])` + `변환·규칙 (해당 시)`
-- 양식별 별도 표 + 방향 명시 (예: `업로드 양식`, `다운로드 양식`)
-- §7.x 명세 양식이면 컬럼명 일치, 일회성이면 화면 안에서 직접 명세
+- **양식 입출력** (예: `#### 업로드 양식`·`#### 다운로드 양식`) — 양식별 별도 sub-section.
+  - 단순 양식: 안 단순 표 — 컬럼 `파일 컬럼` + `도메인 모델 ([모델.X.Y])` + `변환·규칙 (해당 시)`. §7.x 명세 양식이면 컬럼명 일치, 일회성이면 sub-section 안에서 직접 명세.
+  - 복잡 양식 (다중 시트·구조 분할): 안 sub-단위 (시트 등) = h5 (`##### <시트>` 등). sub-단위 안 진행 방법 NOTE 가능 (`## spec.md 형식` 안 "진행 방법 누적" 절 참조).
+- **기타 화면 고유 정보** — 자유 sub-section 이름. 표준 sub-section 으로 안 담기는 화면 고유 정보 누락 방지.
 
 ### 마스터 화면 표준
 
+화면 목록 표 유형 = 마스터인 §4.x 에 적용. 화면 정의 sub-header (와이어프레임·항목·동작) 와 함께.
+
 - ID 컬럼 = 편집 버튼 (`[E N]`)
 - 첫 컬럼 = 선택 체크박스 (`[ ]`)
 - 시트 상단 버튼바: `[등록] [선택 삭제] [선택 복구] [엑셀 업로드] [엑셀 다운로드]`
@@ -444,7 +515,7 @@ ASCII 그림 공통 규칙은 output-style `sd-tone` "ASCII 그림" 절 참조.
 
 ### 상단 command 바
 
-페이지 제목 바로 아래, 시트/폼 영역 위. 페이지 전체 또는 현재 레코드 단위 액션 바.
+화면 정의 sub-header 와이어프레임·동작과 함께 작성. 페이지 제목 바로 아래, 시트/폼 영역 위. 페이지 전체 또는 현재 레코드 단위 액션 바.
 
 - 좌측: 필터 입력 + 조회 (list) / 진입 컨텍스트 표시 (detail)
 - 우측: 페이지·레코드 단위 액션 (있을 때만)
@@ -459,6 +530,8 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 
 ### 모달 처리
 
+호출하는 쪽 §4.x 동작 sub-header + 피호출 §4.x 양쪽 적용.
+
 - 모달 화면 = 별도 §4.x. 부르는 쪽 동작에 "→ [화면.X] 을 모달로 띄움" 명시
 - 화면명에 "(모달)" 등 사용 맥락 표기 X — 같은 화면이 다른 곳에서 다르게 호출될 수 있음
 - 화면 일부 영역(시트·탭)이 다른 화면에서 모달로 재활용되면 별도 §4.x 분리 X. 대신 그 화면 동작 절 끝에 영역별 모달 호출 시 제약(편집 가능 여부 / 선택 전용 / multiselect) 한 줄씩 명시. 호출하는 쪽 동작은 "→ [화면.X] 의 <영역> 을 모달로 띄움" 표기
@@ -466,15 +539,10 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 ## §5 자동 처리
 
 **임의안 단위**: §5.x 1개당 위→아래 1건씩:
-1. Flowchart (사용자에겐 ASCII, 확정 후 mermaid 저장)
-2. 목적 (본문 짧으면 트리거와 묶기 가능)
-3. 트리거
-4. 처리
-5. 예외 처리
-6. 양식 매핑 (해당 시) — 양식별 1건
-7. 관련 섹션
-
-설계 분할 단계 헤더 분할 시 §5.x 헤더 `[OPEN: 날짜]` 일괄 + 본문 = 관련 §2.x/§3.x 1줄 참조 포인터.
+1. 목적 / 트리거 (한 묶음)
+2. 처리
+3. 예외 처리
+4. 자유 추가 sub-section (해당 시) — sub-section 별 1건 (예: 읽기 양식·쓰기 양식 각각). 복잡 양식 안 sub-단위 (시트 등) = sub-단위별 1건.
 
 **모범**: example-spec.md §5.1.
 
@@ -486,46 +554,36 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 
 ### 본문 구조
 
-#### Flowchart
+sub-section 헤더 레벨 = `## spec.md 형식` 안 "sub-section 헤더 레벨" 표 참조.
 
-- 사용자에겐 ASCII, 확정 후 mermaid 저장
-- 노드 = 시스템 처리 단계 (1행 동사구)
-- 분기 = 시스템 조건 분기·예외
-- 시작 = 트리거 (시간·이벤트). 종결 = 결과
-- 특수 케이스(상태 머신 / 호출 시퀀스 등)는 mermaid 다른 type(stateDiagram-v2 / sequenceDiagram) 가능
+**평문 sub-section** (§5.x 헤더 바로 아래, 라벨 + 본문 형식):
 
-#### 목적·트리거·처리·예외 처리
+- `목적:` 도메인 목적 한 줄
+- `트리거:` 스케줄·이벤트
+- `관련 섹션:` 본문 내 참조 절 룰 따름
 
-- 목적: 본문 짧으면 트리거와 묶기 가능
-- 트리거: 스케줄·이벤트
-- 처리: 처리 단계
-- 예외 처리: 실패 케이스별 위험·대처·재시도 한계
+**h4 sub-section** (평문 아래, 고정 순서, 위→아래):
 
-#### 양식 매핑 (해당 시)
+#### 처리
 
-외부 양식 파일 다루는 처리(읽기·쓰기)별 매핑 표.
+처리 단계.
 
-- 컬럼: `파일 컬럼` + `도메인 모델 ([모델.X.Y])` + `변환·규칙 (해당 시)`
-- 양식별 별도 표 + 방향 명시 (예: `읽기 양식`, `쓰기 양식`)
-- §7.x 명세 양식이면 컬럼명 일치, 일회성이면 처리 본문에서 직접 명세
+#### 예외 처리
 
-#### 관련 섹션
+실패 케이스별 위험·대처·재시도 한계.
 
-`관련 섹션: [카테고리.이름], ...` 한 줄.
+**자유 추가 sub-section** (`#### 예외 처리` 아래, §5.x 별 필요 시 h4 자유 추가):
 
-## §6 횡단 처리
+- **양식 입출력** (예: `#### 읽기 양식`·`#### 쓰기 양식`) — §4 양식 입출력 sub-section 룰 동일. 방향 = 읽기·쓰기. 일회성이면 sub-section 안에서 직접 명세.
+- **기타 자동 처리 고유 정보** — 자유 sub-section 이름.
 
-**임의안 단위**: §6.x 1개당 위→아래 1건씩 (§5 와 동일 구조 + 모델 매핑):
-1. Flowchart (사용자에겐 ASCII, 확정 후 mermaid 저장)
-2. 목적
-3. 트리거 (부수효과 발동 조건)
-4. 처리
-5. 예외 처리
-6. 양식 매핑 (해당 시)
-7. 모델 매핑 (해당 시)
-8. 관련 섹션
+## §6 횡단 처리
 
-설계 분할 단계 헤더 분할 시 §6.x 헤더 `[OPEN: 날짜]` 일괄 + 본문 = 관련 §2.x/§3.x 1줄 참조 포인터.
+**임의안 단위**: §6.x 1개당 위→아래 1건씩:
+1. 목적 / 트리거 (부수효과 발동 조건) (한 묶음)
+2. 처리
+3. 예외 처리
+4. 자유 추가 sub-section (해당 시) — sub-section 별 1건 (예: 양식 매핑·모델 매핑). 복잡 양식 안 sub-단위 = sub-단위별 1건.
 
 **모범**: example-spec.md §6.1.
 
@@ -544,15 +602,15 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 
 ### 본문 구조
 
-#### Flowchart
+sub-section 헤더 레벨 = `## spec.md 형식` 안 "sub-section 헤더 레벨" 표 참조.
 
-- §5 동일 룰
-- 시작 = 트리거 (부수효과 발동 조건). 종결 = 결과·기록
+**평문 sub-section** (§6.x 헤더 바로 아래, 라벨 + 본문 형식):
 
-#### 트리거 (부수효과 발동 조건)
+- `목적:` 부수효과의 도메인 목적
+- `트리거:` 어떤 동작의 부수로 발동되는지 + 적용 범위 (예: "모든 엔티티 update 시 / 전체", "특정 도메인 X 변경 시 / 특정 엔티티", "API 요청 시 / 전체")
+- `관련 섹션:` 본문 내 참조 절 룰 따름
 
-- 어떤 동작의 부수로 발동되는지 명시 (예: "모든 엔티티 update 시", "특정 도메인 X 변경 시", "API 요청 시")
-- 적용 범위 (전체·특정 §·특정 엔티티) 명시
+**h4 sub-section** (평문 아래, 고정 순서, 위→아래):
 
 #### 처리
 
@@ -562,24 +620,18 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 
 실패 케이스별 위험·대처·재시도 한계.
 
-#### 양식 매핑 (해당 시)
-
-§5 동일 룰.
-
-#### 모델 매핑 (해당 시)
-
-이 횡단 처리가 사용·갱신하는 도메인 모델 매핑.
+**자유 추가 sub-section** (`#### 예외 처리` 아래, §6.x 별 필요 시 h4 자유 추가):
 
-- 표: `필드 ([모델.X.Y])` + `용도` + `변환·규칙 (해당 시)`
-
-#### 관련 섹션
-
-`관련 섹션: [카테고리.이름], ...` 한 줄.
+- **양식 입출력** (§5 양식 입출력 sub-section 룰 동일)
+- **모델 매핑** (예: `#### 모델 매핑`) — 이 횡단 처리가 사용·갱신하는 도메인 모델 매핑. 표 `필드 ([모델.X.Y])` + `용도` + `변환·규칙 (해당 시)`.
+- **기타 횡단 처리 고유 정보** — 자유 sub-section 이름.
 
 ## §7 공통 정의
 
 작성 중 자연 도출 (5단계 다른 § 영향). 새 도메인 어휘·시스템 규격 발견 시 사이클 진입.
 
+**모범**: example-spec.md §7.1~§7.4.
+
 ### §7.1 용어 사전 (고정)
 
 도메인 어휘·약어·시스템 내 의미 정의.
@@ -613,6 +665,8 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 
 작성 중 자연 도출. 새 엔티티 발견 시 사이클 진입.
 
+**모범**: example-spec.md §8.1~§8.6.
+
 섹션 구조: `필드:` 표 + `키/제약:` 불릿.
 
 ### 필드 표
@@ -635,6 +689,8 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 
 작성 중 자연 도출. 외부 시스템 호출 발견 시 사이클 진입.
 
+**모범**: example-spec.md §9.1.
+
 ### 정의
 
 §9 = 상대 시스템 고유 인터페이스 약속 (시스템마다 자료 매핑·방식 달라 협상 필요).
@@ -646,20 +702,34 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 
 도메인 약속 레벨까지만. 구체 endpoint URL·HTTP method·query 파라미터·인증 흐름 단계(grant_type·scope·token endpoint)·SDK 메소드명 등 구현 디테일 X — 구현이 알아서. (§2 BPMN·§4 와이어·§8 도메인 모델과 동일 원칙)
 
-### 본문 구조 (위→아래)
+### 본문 구조
+
+sub-section 헤더 레벨 = `## spec.md 형식` 안 "sub-section 헤더 레벨" 표 참조.
 
-- **기본 정보** (헤더 없이 불릿 3개):
+**평문 sub-section** (§9.x 헤더 바로 아래, 위→아래):
+
+- **기본 정보** (라벨 bullet 3):
   - `상대 시스템: <시스템명>`
   - `방향: <방향 표기>`
   - `전송 방식: <방식>`
-- **자료 매핑** 헤더 + 표 (상대 시스템 필드 ↔ 본 시스템 출처)
-- **예외 처리** 헤더 + 본문 (실패 케이스별 위험·대처·재시도 한계)
-- **관련 섹션** 한 줄 — 호출자 등 참조/의존 섹션을 `[카테고리.이름]` 콤마 나열
+- **관련 섹션** (`관련 섹션: [카테고리.이름], ...` 한 줄, 자동 누적): 본문 내 참조 절 룰 따름. 호출자 등 참조/의존 섹션 포함.
+
+**h4 sub-section** (평문 아래, 고정 순서, 위→아래):
+
+#### 자료 매핑
+
+표 — 상대 시스템 필드 ↔ 본 시스템 출처.
+
+#### 예외 처리
+
+실패 케이스별 위험·대처·재시도 한계.
 
 ## §10 본문 외 결정사항
 
 §1~§9 어디에도 자연스럽게 안 들어가는 결정·메모를 누적. §1~§9 적절한 자리에 박을 수 있는 결정은 §10 X (누락 도피처 X).
 
+**모범**: example-spec.md §10.
+
 ### 형식
 
 각 항목:
@@ -675,6 +745,7 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 
 매번 분류 X — 자연 흐름대로 누적. 분석 제외 신호 있을 때만 `[제외]` 마커.
 
+- **진행 방법**: **spec 전체** 작업의 사용자 합의 진행 방식 (예: 작성 순서·범위 한정·전체 적용 규칙 등). 분석 단위 한정은 `## spec.md 형식` 안 "진행 방법 누적" 절 참조 — sd-spec 본인 후속 참조용
 - **미래 결정**: 단계 도달 전 결정 (예: "추후 §4.5 작성 시 X 항목 포함") — sd-spec 본인 후속 참조용
 - **구현 영역 결정**: spec 본문에 안 들어가는 구현 측 결정 (예: 라이브러리 선택) — sd-impl 후속 참조용
 - **부정 결정**: "X 안 함" 부정 명시 — 반복 질문 방지용
@@ -695,6 +766,9 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
   - 근거: 현재 단계 X
   - 후속 처리: 다른 spec 신규
   - 자료 위치: 회의록_3.md L80-95
+
+- 2026-05-22: §4 와이어프레임은 영역 추상화만, 시각 디테일은 항목 표/동작 절로 분리
+  - 근거: 사용자 합의 — 와이어 분량 관리
 ```
 
 ## spec.md 골격 (분석 분할 단계)
@@ -734,7 +808,7 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 ```
 
 분석 분할 결과 반영:
-- §2.x/§3.x 헤더 일괄 추가 (헤더 마커 `[OPEN: 날짜]` + 본문 = 재분석 포인터)
+- §2.x/§3.x 헤더 일괄 추가 (헤더 마커 `[OPEN: 날짜]` + 본문 = 분석 방법)
 - §10 = 분석 분할 단계 사용자 명시 제외 결정 (`[제외]` 마커) 반영
 
 ## 외부 참조
@@ -743,4 +817,4 @@ list·detail 동일. 새 버튼은 해당 그룹 끝에 추가. 시트 상단
 | ---------------------------------------------------------------------------------------------------------- | ---------------------------------------------------------------------------------- |
 | [references/example-spec.md](references/example-spec.md)                                                   | spec.md 형식 모범 (WMS 예시 1건). 각 § 작성법의 "모범" 표기에서 참조               |
 | [.claude/references/sd-requirement-source-handling.md](../../references/sd-requirement-source-handling.md) | Requirement Source 부정확성 처리 (STT 오타·화자 모호·발화 모호·도메인 용어 다의성) |
-| [.claude/rules/sd-base-rules.md](../../rules/sd-base-rules.md)                                             | 결정 근거·임의안 단위·진행 근거 인용·표현 톤 등 상위 룰 (자동 로드, 중복 명시 X)   |
+| [.claude/rules/sd-base-rules.md](../../rules/sd-base-rules.md)                                             | 결정 근거·임의안 단위·발언 의도 파악·표현 톤 등 상위 룰 (자동 로드, 중복 명시 X)   |