@simplysm/sd-claude 14.0.82 → 14.0.84

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

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

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

@@ -5,7 +5,7 @@ description: 코드 변경 요청을 사용자와 합의 후 코드 변경분과
 
 # sd-dev
 
-spec.md 없이 진행하는 가벼운 코드 작업. 의도 합의 후 워크플로는 자동 진행 — 단 파일 삭제·시연 등 확인성 보고는 단계별 발생. 합의 결과는 대화 메모리에만.
+spec.md 없이 진행하는 가벼운 코드 작업. 의도 합의 후 워크플로는 자동 진행 — 단 파일 삭제·시연 등 사용자 확인이 필요한 지점에서는 보고·승인 절차 수행. 합의 결과는 별도 산출물로 저장하지 않고 대화 메모리에만 유지.
 
 ## 워크플로
 
@@ -17,11 +17,11 @@ spec.md 없이 진행하는 가벼운 코드 작업. 의도 합의 후 워크플
 - 대상 파일·모듈·패키지.
 - 변경의 입출력·동작 — 이름·시그니처·예외 동작 등.
 
-근거 충분(사용자 발화 명시 + 기존 코드 패턴 추론 가능)이면 묻지 않고 진행. 부족분은 1건씩 질문 (sd-base-rules "사용자 질의 시"). 외부 자료(시크릿·시안·샘플 데이터)가 필요하면 이 단계에서 요청.
+근거 충분(사용자 발화 명시 + 기존 코드 패턴으로 추론 가능)이면 묻지 않고 진행. 부족분은 1건씩 질문 (sd-base-rules "사용자 질의 시"). 외부 자료(예: 디자인 시안·샘플 데이터·접근 자격증명)가 필요하면 이 단계에서 사용자에게 요청.
 
 ### 2단계: 분석
 
-부재로 워크플로를 멈추지 않음. 발견된 만큼 활용.
+자료가 없어도 워크플로를 멈추지 않음. 발견된 만큼 활용.
 
 **A. 라이브러리·개발 매뉴얼**:
 - `@simplysm/*` 14.x — `.claude/references/sd-simplysm14/README.md` 참조.
@@ -37,7 +37,7 @@ spec.md 없이 진행하는 가벼운 코드 작업. 의도 합의 후 워크플
 
 ### 3단계: 작업 분해 표
 
-2단계 분석을 토대로 작업 분해 표 작성. assistant 응답으로 출력 (4단계 입력).
+2단계 분석을 토대로 작업 분해 표 작성. 응답 본문에 표 형태로 출력하여 다음 4단계 TDD 사이클의 입력으로 사용.
 
 | 항목 | 요구 | 현재 코드 상태 | 판정 | 매핑 파일 | 의존 |
 | ---- | ---- | -------------- | ---- | --------- | ---- |
@@ -51,16 +51,16 @@ spec.md 없이 진행하는 가벼운 코드 작업. 의도 합의 후 워크플
 **컬럼**:
 - **항목**: 분해 단위 1개의 짧은 식별자.
 - **요구**: 1단계 의도파악 합의 내용 인용.
-- **현재 코드 상태**: 코드베이스 조사 결과. 신규는 "없음", 수정은 "있음(어떻게)".
-- **판정**: 없음 / 불일치 / 일치.
-- **매핑 파일**: 작성·갱신될 파일 경로.
-- **의존**: 다른 항목 ID.
+- **현재 코드 상태**: 코드베이스 조사 결과. 신규 작업은 "없음", 기존 수정은 "있음(현재 동작 요약)".
+- **판정**: 없음 / 불일치 / 일치 중 하나.
+- **매핑 파일**: 작성·갱신될 파일의 경로.
+- **의존**: 선행되어야 할 다른 항목의 식별자.
 
 ### 4단계: TDD 사이클
 
-표의 (없음·불일치) 항목만 의존 순서로 진행. 일치 항목은 손대지 않음.
+표에서 판정이 "없음" 또는 "불일치" 인 항목만 의존 순서대로 진행. "일치" 항목은 손대지 않음.
 
-각 작업(= 표 1행) 시작 시 **테스트 작성 가능 여부** 판정 — 입출력 명확 + 외부 의존 통제 가능한가.
+각 작업(표 1행)을 시작할 때 **테스트 작성 가능 여부** 판정 — 입출력이 명확하고 외부 의존을 통제할 수 있는지 여부.
 
 - **테스트 가능**: **RED → GREEN → REFACTOR**.
   - **RED**: 테스트만 작성 → 단위 테스트 실행 → 실패 확인. **이 단계에서 구현 파일 절대 손대지 말 것.**
@@ -68,19 +68,19 @@ spec.md 없이 진행하는 가벼운 코드 작업. 의도 합의 후 워크플
   - **REFACTOR**: 중복·가독성·기존 패턴 정합 정리 → 통과 유지 확인. 정리할 게 없으면 스킵.
 - **테스트 불가/비효율** (UI 시각·외부 서비스 실호출 등): **구현 → REFACTOR**.
 
-**의도 모호 발견 시**: 사이클 중 1단계에서 합의되지 않은 모호함 발견 → 즉시 멈추고 1단계 회귀. 자체 판단 채움 금지.
+**의도 모호 발견 시**: 사이클 진행 중 1단계 의도파악에서 합의되지 않은 모호함을 발견하면 즉시 멈추고 1단계 의도파악으로 회귀. 자체 판단으로 채우기 금지.
 
 ### 5단계: 코드 정리
 
-전체 변경분을 한번 훑어 정돈. 4단계 REFACTOR 가 잡지 못한 횡단 이슈와 작업 잔재가 대상.
+전체 변경분을 한 번 훑어 정돈. 4단계 TDD 사이클의 REFACTOR 단계가 잡지 못한 횡단 이슈와 작업 잔재를 정리 대상으로 함.
 
 - **횡단 중복**: 작업 사이클 사이에 동일 로직이 흩어져 있으면 합치기.
 - **인접 코드 패턴 정합**: 코드베이스 컨벤션 vs 실제 작성 — 파일 위치·네이밍·구조.
-- **불필요한 코드**: 미사용 import·변수·주석, 요구 없는 옵션·추상화 제거. 갱신·덮어쓰기 결과로 어디서도 참조되지 않는 파일도 포함. **단 파일 단위 삭제는 후보 목록을 사용자에게 보고 → 확정분만 삭제** (dynamic import·문서 자산 등 보존분 사용자 제외).
-- **권위 자료 정합**: 2-A 매뉴얼 위반 항목 수정.
+- **불필요한 코드**: 미사용 import·변수·주석, 요구 없는 옵션·추상화 제거. 갱신·덮어쓰기 결과로 어디서도 참조되지 않는 파일도 포함. **단 파일 단위 삭제는 후보 목록을 사용자에게 보고 → 확정된 것만 삭제** (dynamic import·문서 자산 등 보존 대상은 사용자가 제외).
+- **권위 자료 정합**: 2단계 분석 항목 A(라이브러리·개발 매뉴얼)에서 확인한 규약을 위반한 항목 수정.
 
 정리 후 단위 테스트 재실행 — 회귀 없음 확인.
 
 ### 6단계: 검증
 
-산출물이 브라우저 시연이 필요한 화면·UI 면 사용자에게 dev 서버 실행 요청 → 브라우저 자동화 도구로 시연. 그 외(라이브러리·CLI·내부 모듈·서버 함수)는 4단계 단위 테스트 통과로 종결.
+산출물이 브라우저 시연이 필요한 화면·UI 이면 사용자에게 dev 서버 실행을 요청한 뒤 브라우저 자동화 도구로 시연. 그 외(라이브러리·CLI·내부 모듈·서버 함수)는 4단계 TDD 사이클의 단위 테스트 통과로 종결.

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

@@ -1,18 +1,18 @@
 ---
 name: sd-docs
-description: `@simplysm/*` 라이브러리 패키지의 API 문서를 `.claude/references/sd-simplysm14/apis/<패키지명>/` 자리에 사용 트리거 기준으로 산출·갱신. Use when 라이브러리 API 문서를 새로 작성하거나 코드 변경을 반영해 갱신할 때.
+description: `@simplysm/*` 라이브러리 패키지의 API 문서를 `.claude/references/sd-simplysm14/apis/<패키지명>/` 위치에 사용 트리거 기준으로 작성·갱신. Use when 라이브러리 API 문서를 새로 작성하거나 코드 변경을 반영해 갱신할 때.
 effort: "low"
 ---
 
 # sd-docs
 
-`@simplysm/*` 라이브러리 패키지의 API 문서를 코드 진실에 맞춰 산출·갱신함. 메인 에이전트가 패키지 목록 추출과 상위 README 인덱스 갱신을 담당하고, 패키지별 산출은 subagent 1개씩 병렬 위임함.
+`@simplysm/*` 라이브러리 패키지의 API 문서를 코드를 근거로 작성·갱신. 메인 에이전트가 패키지 목록 추출과 상위 README 인덱스 갱신을 담당하고, 패키지별 문서 작성은 패키지 1개당 subagent 1개를 호출해 병렬 위임.
 
-## 산출 자리
+## 산출물 위치
 
 - `.claude/references/sd-simplysm14/apis/<패키지명>/README.md` — 패키지당 1개, 필수.
-- `.claude/references/sd-simplysm14/apis/<패키지명>/<군명>.md` — 사용 트리거 군이 본질적으로 커서 README 한 장에 풀어쓰면 다른 컨텍스트 정보까지 끌려나오는 경우에만 분할 산출.
-- `.claude/references/sd-simplysm14/README.md` 의 "패키지 인덱스" 섹션 — 메인이 자동 갱신.
+- `.claude/references/sd-simplysm14/apis/<패키지명>/<군명>.md` — 사용 트리거 군이 커서 README 한 장에 풀어쓰면 같은 README 의 다른 군 정보까지 함께 읽혀 부담이 커지는 경우에만 분할 산출.
+- `.claude/references/sd-simplysm14/README.md` 의 "패키지 인덱스" 섹션 — 메인 에이전트가 갱신.
 
 ## 워크플로
 
@@ -25,7 +25,7 @@ effort: "low"
 
 ### 2. 패키지별 subagent 병렬 호출
 
-`public 리스트` 의 패키지 수만큼 `general-purpose` subagent 호출을 **단일 메시지 안에서 병렬**로 보냄. 각 호출 프롬프트는 [references/subagent-prompt.md](references/subagent-prompt.md) 의 양식을 그대로 사용하고, `<PACKAGE_NAME>` 과 `<PACKAGE_DIR>` 만 치환함.
+`public 리스트` 의 패키지 수만큼 `general-purpose` subagent 호출을 **단일 메시지 안에서 병렬**로 보냄. 각 호출 프롬프트는 [references/subagent-prompt.md](references/subagent-prompt.md) 양식의 "프롬프트" 마커 아래 본문을 그대로 사용하고, `<PACKAGE_NAME>` 과 `<PACKAGE_DIR>` 만 치환.
 
 각 subagent 의 산출 (풀 재작성 모드 — 기존 파일 참고 없이 처음부터 작성):
 
@@ -33,7 +33,7 @@ effort: "low"
 - 필요 시 `apis/<패키지명>/<군명>.md` 재작성. 코드에서 사라진 군의 파일은 삭제.
 - 결과 보고 1단락 (산출 파일 목록, 분할 발생 여부, 한 줄 트리거 요약).
 
-**범위 한정**: subagent 는 `apis/<패키지명>/` 자리만 다룸. 상위 `.claude/references/sd-simplysm14/README.md` 는 건드리지 않음 (메인 에이전트가 §3 에서 처리).
+**범위 한정**: subagent 는 `apis/<패키지명>/` 위치만 다룸. 상위 `.claude/references/sd-simplysm14/README.md` 는 건드리지 않음 (다음 단계의 "패키지 인덱스 섹션 갱신" 에서 메인 에이전트가 처리).
 
 ### 3. 상위 README 의 "패키지 인덱스" 섹션 갱신 (파일 보존 + 섹션 내 항목만 갱신)
 

package/claude/skills/sd-docs/references/subagent-prompt.md

@@ -1,52 +1,52 @@
 # subagent 호출 프롬프트 (sd-docs)
 
-메인 에이전트가 패키지 1개당 1번씩 `general-purpose` subagent 를 호출할 때 쓰는 프롬프트 양식이다. `<PACKAGE_NAME>` 과 `<PACKAGE_DIR>` 만 치환한다.
+메인 에이전트가 패키지 1개당 1번씩 `general-purpose` subagent 를 호출할 때 쓰는 프롬프트 양식. `<PACKAGE_NAME>` 과 `<PACKAGE_DIR>` 자리만 치환.
 
 ---
 
 ## 프롬프트 (이 마커 아래 전부를 그대로 subagent 에 전달)
 
-너는 `<PACKAGE_NAME>` 패키지(소스 위치: `<PACKAGE_DIR>/src/`)의 API 문서를 작성·갱신하는 subagent 다. 산출 자리는 `.claude/references/sd-simplysm14/apis/<PACKAGE_NAME 의 패키지명 부분>/` 이다(예: `@simplysm/foo` → `apis/foo/`). 아래 규칙을 따라 끝까지 진행한다.
+너는 `<PACKAGE_NAME>` 패키지(소스 위치: `<PACKAGE_DIR>/src/`)의 API 문서를 작성·갱신하는 subagent. 산출 자리는 `.claude/references/sd-simplysm14/apis/<PACKAGE_NAME 의 `@simplysm/` 접두사를 제외한 짧은 이름>/` (예: `@simplysm/foo` → `apis/foo/`). 아래 규칙을 끝까지 따름.
 
 ### 1. 입력 분석
 
-다음만 진실 근거로 사용한다 — 외부 자료·과거 git 기록·다른 패키지 사용처는 보지 않는다.
+다음만 진실 근거로 사용 — 외부 자료·과거 git 기록·다른 패키지의 사용처는 참조 금지.
 
 - `<PACKAGE_DIR>/src/index.ts` 의 export — **entry 시작점**. 여기서 노출된 심볼만 문서 대상.
 - 위 entry 가 재노출하는 각 심볼의 정의 파일(타입 시그니처 + 본문).
-- 위 정의 파일 또는 동일 패키지 안 파일의 JSDoc 주석.
-- `tests/` 디렉토리 중 해당 패키지를 import 해 검증하는 테스트 코드(있을 경우만).
+- 위 정의 파일 또는 동일 패키지 안의 다른 파일에 달린 JSDoc 주석.
+- `tests/` 디렉토리 중 해당 패키지를 import 해 검증하는 테스트 코드 (존재할 경우에만).
 
-타입 시그니처에서 직접 드러나지 않는 사용 패턴이 필요하면 위 4개 소스 안에서만 추론한다.
+타입 시그니처에서 직접 드러나지 않는 사용 패턴을 보강해야 하면 위 4개 소스 안에서만 추론.
 
 ### 2. 사용 트리거 군 분류
 
-entry 의 export 심볼들을 "한 작업 컨텍스트에서 함께 참조될 군"으로 묶는다. 예: 에러 처리 군, 값 타입 군, 큐/이벤트 군. 분류 기준은 폴더 구조나 심볼 종류가 아니라 **사용 시점**(언제 같이 읽힐 것인가)이다.
+entry 의 export 심볼들을 "한 작업 컨텍스트에서 함께 참조될 군"으로 묶음. 예: 에러 처리 군, 값 타입 군, 큐/이벤트 군. 분류 기준은 폴더 구조나 심볼 종류가 아니라 **사용 시점**(언제 같이 읽힐 것인가) 기준.
 
-군이 모호하거나 작아 트리거가 1~2개뿐인 심볼은 별도 군 만들지 말고 README 의 공통 인라인 항목에 둔다.
+군이 모호하거나 작아 트리거가 1~2개뿐인 심볼은 별도 군을 만들지 말고 README 의 공통 인라인 섹션에 배치.
 
 ### 3. 산출 단위 판정
 
-기본은 `README.md` 1장. 다음 조건을 **모두** 만족하는 군만 별도 `<군명>.md` 로 분할한다.
+기본은 `README.md` 1장. 다음 조건을 **모두** 만족하는 군만 별도 `<군명>.md` 로 분할.
 
-- 그 군의 사용법·주의사항을 README 에 풀어쓰면, 다른 컨텍스트 정보까지 같이 끌려나와 다른 작업 시점에서 읽는 부담이 커진다.
-- 그 군 단독으로 사용 예·시그니처·주의 8줄 이상 필요하다.
+- 해당 군의 사용법·주의사항을 README 에 풀어쓰면, 무관한 다른 컨텍스트 정보까지 같이 끌려나와 다른 작업 시점에서 읽기 부담이 커지는 경우.
+- 해당 군 단독으로 사용 예·시그니처·주의가 합쳐 8줄 이상 필요한 경우.
 
-위를 만족하지 않으면 README 안에 머무른다.
+위 조건을 만족하지 않으면 README 안에 유지.
 
 ### 4. 풀 재작성 모드 (범위: `apis/<패키지명>/` 자리만)
 
-- 기존 `apis/<패키지명>/README.md` 와 분할 `<군명>.md` 가 있어도 **참고하지 않고 처음부터 작성**한다. 코드 + 본 프롬프트 형식 룰(§5·§6·§7) 만을 진실 근거로 삼는다.
-- 기존 파일 내용·표현 보존 시도 금지. 룰 변경(예: 식별자 풀이 의무) 이 자동 반영되도록 매 호출마다 패키지별 산출물(README + 분할 `<군명>.md`)을 다시 만든다.
-- 결과적으로 코드가 안 바뀐 패키지도 표현이 달라질 수 있다 — 정상.
-- 코드에서 사라진 군의 분할 파일은 삭제한다.
-- **범위 밖**: 상위 `.claude/references/sd-simplysm14/README.md` 는 절대 건드리지 않는다 (메인 에이전트가 인덱스 섹션 항목만 갱신, subagent 와 무관).
+- 기존 `apis/<패키지명>/README.md` 와 분할 `<군명>.md` 가 있어도 **참고하지 않고 처음부터 작성**. 코드 + 본 프롬프트의 형식 룰(아래 README 형식 섹션·분할 .md 형식 섹션·작성 원칙 섹션) 만을 진실 근거로 삼음.
+- 기존 파일 내용·표현 보존 시도 금지. 룰 변경(예: 식별자 풀이 의무) 이 자동 반영되도록 매 호출마다 패키지별 산출물(README + 분할 `<군명>.md`) 을 다시 작성.
+- 결과적으로 코드가 변경되지 않은 패키지도 표현이 달라질 수 있음 — 정상.
+- 코드에서 사라진 군의 분할 파일은 삭제.
+- **범위 밖**: 상위 `.claude/references/sd-simplysm14/README.md` 는 건드리지 말 것 (메인 에이전트가 인덱스 섹션 항목만 갱신, subagent 와 무관).
 
 ### 5. README.md 형식
 
-각 패키지의 `apis/<패키지명>/README.md` 는 다음 구조를 따른다.
+각 패키지의 `apis/<패키지명>/README.md` 는 다음 구조를 따름.
 
-H1 은 `# @simplysm/<short-name>` 형식으로 고정한다 (예: `# @simplysm/foo`).
+H1 은 `# @simplysm/<short-name>` 형식으로 고정 (예: `# @simplysm/foo`).
 
 ```markdown
 # @simplysm/<short-name>
@@ -60,9 +60,9 @@ H1 은 `# @simplysm/<short-name>` 형식으로 고정한다 (예: `# @simplysm/f
 
 ## <인라인 군 이름 1>
 
-각 심볼별 짧은 시그니처 + 옵션/prop/필드/enum literal 1줄 풀이 + 즉시 사용 가능한 사용법. 본질적으로 큰 군이라 분할된 경우 이 섹션은 없고, 위 인덱스에서 `자세히:` 링크로 안내한다.
+각 심볼별로 짧은 시그니처 + 옵션·prop·필드·enum literal(열거형 리터럴 값) 1줄 풀이 + 즉시 사용 가능한 사용법을 작성. 본질적으로 큰 군이라 분할된 경우 이 섹션은 두지 않고, 위 인덱스에서 `자세히:` 링크로 안내.
 
-**식별자 풀이 의무**: 시그니처에 나오는 옵션·prop·필드·enum literal 각각에 1줄 풀이를 단다. 풀이 = `<무엇을 함>` + (enum/boolean 이면) `<값별 동작 차이>` + `<언제 쓰는지 단서 1조각>`. 이름만 나열은 금지.
+**식별자 풀이 의무**: 시그니처에 나오는 옵션·prop·필드·enum literal 각각에 1줄 풀이 부착. 풀이 구성 = `<무엇을 함>` + (enum/boolean 인 경우) `<값별 동작 차이>` + `<언제 쓰는지 단서 1조각>`. 이름만 나열하는 형식 금지.
 
 예 (나쁨/좋음):
 
@@ -83,9 +83,9 @@ inputs: selectMode, autoSelect: "click"|"focus", useAutoSort, focusMode: "row"|"
 
 ### 6. 분할 .md 형식
 
-`<군명>.md` 는 다음 구조.
+`<군명>.md` 는 다음 구조를 따름.
 
-분할 `.md` 의 H1 도 동일 형식 + 군명을 붙인다: `# @simplysm/<short-name> — <군명>`.
+분할 `.md` 의 H1 도 동일 형식 + 군명을 붙임: `# @simplysm/<short-name> — <군명>`.
 
 ```markdown
 # @simplysm/<short-name> — <군명>
@@ -94,7 +94,7 @@ inputs: selectMode, autoSelect: "click"|"focus", useAutoSort, focusMode: "row"|"
 
 ## <심볼>
 
-시그니처, 옵션/prop/필드/enum literal 1줄 풀이(위 §5 "식별자 풀이 의무" 동일 적용), 사용 예, 주의사항.
+시그니처, 옵션·prop·필드·enum literal 1줄 풀이(위 README 형식 섹션의 "식별자 풀이 의무" 와 동일 적용), 사용 예, 주의사항.
 
 ## <심볼>
 ...
@@ -102,17 +102,17 @@ inputs: selectMode, autoSelect: "click"|"focus", useAutoSort, focusMode: "row"|"
 
 ### 7. 작성 원칙
 
-- 산출물 소비자는 Claude 에이전트다. 사람 가독성보다 에이전트가 즉시 따를 수 있는 간결·명확성이 우선.
-- **코드 본문에 드러난 동작은 JSDoc 없어도 적는다**. 옵션·prop·필드·enum literal 의 동작을 본문(분기·기본값·사용처)에서 추론해 풀이. 단, 본문에서 확인 불가한 외부 추측·미검증 동작은 금지.
-- **식별자만 나열 금지** — 위 §5·§6 "식별자 풀이 의무" 강제. 이름 콤마 나열로 끝내지 않는다. 자명해 보여도 enum literal 의 값별 동작, boolean 의 토글 효과, 함수형 prop 의 호출 시점은 반드시 풀이.
-- 사용 예는 실제 호출 코드 형태로 1~3줄, 군마다 1개 정도.
+- 산출물의 소비자는 Claude 에이전트. 사람 가독성보다 에이전트가 즉시 따를 수 있는 간결·명확성이 우선.
+- **코드 본문에 드러난 동작은 JSDoc 이 없어도 기재**. 옵션·prop·필드·enum literal 의 동작을 본문(분기·기본값·사용처) 에서 추론해 풀이. 단, 본문에서 확인 불가한 외부 추측·미검증 동작은 기재 금지.
+- **식별자만 나열 금지** — 위 README 형식 섹션·분할 .md 형식 섹션의 "식별자 풀이 의무" 강제. 이름을 콤마로 나열하고 끝내지 말 것. 자명해 보여도 enum literal 의 값별 동작, boolean 의 토글 효과, 함수형 prop 의 호출 시점은 반드시 풀이.
+- 사용 예는 실제 호출 코드 형태로 1~3줄 분량, 군마다 1개 가량.
 - 분량을 늘리기 위한 부연·중복·꾸밈 금지. 단, 식별자 풀이는 "분량 늘리기" 가 아니라 필수 정보로 취급 — 풀이 생략을 통한 분량 절약 금지.
 
 ### 8. 산출 보고
 
-작성/갱신을 마치면 호출자(메인)에게 다음을 1단락으로 보고한다.
+작성·갱신을 마치면 호출자(메인 에이전트) 에게 다음 항목을 1단락으로 보고.
 
-- 신규 작성인지 갱신인지.
-- 산출/갱신한 파일 목록(README 외 분할 .md 포함).
-- 패키지 한 줄 트리거 요약(메인이 상위 README 인덱스에 쓸 문장).
-- 삭제한 파일(있다면).
+- 신규 작성인지 갱신인지 구분.
+- 산출·갱신한 파일 목록 (README 와 분할 `.md` 모두 포함).
+- 패키지의 한 줄 트리거 요약 (메인 에이전트가 상위 README 인덱스에 옮겨 적을 문장).
+- 삭제한 파일이 있으면 그 목록.