@simplysm/sd-claude 14.0.80 → 14.0.81

package/claude/rules/sd-design-rules.md

@@ -1,44 +1,44 @@
-# 코드 설계·변경 규칙
-
-Claude 에이전트가 코드 작성·설계·변경 시 따라야 할 행동 지침이다.
-
-## 인터페이스 설계 시
-
-- 산출물 소비자 표면(공개 API·props·옵션·UI·출력 등)의 단순함이 내부 구현 단순함보다 우선:
-  - 복잡도는 내부로 흡수
-  - 불가능할 경우 사용자 보고 후 결정
-- 내부 구현 난이도 회피를 위해 소비자 요구 완화·근사화 금지:
-  - 난이도는 내부로 흡수
-  - 불가능할 경우 사용자 보고 후 결정
-- 명시 정의 자체를 임의로 단순화하여 처리 금지:
-  - 정확 구현 부담이 크면 단순화안을 사용자에 보고 후 합의
-
-## 변경 전 기존 패턴 조사
-
-변경 전, 변경 영역의 기존 코드 패턴과 개발 매뉴얼을 먼저 조사한다.
-
-- `@simplysm/*` 14.x 패키지 변경 시 → `.claude/references/sd-simplysm14/README.md` 참조
-
-## 라이브러리 우회 금지
-
-- 의존 라이브러리 동작 이상 → 우회 코드 작성 전 라이브러리 측 원인 먼저 조사
-  - 라이브러리 버그·누락 판단 시 → 사용자에게 보고 후 수정 경로 혹은 이슈 발행 제안
-- 우회 코드 작성 금지:
-  - 불가피할 경우, 사용자 보고 후 결정
-
-## 에러 처리 시 throw 원칙
-
-문제 발생 시 throw:
-
-- silent skip 금지 — 예외 캐치 후 대안 없이 진행하면 후속 프로세스가 결손된 채 동작
-- **자동 복구** (예: 의존 미설치 → 설치·재시도 = 완전 동작 회복) 는 silent skip 아님
-
-## 사용자 표면 알림 작성 시 심각도 분류
-
-사용자 표면 알림(로그·토스트·다이얼로그 등)의 심각도 분류 기준:
-
-- `error` (danger): 문제 발생. catch·무시·재시도 여부와 무관하게 "문제가 일어난 사실" 이면 전부 해당
-- `warn`: 문제는 아니지만 사용자가 인지해야 할 중요 알림
-- `info`: 알면 좋은 일반 알림
-- `success`: 정상 완료 알림
-- 안티패턴: 무중단·복구 처리되었다는 이유로 `error` 대신 `warn` 선택 — 분류 기준 오용
+# 코드 설계·변경 규칙
+
+Claude 에이전트가 코드 작성·설계·변경 시 따라야 할 행동 지침.
+
+## 인터페이스 설계 시
+
+- 산출물 소비자 표면(공개 API·props·옵션·UI·출력 등)의 단순함이 내부 구현 단순함보다 우선:
+  - 복잡도는 내부로 흡수.
+  - 불가능할 경우 사용자 보고 후 결정.
+- 내부 구현 난이도 회피를 위해 소비자 요구 완화·근사화 금지:
+  - 난이도는 내부로 흡수.
+  - 불가능할 경우 사용자 보고 후 결정.
+- 명시 정의 자체를 임의로 단순화하여 처리 금지:
+  - 정확 구현 부담이 크면 단순화안을 사용자에 보고 후 합의.
+
+## 변경 전 기존 패턴 조사
+
+변경 전, 변경 영역의 기존 코드 패턴과 개발 매뉴얼을 먼저 조사.
+
+- `@simplysm/*` 14.x 패키지 변경 시 → `.claude/references/sd-simplysm14/README.md` 참조.
+
+## 라이브러리 우회 금지
+
+- 의존 라이브러리 동작 이상 → 우회 코드 작성 전 라이브러리 측 원인 먼저 조사.
+  - 라이브러리 버그·누락 판단 시 → 사용자에게 보고 후 수정 경로 혹은 이슈 발행 제안.
+- 우회 코드 작성 금지:
+  - 불가피할 경우, 사용자 보고 후 결정.
+
+## 에러 처리 시 throw 원칙
+
+문제 발생 시 throw:
+
+- silent skip 금지 — 예외 캐치 후 대안 없이 진행하면 후속 프로세스가 결손된 채 동작.
+- **자동 복구** (예: 의존 미설치 → 설치·재시도 = 완전 동작 회복) 는 silent skip 아님.
+
+## 사용자 표면 알림 작성 시 심각도 분류
+
+사용자 표면 알림(로그·토스트·다이얼로그 등)의 심각도 분류 기준:
+
+- `error` (danger): 문제 발생. catch·무시·재시도 여부와 무관하게 "문제가 일어난 사실" 이면 전부 해당.
+- `warn`: 문제는 아니지만 사용자가 인지해야 할 중요 알림.
+- `info`: 알면 좋은 일반 알림.
+- `success`: 정상 완료 알림.
+- 안티패턴: 무중단·복구 처리되었다는 이유로 `error` 대신 `warn` 선택 — 분류 기준 오용.

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

@@ -1,40 +1,40 @@
 ---
 name: sd-commit
-description: 워크스페이스의 모든 변경을 단일 커밋으로 묶는 스킬. Use when 여러 변경 사항을 한 번에 커밋해야 할 때
+description: 워크스페이스의 모든 변경을 단일 커밋으로 묶는 스킬. Use when 여러 변경 사항을 한 번에 커밋해야 할 때.
 model: haiku
 ---
 
 # 총괄 커밋
 
-system prompt 의 "Committing changes with git" 절차를 따르되, 아래만 적용한다.
+system prompt 의 "Committing changes with git" 절차를 따르되, 아래만 적용함.
 
 ## git 호출 prefix
 
-- 대상: 모든 git 호출 (`status`·`diff`·`log`·`add`·`commit`)
+- 대상: 모든 git 호출 (`status`·`diff`·`log`·`add`·`commit`).
 - 목적: Pre-tool 훅의 전역 git 조회 차단 우회 마커. `add`·`commit` 도 일관성으로 동일 prefix.
 - **도구별 prefix** — 사용 도구에 맞는 문법 1개만 선택:
-  - Bash 도구 → `SDGIT=1 git ...`
-  - PowerShell 도구 → `$env:SDGIT='1'; git ...`
+  - Bash 도구 → `SDGIT=1 git ...`.
+  - PowerShell 도구 → `$env:SDGIT='1'; git ...`.
 - 금지:
-  - Bash 도구에 `$env:...` 사용 — PowerShell 문법
-  - PowerShell 도구에 `SDGIT=1 git ...` 사용 — bash inline env 문법, PowerShell 파서 에러
+  - Bash 도구에 `$env:...` 사용 — PowerShell 문법.
+  - PowerShell 도구에 `SDGIT=1 git ...` 사용 — bash inline env 문법, PowerShell 파서 에러.
 
 ## staging
 
-- `git add -A` 사용
-- 본 스킬 호출 = 사용자가 `-A` 위험(민감 파일 staging) 인지·동의
+- `git add -A` 사용.
+- 본 스킬 호출 = 사용자가 `-A` 위험(민감 파일 staging) 인지·동의.
 
 ## 커밋 메시지
 
-- 언어: 사용자 응답 언어와 일치
-- 단일 갈래: 제목 1줄
+- 언어: 사용자 응답 언어와 일치.
+- 단일 갈래: 제목 1줄.
 - 복수 갈래:
-  - 제목: 갈래를 `및`·`,` 로 한 줄 병합
-  - 본문 (빈 줄 후): 갈래별로 아래 블록 반복, 블록 간 빈 줄 분리
-    - 헤더: `[<type>]: <갈래 요약>`
-    - 변경 항목 bullet (`-`)
-  - `<type>`: conventional commits — `fix`·`feat`·`refactor`·`docs`·`chore`·`test`·`build`·`ci`·`style`·`perf`
+  - 제목: 갈래를 `및`·`,` 로 한 줄 병합.
+  - 본문 (빈 줄 후): 갈래별로 아래 블록 반복, 블록 간 빈 줄 분리.
+    - 헤더: `[<type>]: <갈래 요약>`.
+    - 변경 항목 bullet (`-`).
+  - `<type>`: conventional commits — `fix`·`feat`·`refactor`·`docs`·`chore`·`test`·`build`·`ci`·`style`·`perf`.
 
 ## 푸시
 
-- 수행 X
+- 수행 X.

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

@@ -1,12 +1,12 @@
 ---
 name: sd-config
-description: sd-* 스킬 사용에 필요/권장되는 프로젝트 설정을 항목별로 사용자와 확인하며 적용하는 스킬. Use when sd-* 를 쓰기 전 환경을 점검하거나 누락 항목을 채울 때
+description: sd-* 스킬 사용에 필요/권장되는 프로젝트 설정을 항목별로 사용자와 확인하며 적용하는 스킬. Use when sd-* 를 쓰기 전 환경을 점검하거나 누락 항목을 채울 때.
 ---
 
-각 항목을 차례로 점검한다. 이미 값이 있으면 변경할지 묻고, 비어 있으면 추가 여부를 묻는다. 동의하면 값을 묻거나 기본값을 제안한 뒤 파일에 기록한다. 파일이 없으면 새로 만든다.
+각 항목을 차례로 점검. 이미 값이 있으면 변경할지 묻고, 비어 있으면 추가 여부를 물음. 동의하면 값을 묻거나 기본값을 제안한 뒤 파일에 기록. 파일이 없으면 새로 만듦.
 
 - **python (필수)** — 프로젝트 루트 `mise.toml` 의 `[tools] python`.
-  sd-* 스크립트가 python 을 사용한다. 없으면 `python = "3"` 을 추가할지 묻는다.
+  sd-* 스크립트가 python 을 사용함. 없으면 `python = "3"` 을 추가할지 물음.
 
 - **tmpdir (권장)** — `.claude/simplysm.json` 의 `tmpdir`.
-  지정 시 sd-* 임시파일이 그 폴더에 생성된다. 없으면 OS tmp 를 쓴다. 추가 여부를 묻고, 동의 시 경로를 묻는다.
+  지정 시 sd-* 임시파일이 그 폴더에 생성됨. 없으면 OS tmp 를 씀. 추가 여부를 묻고, 동의 시 경로를 물음.

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

@@ -1,18 +1,18 @@
 ---
 name: sd-demo
-description: spec.md 의 화면 1개를 클라이언트 패키지의 화면 컴포넌트 자리에 인터랙티브 데모 골격으로 만든다. Use when "데모 만들기", "화면 데모", "spec 의 화면을 시각화" 를 요청할 때
+description: spec.md 의 화면 1개를 클라이언트 패키지의 화면 컴포넌트 자리에 인터랙티브 데모 골격으로 만들기. Use when "데모 만들기", "화면 데모", "spec 의 화면을 시각화" 를 요청할 때.
 ---
 
 # sd-demo
 
-spec.md 화면 1개를 클라이언트 패키지의 화면 컴포넌트 자리에 데모로 만든다. 와이어프레임 상의 배치·라벨·동작 흐름이 일치하는 클릭 가능 UI. 후속 단계에서 같은 자리에 실제 로직을 채워 진화한다.
+spec.md 화면 1개를 클라이언트 패키지의 화면 컴포넌트 자리에 데모로 만듦. 와이어프레임 상의 배치·라벨·동작 흐름이 일치하는 클릭 가능 UI. 후속 단계에서 같은 자리에 실제 로직을 채워 진화함.
 
 ## 본질: UI 가 1순위
 
-소비자는 시연 받는 사용자. 사용자는 화면만 본다. 코드는 후속 단계가 다시 짠다.
+소비자는 시연 받는 사용자. 사용자는 화면만 봄. 코드는 후속 단계가 다시 짬.
 
-- **주의·시간의 90% 를 template 에 쓴다.** 와이어프레임을 시각적으로 정확·정돈되게 복원하는 게 본 작업의 본질.
-- 코드 골격(시그널·effect·DI·핸들러)은 **코드베이스에서 분석해 따라간다** — 본 스킬은 framework 처방을 박아두지 않는다.
+- **본 작업의 주력 = template 복원.** 와이어프레임을 시각적으로 정확·정돈되게.
+- 코드 골격(시그널·effect·DI·핸들러)은 **코드베이스에서 분석해 따라감** — 본 스킬은 라이브러리 규약을 박아두지 않음.
 - 데이터 변경 시뮬레이션 금지. 저장·삭제 핸들러는 마커만. 클릭은 받되 결과 반영 X.
 - 모달 띄우기는 실제로 작동시켜 시연 가치 확보.
 
@@ -22,44 +22,46 @@ spec.md 화면 1개를 클라이언트 패키지의 화면 컴포넌트 자리
 
 호출에 다음 필요:
 
-- 대상 spec.md 경로
-- 만들 화면 식별자 — `[화면.X]` 또는 §4.x
-- 산출 위치 — 클라이언트 패키지 + 화면 폴더. client 타겟이 1개면 자동, 여러 개면 후보 제시 후 사용자 확정. **3단계-C 의 도메인 인접 화면이 명확히 식별되면 그 위치(같은 도메인 폴더)로 자동 채택** (1단계 초안을 인접 위치로 갱신).
+- 대상 spec.md 경로.
+- 만들 화면 식별자 — `[화면.X]` 또는 §4.x.
+- 산출 위치 초안 — 클라이언트 패키지 + 화면 폴더. client 타겟이 1개면 자동, 여러 개면 후보 제시 후 사용자 확정. (3단계-C 끝에서 도메인 인접 결과로 갱신)
 
 없으면 묻기. spec.md 에 식별자 매칭이 안 되면 §4 화면 목록 표에서 후보 제시 후 확정.
 
-**[gate] 3단계 A (라이브러리 문서) 진입 전엔 3단계 이후 출력 금지**
-
-- 3단계 진입 시 A 부터 Read (B·C 보다 먼저).
-- 스킵 안티패턴 — "참고 코드 부재" 신호 (빈 패키지·답습 화면 없음·client 타겟 비어있음 등) 로 A 건너뛰고 B(본체 소스 grep)·C(부위별 수집) 점프
-- A 미진입 → 3단계 이후 모든 출력 보류
+**충돌 확인**: 대상 화면(또는 동반 모달 §4.x) 파일이 이미 있으면 묻기 — ① 덮어쓰기 / ② spec 변경분만 보강 / ③ 취소. 호출자 발화에 명시 분기가 있으면 묻지 않고 그 분기로 진행.
 
 ### 2단계: spec §4.x 분석
 
 §4.x 에서 추출:
 
-- 헤더 인덱스(Actor · 관련 섹션 · 장치)
-- 기능 개요 · 와이어프레임 · 항목표 · 동작 · 도메인 규칙(해당 시)
-- §동작에 등장하는 모달 호출 `→ [화면.Y] 을 모달로 띄움` 모두 수집
+- 헤더 인덱스(Actor · 관련 섹션 · 장치).
+- 기능 개요 · 와이어프레임 · 항목표 · 동작 · 도메인 규칙(해당 시).
+- §동작에 등장하는 모달 호출 `→ [화면.Y] 을 모달로 띄움` 모두 수집.
 
 ### 3단계: 분석 자료 확보
 
-산출물을 만들기 전, 다음을 분석해 framework 처방을 확보한다.
+**[gate] 3단계 A (라이브러리 문서) 진입 전엔 3단계 이후 출력 금지**.
+
+- 3단계 진입 시 A 부터 Read (B·C 보다 먼저).
+- 스킵 안티패턴 — "참고 코드 부재" 신호 (빈 패키지·답습 화면 없음·client 타겟 비어있음 등) 로 A 건너뛰고 B(본체 소스 grep)·C(부위별 수집) 점프.
+- A 미진입 → 3단계 이후 모든 출력 보류.
+
+산출물을 만들기 전, 다음을 분석해 라이브러리 규약을 확보함.
 
 **A. 라이브러리 문서**
 
-코드베이스에 권위 규약/매뉴얼 문서가 있으면 1순위로 따른다.
+코드베이스에 권위 규약/매뉴얼 문서가 있으면 1순위로 따름.
 
 - `@simplysm/*` 14.x 사용 시 — [.claude/references/sd-simplysm14/README.md](../../references/sd-simplysm14/README.md) Read 후 "개발 매뉴얼" 항목 진입. 클라이언트 화면은 `client-component.md`, 화면 컨트롤은 `client-tab.md` 등.
 - 그 외 framework 는 코드베이스 안의 동등 위치 문서를 찾아 Read.
 
 **B. 라이브러리 컴포넌트 소스**
 
-쓰려는 컴포넌트(예: `sd-form`, `sd-crud-list`)가 있으면 **본체 소스를 직접 Read** 해 input/output·동작을 정확히 파악. 사용처 grep 만으로는 누락된 prop 을 놓친다.
+쓰려는 컴포넌트(예: `sd-form`, `sd-crud-list`)가 있으면 **본체 소스를 직접 Read** 해 input/output·동작을 정확히 파악. 사용처 grep 만으로는 누락된 prop 을 놓침.
 
 **C. 부위별 패턴 레퍼런스 수집**
 
-코드베이스의 클라이언트 화면 전반에서 **부위(부분)별로 공통 패턴**을 수집한다. "구성 똑같은 화면 1개를 골라 통째 답습" 모델이 아니다. 일치 화면이 있어도, 부위별 종합 결과 위에 추가로 얹는다.
+코드베이스의 클라이언트 화면 전반에서 **부위(부분)별로 공통 패턴**을 수집함. "구성 똑같은 화면 1개를 골라 통째 답습" 모델이 아님. 일치 화면이 있어도, 부위별 종합 결과 위에 추가로 얹음.
 
 **수집 대상 부위** (대상 화면이 사용하는 것만 골라 수집):
 
@@ -73,7 +75,6 @@ spec.md 화면 1개를 클라이언트 패키지의 화면 컴포넌트 자리
 | 폼          | 필드 그리드·라벨/입력 배치·필수 표시·버튼 푸터                  |
 | 모달        | 헤더·본문·푸터·확인/취소 버튼·크기                              |
 | 빈 상태     | 아이콘·여백·문구                                                |
-| 도메인 위치 | 같은 sub-app·같은 도메인 폴더 후보(산출 위치 자동 채택용)       |
 
 **절차**:
 
@@ -82,26 +83,19 @@ spec.md 화면 1개를 클라이언트 패키지의 화면 컴포넌트 자리
 3. 부위별 공통 패턴(자주 쓰는 슬롯·클래스·요소 구조) 메모화. 1회만 쓰인 변종은 채택 후보에서 배제, 다수에서 반복되는 것을 채택.
 4. 부위별 패턴이 화면마다 갈라지면 (예: 리스트가 테이블·카드 두 갈래) 대상 화면의 와이어프레임이 어느 쪽인지로 선택.
 
-**도메인 인접 후보**: 같은 sub-app·같은 도메인 폴더에 화면이 1개 이상 있으면 그 폴더를 산출 위치 자동 채택 근거로 쓴다. 0개면 라우팅·메뉴 등록 위치를 사용자에게 1회 질문.
-
-LLM 단독 판단 한계: 동일 구성 화면이 한 곳도 없다고 framework 처방만으로 그리면 안 된다. **반드시 부위별로 수집한 패턴을 근거로** 그려야 한다. 부위별 후보가 0개인 부위가 있으면 그 부위만 사용자에게 1회 질문 (그 화면의 그 부위 어떻게 처리할지).
-
-### 4단계: 충돌 확인
-
-대상 화면(또는 동반 모달 §4.x) 파일이 이미 있으면 묻기:
-
-- ① 덮어쓰기 / ② spec 변경분만 보강 / ③ 취소
+**도메인 인접 후보 → 산출 위치 확정**: 같은 sub-app·같은 도메인 폴더에 화면이 1개 이상 있으면 그 폴더로 1단계 산출 위치 초안 갱신 (자동 채택). 0개면 라우팅·메뉴 등록 위치를 사용자에게 1회 질문.
 
-호출자 발화에 명시 분기가 있으면 묻지 않고 그 분기로 진행.
+LLM 단독 판단 한계: 동일 구성 화면이 한 곳도 없다고 라이브러리 규약만으로 그리면 안 됨. **반드시 부위별로 수집한 패턴을 근거로** 그려야 함. 부위별 후보가 0개인 부위가 있으면 그 부위만 사용자에게 1회 질문 (그 화면의 그 부위 어떻게 처리할지).
 
-### 5단계: 생성
+### 4단계: 생성
 
-3단계 분석 자료(A/B/C)를 1순위 근거로, **template 부터** 채운다.
+3단계 분석 자료(A/B/C)를 1순위 근거로, **template 부터** 채움.
 
 - 파일명·selector·시그널·DI 명명 등은 라이브러리 문서(A) 가 정한 형식 그대로.
-- 슬롯·영역 분할·클래스 패턴은 3단계-C 부위별 패턴 채택분 그대로. 부위별로 다른 화면을 참조했더라도 각 부위 채택분을 그대로 옮긴다.
-- 부위별 채택분이 코드베이스 어느 화면에서 왔는지 출처를 머릿속에 두고 비교 가능 상태로 유지(6단계 점검용).
-- 모달 호출 화면이면 동반 모달 §4.x 도 같은 단계로 생성.
+- 슬롯·영역 분할·클래스 패턴은 3단계-C 부위별 패턴 채택분 그대로. 부위별로 다른 화면을 참조했더라도 각 부위 채택분을 그대로 옮김.
+- 부위별 채택분의 출처(레퍼런스 화면 파일 경로)를 메모해 5단계 점검 입력으로 사용.
+- 모달 호출 화면이면 동반 모달 §4.x 도 같은 단계로 생성. 모달 띄우기는 실제 작동시켜 시연 가치 확보.
+- 저장·삭제 등 데이터 변경 핸들러는 마커(`// sd-demo: 미구현 — 동작 자리`)만. 클릭은 받되 결과 반영 X.
 
 **표식 마커 (고정)**
 
@@ -110,31 +104,29 @@ LLM 단독 판단 한계: 동일 구성 화면이 한 곳도 없다고 framework
 | 더미 데이터 선언 위      | `// sd-demo: 더미 — 구현 단계에서 교체`                    |
 | 미구현 핸들러 본문       | `// sd-demo: 미구현 — 동작 자리`                           |
 | 더미 타입 인라인 선언 위 | `// sd-demo: 더미 타입 — 구현 단계에서 @모델/X 로 교체`    |
-| 종류 매핑 임의 추정      | `// sd-demo: 종류 매핑 임의 — 확인 필요`                   |
-| 권한 path 임의 추정      | `// sd-demo: 권한 path 임의 — 확인 필요`                   |
+| 임의 추정값 선언/사용 위 | `// sd-demo: 임의 추정값 — 확인 필요`                      |
 
-다른 변형 사용 금지. 후속 단계가 grep 으로 추적한다.
+다른 변형 사용 금지. 후속 단계가 grep 으로 추적함.
 
-### 6단계: 자체 점검
+### 5단계: 자체 점검
 
 **패스 1: 부위별 패턴 일치** — 3단계-C 에서 부위마다 채택한 레퍼런스 화면을 다시 Read 해 부위별로 비교:
 
-- 헤더/툴바: 도구 버튼 배치·라벨 형식·간격·클래스 동일
-- 영역 분할: split/탭/sheet/dock 사용 동일
-- 리스트: 헤더 셀·행 셀 마크업·정렬/선택 슬롯 동일
-- 폼: 필드 그리드·라벨/입력 배치·푸터 버튼 동일
-- 모달: 헤더·본문·푸터 구조 동일
-- 빈 상태: 아이콘·여백·문구 동일
+- 헤더/툴바: 도구 버튼 배치·라벨 형식·간격·클래스 동일.
+- 영역 분할: split/탭/sheet/dock 사용 동일.
+- 리스트: 헤더 셀·행 셀 마크업·정렬/선택 슬롯 동일.
+- 폼: 필드 그리드·라벨/입력 배치·푸터 버튼 동일.
+- 모달: 헤더·본문·푸터 구조 동일.
+- 빈 상태: 아이콘·여백·문구 동일.
 
 부위 중 한 곳이라도 채택 패턴과 어긋나면(임의 변형·새 클래스 발명·새 슬롯 사용) 수정. "비슷한 화면이 없어서 알아서 그렸다"는 자기 합리화 금지 — 그 부위 채택분이 비어 있다는 뜻이므로 3단계-C 로 돌아가 수집·재선택.
 
 **패스 2: 라이브러리 문서 위배 점검** — 3단계-A 의 매뉴얼 문서 항목별 일치 확인. 위배 항목이 있으면 수정 후 재점검.
 
-### 7단계: 완료 보고
+### 6단계: 완료 보고
 
 만든 파일 목록 보고 후 종료.
 
 ## 운용
 
 - 결정 근거: `sd-base-rules.md` "결정 근거" 적용.
-- 본 스킬은 framework 처방을 박아두지 않는다. 매 호출 시 3단계에서 분석한 라이브러리 문서·컴포넌트 소스·답습 화면을 근거로 산출.

package/claude/skills/sd-demo/evals/fixtures/inventory-list/.specs/inventory/spec.md

@@ -0,0 +1,99 @@
+# 재고 관리 요구 분석서
+
+## 1. 개요
+
+### 1.1 핵심 목적 [확정: 2026-05-26]
+
+창고별 품목 재고 현황 조회 시스템
+
+### 1.2 주요 목표 [확정: 2026-05-26]
+
+- 창고별·품목별 재고 현황 조회
+
+### 1.3 최종 사용자/이해관계자 [확정: 2026-05-26]
+
+- 창고 관리자: PC 로 재고 현황 조회
+
+### 1.4 환경/장치 [확정: 2026-05-26]
+
+```
+   ┌─────────┐
+   │   PC    │
+   └────┬────┘
+        │
+        ▼
+   ┌──────────┐
+   │ WMS 서버 │
+   └──────────┘
+```
+
+- PC — 창고 관리자가 재고 화면 조회에 사용
+  - OS: Windows 11
+  - Browser: Chrome 최신
+  - 해상도: 1920 x 1080
+
+## 4. 화면
+
+| §   | 분류 | 화면      | 유형 | 장치 |
+| --- | ---- | --------- | ---- | ---- |
+| 4.1 | 재고 | 재고 조회 | 조회 | PC   |
+
+### 4.1 재고 조회 (PC) [확정: 2026-05-26]
+
+Actor: 창고 관리자
+관련 섹션: [모델.재고]
+
+기능 개요:
+
+- 창고별·품목별 재고 현황 조회
+
+#### 와이어프레임
+
+```
+┌────────────────────────────────────────────────────────────────────┐
+│ 재고 조회                                                          │
+│ [조회]  <필터>                                                     │
+├────────────────────────────────────────────────────────────────────┤
+│ <재고 목록 시트>                                                   │
+└────────────────────────────────────────────────────────────────────┘
+```
+
+#### 항목
+
+**필터**
+
+| 항목      | 종류      | 필수 | 비고                     |
+| --------- | --------- | ---- | ------------------------ |
+| 창고      | 정적 선택 | X    | 전체·창고 목록           |
+| 품목 검색 | 텍스트    | X    | 코드 또는 명칭 부분 일치 |
+
+**재고 목록 시트**
+
+| 컬럼   | 종류 | 필수 | 도메인 매핑          | 비고      |
+| ------ | ---- | ---- | -------------------- | --------- |
+| 창고   | 문자 | -    | [모델.재고.창고]     |           |
+| 품목   | 문자 | -    | [모델.재고.품목명]   |           |
+| 재고량 | 숫자 | -    | [모델.재고.수량]     | 우측 정렬 |
+| 갱신일 | 날짜 | -    | [모델.재고.갱신일]   |           |
+
+#### 동작
+
+- `[조회]` 클릭: 검색 필터 조건으로 목록 갱신
+
+#### 빈 상태
+
+- 검색 결과 없음: "조회된 재고가 없습니다." 표시
+
+## 8. 도메인 모델
+
+### 8.1 재고 [확정: 2026-05-26]
+
+필드:
+
+| 필드   | 타입 | 필수 | 비고             |
+| ------ | ---- | ---- | ---------------- |
+| ID     | 숫자 | O    | 자동 부여        |
+| 창고   | 문자 | O    | 창고명           |
+| 품목명 | 문자 | O    | 품목명           |
+| 수량   | 숫자 | O    | 재고 수량        |
+| 갱신일 | 날짜 | O    | 마지막 갱신 일자 |

package/claude/skills/sd-demo/evals/fixtures/inventory-list/packages/demo-client/package.json

@@ -0,0 +1,12 @@
+{
+  "name": "@demo/client",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "dependencies": {
+    "@angular/core": "^21.0.0",
+    "@ng-icons/core": "^32.0.0",
+    "@ng-icons/tabler-icons": "^32.0.0",
+    "@simplysm/angular": "^14.0.0"
+  }
+}

package/claude/skills/sd-demo/evals/fixtures/inventory-list/packages/demo-client/src/index.ts

@@ -0,0 +1,3 @@
+export { InventoryMasterListComponent } from "./screens/inventory/inventory-master.list";
+export { OutboundListComponent } from "./screens/outbound/outbound.list";
+export { InboundListComponent } from "./screens/inbound/inbound.list";

package/claude/skills/sd-demo/evals/fixtures/inventory-list/packages/demo-client/src/screens/inbound/inbound.list.ts

@@ -0,0 +1,150 @@
+import {
+  ChangeDetectionStrategy,
+  Component,
+  ViewEncapsulation,
+  effect,
+  inject,
+  signal,
+  untracked,
+} from "@angular/core";
+import {
+  injectPermsSignal,
+  mark,
+  SdCrudListComponent,
+  SdSheetColumnDirective,
+  SdTextfieldComponent,
+  SdToastProvider,
+} from "@simplysm/angular";
+
+interface IInboundItem {
+  id: number;
+  receiptNo: string;
+  supplierName: string;
+  itemName: string;
+  quantity: number;
+  receivedAt: string;
+}
+
+interface IFilter {
+  searchText: string;
+}
+
+@Component({
+  selector: "app-inbound-list",
+  changeDetection: ChangeDetectionStrategy.OnPush,
+  encapsulation: ViewEncapsulation.None,
+  standalone: true,
+  imports: [SdCrudListComponent, SdSheetColumnDirective, SdTextfieldComponent],
+  template: `
+    <div class="flex-column fill">
+      <sd-crud-list
+        title="입고 내역 조회"
+        [(ready)]="ready"
+        [initialized]="initialized()"
+        [(busyCount)]="busyCount"
+        [items]="items()"
+        [(selectedKeys)]="selectedKeys"
+        [(page)]="page"
+        [totalPageCount]="pageLength()"
+        [(sorts)]="sortingDefs"
+        [trackByFn]="trackByFn"
+        [restricted]="!perms().includes('use')"
+        (filterSubmit)="onFilterSubmit()"
+      >
+        <ng-template #filterTpl>
+          <div class="form-box-inline">
+            <div>
+              <label>검색</label>
+              <sd-textfield [(value)]="filter().searchText" (valueChange)="mark(filter)" />
+            </div>
+          </div>
+        </ng-template>
+
+        <sd-sheet-column [key]="'receiptNo'" [header]="'입고 번호'">
+          <ng-template [cell]="items()" let-item="item">
+            <div class="p-xs-sm">{{ item.receiptNo }}</div>
+          </ng-template>
+        </sd-sheet-column>
+
+        <sd-sheet-column [key]="'supplierName'" [header]="'공급처'">
+          <ng-template [cell]="items()" let-item="item">
+            <div class="p-xs-sm">{{ item.supplierName }}</div>
+          </ng-template>
+        </sd-sheet-column>
+
+        <sd-sheet-column [key]="'itemName'" [header]="'품목'">
+          <ng-template [cell]="items()" let-item="item">
+            <div class="p-xs-sm">{{ item.itemName }}</div>
+          </ng-template>
+        </sd-sheet-column>
+
+        <sd-sheet-column [key]="'quantity'" [header]="'수량'">
+          <ng-template [cell]="items()" let-item="item">
+            <div class="p-xs-sm tx-right">{{ item.quantity }}</div>
+          </ng-template>
+        </sd-sheet-column>
+      </sd-crud-list>
+
+      @if (initialized() && items().length === 0) {
+        <div class="p-default tx-center tx-theme-gray-default">조회된 입고 내역이 없습니다.</div>
+      }
+    </div>
+  `,
+})
+export class InboundListComponent {
+  private readonly _sdToast = inject(SdToastProvider);
+
+  perms = injectPermsSignal(["inbound"], ["use"]);
+
+  ready = signal(false);
+  initialized = signal(false);
+  busyCount = signal(0);
+
+  items = signal<IInboundItem[]>([]);
+  selectedKeys = signal<number[]>([]);
+  page = signal(0);
+  pageLength = signal(0);
+  sortingDefs = signal<{ key: string; desc: boolean }[]>([]);
+
+  filter = signal<IFilter>({ searchText: "" });
+  lastFilter = signal<IFilter>({ searchText: "" });
+
+  trackByFn = (item: IInboundItem) => item.id;
+
+  protected readonly mark = mark;
+
+  constructor() {
+    effect(() => {
+      if (!this.perms().includes("use") || !this.ready()) {
+        this.initialized.set(true);
+        return;
+      }
+
+      this.lastFilter();
+      this.page();
+      this.sortingDefs();
+
+      void untracked(async () => {
+        this.busyCount.update((v) => v + 1);
+        await this._sdToast.try(async () => {
+          await this._refresh();
+        });
+        this.busyCount.update((v) => v - 1);
+        this.initialized.set(true);
+      });
+    });
+  }
+
+  onFilterSubmit(): void {
+    this.page.set(0);
+    this.lastFilter.set({ ...this.filter() });
+  }
+
+  doRefresh(): void {
+    if (!this.perms().includes("use")) return;
+    mark(this.lastFilter);
+  }
+
+  private async _refresh(): Promise<void> {
+  }
+}