@simplysm/sd-claude 14.0.65 → 14.0.66

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

@@ -0,0 +1,53 @@
+---
+name: sd-docs
+description: `@simplysm/*` 라이브러리 패키지의 API 문서를 `.claude/references/sd-simplysm14/apis/<패키지명>/` 자리에 사용 트리거 기준으로 산출·갱신한다. Use when 라이브러리 API 문서를 새로 작성하거나 코드 변경을 반영해 갱신할 때.
+effort: "low"
+---
+
+# sd-docs
+
+`@simplysm/*` 라이브러리 패키지의 API 문서를 코드 진실에 맞춰 산출·갱신한다. 메인 에이전트가 패키지 목록 추출과 상위 README 인덱스 갱신을 담당하고, 패키지별 산출은 subagent 1개씩 병렬 위임한다.
+
+## 산출 자리
+
+- `.claude/references/sd-simplysm14/apis/<패키지명>/README.md` — 패키지당 1개, 필수.
+- `.claude/references/sd-simplysm14/apis/<패키지명>/<군명>.md` — 사용 트리거 군이 본질적으로 커서 README 한 장에 풀어쓰면 다른 컨텍스트 정보까지 끌려나오는 경우에만 분할 산출.
+- `.claude/references/sd-simplysm14/README.md` 의 "패키지 인덱스" 섹션 — 메인이 자동 갱신.
+
+## 워크플로
+
+### 1. 패키지 목록 추출
+
+워크스페이스 루트의 `packages/*/package.json` 을 모두 읽어 다음 두 리스트를 만든다.
+
+- **public 리스트**: `private: true` 가 아닌 패키지. 각 항목 = `{ name, dir }`.
+- **private 리스트**: `private: true` 인 패키지. 인덱스에서 제외하기 위해 보관.
+
+### 2. 패키지별 subagent 병렬 호출
+
+`public 리스트` 의 패키지 수만큼 `general-purpose` subagent 호출을 **단일 메시지 안에서 병렬**로 보낸다. 각 호출 프롬프트는 [references/subagent-prompt.md](references/subagent-prompt.md) 의 양식을 그대로 사용하고, `<PACKAGE_NAME>` 과 `<PACKAGE_DIR>` 만 치환한다.
+
+각 subagent 의 산출:
+
+- `apis/<패키지명>/README.md` 신규 작성 또는 코드 변경 반영 갱신.
+- 필요 시 `apis/<패키지명>/<군명>.md` 추가/갱신.
+- 결과 보고 1단락 (산출/갱신 파일 목록, 분할 발생 여부, 한 줄 트리거 요약).
+
+### 3. 상위 README 의 "패키지 인덱스" 섹션 갱신
+
+모든 subagent 완료 후 `.claude/references/sd-simplysm14/README.md` 의 "패키지 인덱스" 섹션을 통째로 재구성한다.
+
+- **항목 형식**: `- **<패키지명>** — <한 줄 트리거 요약>. 자세히: [apis/<패키지명>/README.md](./apis/<패키지명>/README.md)`
+- **순서**: 패키지명 알파벳순.
+- **포함**: `public 리스트` 만.
+- **제외**: `private 리스트` 의 패키지, 코드베이스에 더 이상 존재하지 않는 패키지.
+- 섹션 머리(`## 패키지 인덱스`)와 다른 섹션은 건드리지 않는다.
+
+### 4. 사용자 보고
+
+다음 항목을 짧게 정리해 출력한다.
+
+- 신규 작성된 패키지 목록.
+- 갱신된 패키지 목록.
+- 분할 발생(추가 `.md` 가 생긴) 패키지 목록.
+- 인덱스에서 제거된 항목 (있다면).

package/claude/skills/sd-docs/evals/fixtures/new-write/.claude/references/sd-simplysm14/README.md

@@ -0,0 +1,7 @@
+# @simplysm/* v14 행동 지침
+
+(eval fixture — 미니 README)
+
+## 패키지 인덱스
+
+(비어 있음 — sd-docs 가 채워야 함)

package/claude/skills/sd-docs/evals/fixtures/new-write/packages/bar/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@simplysm/bar",
+  "version": "14.0.0",
+  "type": "module"
+}

package/claude/skills/sd-docs/evals/fixtures/new-write/packages/bar/src/index.ts

@@ -0,0 +1,3 @@
+export function barSum(a: number, b: number): number {
+  return a + b;
+}

package/claude/skills/sd-docs/evals/fixtures/new-write/packages/baz/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@simplysm/baz",
+  "version": "14.0.0",
+  "type": "module",
+  "private": true
+}

package/claude/skills/sd-docs/evals/fixtures/new-write/packages/baz/src/index.ts

@@ -0,0 +1 @@
+export const BAZ_SECRET = "internal-only";

package/claude/skills/sd-docs/evals/fixtures/new-write/packages/foo/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@simplysm/foo",
+  "version": "14.0.0",
+  "type": "module"
+}

package/claude/skills/sd-docs/evals/fixtures/new-write/packages/foo/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Foo 패키지의 표준 인사 클래스.
+ */
+export class FooGreeter {
+  hello(name: string): string {
+    return `hello, ${name}`;
+  }
+}

package/claude/skills/sd-docs/evals/fixtures/update-mixed/.claude/references/sd-simplysm14/README.md

@@ -0,0 +1,7 @@
+# @simplysm/* v14 행동 지침
+
+(eval fixture — 미니 README, 갱신 케이스)
+
+## 패키지 인덱스
+
+- **foo** — OLD_INDEX_PLACEHOLDER_MUST_BE_REWRITTEN

package/claude/skills/sd-docs/evals/fixtures/update-mixed/.claude/references/sd-simplysm14/apis/foo/README.md

@@ -0,0 +1,3 @@
+# @simplysm/foo
+
+OLD_FOO_DOC_PLACEHOLDER_MUST_BE_REWRITTEN

package/claude/skills/sd-docs/evals/fixtures/update-mixed/packages/bar/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@simplysm/bar",
+  "version": "14.0.0",
+  "type": "module"
+}

package/claude/skills/sd-docs/evals/fixtures/update-mixed/packages/bar/src/index.ts

@@ -0,0 +1,3 @@
+export function barSum(a: number, b: number): number {
+  return a + b;
+}

package/claude/skills/sd-docs/evals/fixtures/update-mixed/packages/baz/package.json

@@ -0,0 +1,6 @@
+{
+  "name": "@simplysm/baz",
+  "version": "14.0.0",
+  "type": "module",
+  "private": true
+}

package/claude/skills/sd-docs/evals/fixtures/update-mixed/packages/baz/src/index.ts

@@ -0,0 +1 @@
+export const BAZ_SECRET = "internal-only";

package/claude/skills/sd-docs/evals/fixtures/update-mixed/packages/foo/package.json

@@ -0,0 +1,5 @@
+{
+  "name": "@simplysm/foo",
+  "version": "14.0.0",
+  "type": "module"
+}

package/claude/skills/sd-docs/evals/fixtures/update-mixed/packages/foo/src/index.ts

@@ -0,0 +1,8 @@
+/**
+ * Foo 패키지의 표준 인사 클래스.
+ */
+export class FooGreeter {
+  hello(name: string): string {
+    return `hello, ${name}`;
+  }
+}

package/claude/skills/sd-docs/evals/golden.jsonl

@@ -0,0 +1,2 @@
+{"id":"new-write","input":"/sd-docs","fixture":"new-write","rubric":["샌드박스 종료 시점 트리에 `.claude/references/sd-simplysm14/apis/foo/README.md` 파일이 존재하는가?","샌드박스 종료 시점 트리에 `.claude/references/sd-simplysm14/apis/bar/README.md` 파일이 존재하는가?","샌드박스 종료 시점 트리에 `.claude/references/sd-simplysm14/apis/baz/` 경로(`baz` 패키지 산출물)가 전혀 존재하지 않는가?","`.claude/references/sd-simplysm14/README.md` 본문에 `apis/foo` 를 가리키는 링크와 `apis/bar` 를 가리키는 링크가 모두 포함되었는가?","`.claude/references/sd-simplysm14/README.md` 본문에 `baz` 패키지가 패키지 인덱스 항목으로 노출되지 않는가?","`.claude/references/sd-simplysm14/apis/foo/README.md` 의 첫 줄(H1)이 정확히 `# @simplysm/foo` 문자열인가?"]}
+{"id":"update-mixed","input":"/sd-docs","fixture":"update-mixed","rubric":["`.claude/references/sd-simplysm14/apis/foo/README.md` 파일 내용에 `OLD_FOO_DOC_PLACEHOLDER_MUST_BE_REWRITTEN` 문자열이 포함되지 않는가?","샌드박스 종료 시점 트리에 `.claude/references/sd-simplysm14/apis/bar/README.md` 파일이 존재하는가?","샌드박스 종료 시점 트리에 `.claude/references/sd-simplysm14/apis/baz/` 경로가 전혀 존재하지 않는가?","`.claude/references/sd-simplysm14/README.md` 본문에 `OLD_INDEX_PLACEHOLDER_MUST_BE_REWRITTEN` 문자열이 포함되지 않는가?","`.claude/references/sd-simplysm14/README.md` 본문에 `apis/bar` 를 가리키는 링크가 포함되었는가?","`.claude/references/sd-simplysm14/apis/bar/README.md` 의 첫 줄(H1)이 정확히 `# @simplysm/bar` 문자열인가?"]}

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

@@ -0,0 +1,100 @@
+# subagent 호출 프롬프트 (sd-docs)
+
+메인 에이전트가 패키지 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/`). 아래 규칙을 따라 끝까지 진행한다.
+
+### 1. 입력 분석
+
+다음만 진실 근거로 사용한다 — 외부 자료·과거 git 기록·다른 패키지 사용처는 보지 않는다.
+
+- `<PACKAGE_DIR>/src/index.ts` 의 export — **entry 시작점**. 여기서 노출된 심볼만 문서 대상.
+- 위 entry 가 재노출하는 각 심볼의 정의 파일(타입 시그니처 + 본문).
+- 위 정의 파일 또는 동일 패키지 안 파일의 JSDoc 주석.
+- `tests/` 디렉토리 중 해당 패키지를 import 해 검증하는 테스트 코드(있을 경우만).
+
+타입 시그니처에서 직접 드러나지 않는 사용 패턴이 필요하면 위 4개 소스 안에서만 추론한다.
+
+### 2. 사용 트리거 군 분류
+
+entry 의 export 심볼들을 "한 작업 컨텍스트에서 함께 참조될 군"으로 묶는다. 예: 에러 처리 군, 값 타입 군, 큐/이벤트 군. 분류 기준은 폴더 구조나 심볼 종류가 아니라 **사용 시점**(언제 같이 읽힐 것인가)이다.
+
+군이 모호하거나 작아 트리거가 1~2개뿐인 심볼은 별도 군 만들지 말고 README 의 공통 인라인 항목에 둔다.
+
+### 3. 산출 단위 판정
+
+기본은 `README.md` 1장. 다음 조건을 **모두** 만족하는 군만 별도 `<군명>.md` 로 분할한다.
+
+- 그 군의 사용법·주의사항을 README 에 풀어쓰면, 다른 컨텍스트 정보까지 같이 끌려나와 다른 작업 시점에서 읽는 부담이 커진다.
+- 그 군 단독으로 사용 예·시그니처·주의 8줄 이상 필요하다.
+
+위를 만족하지 않으면 README 안에 머무른다.
+
+### 4. 기존 문서 확인 (신규/갱신 자동 판단)
+
+- `apis/<패키지명>/README.md` 가 이미 존재하면: 기존 내용 읽고 코드 현재 상태와 차이만 메운다. 기존 손편집 표현 가능한 한 보존, 단 코드와 모순되면 코드 진실 우선.
+- 존재하지 않으면: 처음부터 작성.
+- 기존 `<군명>.md` 들도 동일 원칙. 코드에서 사라진 군의 파일은 삭제한다.
+
+### 5. README.md 형식
+
+각 패키지의 `apis/<패키지명>/README.md` 는 다음 구조를 따른다.
+
+H1 은 `# @simplysm/<short-name>` 형식으로 고정한다 (예: `# @simplysm/foo`).
+
+```markdown
+# @simplysm/<short-name>
+
+<패키지 한 줄 개요>
+
+## 사용 트리거 인덱스
+
+- **<심볼 또는 군 이름>** — <언제·어떤 작업에서 쓰는지 1줄>. (분할된 군이면 `자세히: [<군명>.md](./<군명>.md)`)
+- ...
+
+## <인라인 군 이름 1>
+
+각 심볼별 짧은 시그니처 + 즉시 사용 가능한 사용법 (3~6줄). 본질적으로 큰 군이라 분할된 경우 이 섹션은 없고, 위 인덱스에서 `자세히:` 링크로 안내한다.
+
+## <인라인 군 이름 2>
+...
+```
+
+### 6. 분할 .md 형식
+
+`<군명>.md` 는 다음 구조.
+
+분할 `.md` 의 H1 도 동일 형식 + 군명을 붙인다: `# @simplysm/<short-name> — <군명>`.
+
+```markdown
+# @simplysm/<short-name> — <군명>
+
+<군 개요 1~2줄: 언제 같이 읽히는 묶음인지>
+
+## <심볼>
+
+시그니처, 사용 예, 주의사항.
+
+## <심볼>
+...
+```
+
+### 7. 작성 원칙
+
+- 산출물 소비자는 Claude 에이전트다. 사람 가독성보다 에이전트가 즉시 따를 수 있는 간결·명확성이 우선.
+- 코드에서 드러나지 않는 동작은 적지 않는다.
+- 사용 예는 실제 호출 코드 형태로 1~3줄, 군마다 1개 정도.
+- 분량을 늘리기 위한 부연·중복·꾸밈 금지.
+
+### 8. 산출 보고
+
+작성/갱신을 마치면 호출자(메인)에게 다음을 1단락으로 보고한다.
+
+- 신규 작성인지 갱신인지.
+- 산출/갱신한 파일 목록(README 외 분할 .md 포함).
+- 패키지 한 줄 트리거 요약(메인이 상위 README 인덱스에 쓸 문장).
+- 삭제한 파일(있다면).

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

@@ -1,67 +1,146 @@
 ---
 name: sd-impl
-description: plan.md를 따라 실제 코드를 작성하고 변경 결과를 impl.md로 기록하는 스킬. Use when plan 단계 후 실제 구현이 필요할 때 (human-in-the-loop, 평소 자동·막힘 시만 사용자 개입)
+description: spec.md 화면 1개를 현재 코드베이스 상태와 비교해 차이만큼 풀 구현(테스트·시연 포함)한다. Use when "화면 풀 구현", "데모를 실 구현으로", "화면 실가동" 을 요청할 때.
 ---
 
-# implement 단계
+# sd-impl
 
-plan.md 따라 코드 작성. 평소 자동, 막힘 시만 사용자 개입(human-in-the-loop).
-**커밋 안 함** (사용자 정책 — 병렬 작업 충돌 방지).
+spec.md 화면 1개를 현재 코드베이스 상태와 비교해 빠지거나 어긋난 부분만큼 풀 구현한다. 데모 골격이 있으면 보존, 도메인 모델·서버 함수·화면 로직·테스트는 차이가 있을 때만 신규/갱신. 끝에 사용자 시연으로 회귀를 잡는다.
 
-## 산출물
+## 본질
 
-```
-.specs/{yyMMdd_HHmmss}/REQ-XXX-슬러그/
-  spec.md / plan.md   ← 입력
-  impl.md             ← 본 단계 산출물
-+ 코드 변경 (uncommitted)
-```
+- **차이만 작업**: 현재 상태와 spec 목표를 (없음 / 불일치 / 일치) 3분류로 판정. 일치 항목은 손대지 않는다.
+- **YAGNI 구현**: spec 에 없는 기능·옵션·추상화 추가 금지.
+- **환경 무관**: framework 처방을 본문에 박지 않는다. 코드베이스의 매뉴얼·답습 화면·테스트 환경은 발견되면 따르고, 없으면 표준 패턴으로 진행.
 
 ## 워크플로
 
-1. 입력: 대상 REQ ID
+### 1단계: 입력 확보
 
-2. 읽기: plan.md + spec.md + 코드베이스
+호출에 다음 필요:
 
-3. plan.md 권장 순서대로 R 단위 순차 진행 (병렬 X)
+- 대상 spec.md 경로
+- 구현할 화면 식별자 — `[화면.X]` 또는 §4.x
 
-4. 각 R마다 (자동 진행, 사용자 개입 X):
-   - 모드별 표준 흐름 적용 (TDD/사후/생략) — [references/modes-and-failure.md](references/modes-and-failure.md)
-   - **R 끝마다 검증**: 타입체크 + 린트(+fix) + 테스트 (해당 R + 전체 회귀). 빌드는 별도 X (타입체크 + 린트로 갈음).
-   - 모두 통과 → impl.md 갱신 (템플릿: [references/impl-md-template.md](references/impl-md-template.md)) → 다음 R
-   - 하나라도 실패 → 막힘 처리 ([references/modes-and-failure.md](references/modes-and-failure.md))
+없으면 묻기. spec.md 에 식별자 매칭이 안 되면 §4 화면 목록 표에서 후보 제시 후 확정.
 
-5. 모든 R `완료` 도달 → **impl.md 전체 재검토** (R별 변경/테스트/차이/의도 정합성 / plan 대비 누락 / 막힘·보류 잔존 여부 / 회귀 검증 누락) → 신규 이슈 발견 시 해당 R 재진입 → 재검토 후에도 이슈 0개 → **역방향 문서(overview, spec, demo, plan) 검토** → 신규 모순/수정 발견 시 해당 R 재진입 → 정합성 OK → **결과 보고** → 메타 `상태: implemented` 전환
-   - 보고: 안내 텍스트라 별도 사용자 승인 게이트 X.
+### 2단계: spec §4.x 분석
 
-## R 진행 상태 (impl.md)
+§4.x 에서 추출:
 
-| 상태 | 의미 |
-|---|---|
-| 진행중 | 현재 작업 중 |
-| 완료 | 검증 통과, impl.md 갱신됨 |
-| 막힘 | 자동 시도 후 미해결, 사용자 Q |
-| 보류 | plan 모순으로 plan 재진입 필요 |
+- 헤더 인덱스(Actor · 관련 섹션 · 장치)
+- 기능 개요 · 와이어프레임 · 항목표 · 동작 · 도메인 규칙(해당 시)
+- §4.x 가 참조하는 도메인 모델(§7.x), 자동 처리(§5.x), 외부 인터페이스(§8.x), 공통 정의(§6.x)
 
-종료 시점엔 모든 R `완료` 상태. 막힘/보류는 모두 해소되어야.
+### 3단계: 외부 입력 점검 (BLOCKING)
 
-## 핵심 원칙
+작업 대상 §4.x 와 그가 참조하는 §5/§6/§7/§8 항목에서 점검 (이 화면이 쓰지 않는 다른 섹션은 무관):
 
-- self-contained 블록 (R 블록 안에 변경/테스트/차이/의도 인라인)
-- raw input 불변
-- ID 불변
-- 자동 판단 금지 (모드 변경/스킵 등)
-- **human-in-the-loop** (다이얼로그 루프 X, 막힘 시만 Q)
+- **헤더 `[OPEN: 날짜]` 섹션**: 본문이 재분석용 포인터일 뿐 임의안 부재 → sd-impl 해소 불가. 사용자에게 보고 후 **종료**. 사용자가 sd-spec 으로 확정 받은 뒤 sd-impl 재호출.
+- **본문 인라인 `[OPEN]`**: `sd-base-rules` "결정 근거" 적용 — 근거 없으면 1건씩 질문. 답변 후 즉시 spec.md 반영(아래 "spec.md 동기화") → 다음 건. 단, 결정이 다른 섹션의 구조 변경(필드 추가, 새 규칙 항목 등)까지 요구하면 헤더 OPEN 과 동일 처리: 종료 후 사용자 보고 + sd-spec 재호출. 종료 전에 다음을 식별·보고:
+  - sd-spec 에 넘길 변경 항목 (§ 위치 + 변경 내용)
+  - 그 변경이 영향 미치는 **다른 §4.x 화면 목록** — 구조 변경된 §5/§6/§7/§8 항목을 spec 에서 역인용해 참조 §4.x 수집. sd-spec 확정 후 sd-impl 재호출 대상.
+  - 영향 §4.x 중 이미 구현된 것 / 미구현인 것 구분 (이미 구현분은 재구현 필요, 미구현분은 향후 sd-impl 첫 호출 시점에 자연 반영).
+- **사용자 제공 예정 자료**: spec 본문에 "사용자 제공 예정" 류로 적힌 파일·값(디자인 시안, 샘플 데이터, 외부 API 명세, 자격증명 등). 사용자에게 요청 후 회신분으로 다음 건.
 
-## 안티패턴
+### 4단계: 보조 자료 수집 (있다면 활용)
 
-- ❌ 커밋 시도 (사용자 정책 위반)
-- ❌ implement 단독으로 R 스킵/dropped 결정 (spec/plan 수준)
-- ❌ R별 사용자 확인 받기 (human-in-the-loop 위반)
-- ❌ 검증 생략하고 다음 R 진행
-- ❌ 자동 시도 무한 반복 (N=2 정책)
-- ❌ 막힘 시 임의 우회 (사용자 확인 없이)
-- ❌ plan.md / spec.md 직접 수정 (plan 재진입 절차)
-- ❌ 라인 번호 기반 변경 위치 표기
-- ❌ 모든 R 완료 직후 impl.md 전체 재검토 없이 implemented 전환
-- ❌ 역방향 검토 없이 implemented 전환
+다음 셋은 발견되면 그 패턴을 따르고, 없으면 LLM 의 일반 지식으로 표준 패턴 채택해 그냥 진행한다. **부재로 워크플로를 멈추지 않는다.**
+
+**A. 라이브러리/개발 매뉴얼**
+
+코드베이스에 권위 규약/매뉴얼 문서가 있으면 1순위로 따른다.
+
+- `@simplysm/*` 14.x 사용 시 — [.claude/references/sd-simplysm14/README.md](../../references/sd-simplysm14/README.md) Read 후 "개발 매뉴얼" 항목 진입.
+- 그 외 framework 는 코드베이스 안의 동등 위치 문서를 찾아 Read.
+- 없으면 흔한 표준(예: TypeScript + 흔한 테스트 러너) 으로 채택.
+
+**B. 답습 풀구현 후보**
+
+도메인/구성이 유사한 이미 풀 구현된 화면이 코드베이스에 있으면 그 패턴(파일 위치·이름 규약·모델 정의·데이터 접근/저장·테스트 작성) 을 답습.
+
+1. 후보 2~3개 추리기. 도메인 영역이 같으면 우선.
+2. 사용자에게 후보 목록 제시 후 1회 질문 — "이 중 답습할 화면 선택 부탁".
+3. 사용자 확정분 1개 Read.
+
+후보 0건이면 답습 없이 진행.
+
+**C. 테스트 환경**
+
+코드베이스의 단위 테스트 프로젝트 구분·실행 명령·mocking 패턴·dev 서버 실행 명령을 파악. 없으면 흔한 조합으로 진행.
+
+### 5단계: 차이 식별
+
+분석 자료 기준으로 spec §4.x 가 요구하는 산출물 목록을 만들고, 현재 코드베이스의 각 항목을 (없음 / 불일치 / 일치) 3분류로 판정.
+
+전형 산출물: 도메인 모델, 데이터 접근 코드, 서버 함수(보안·네이티브 사유 시), 화면 컴포넌트, 라우팅·메뉴 등록, 단위 테스트.
+
+**일치 항목은 손대지 않는다.** 차이는 갱신·덮어쓰기·신규 추가로 처리. 이 단계에서는 삭제하지 않는다 — 미참조 잔재 정리는 9단계에서 일괄.
+
+### 6단계: 계획
+
+(없음 / 불일치) 항목을 작업 단위 목록으로 정리. 의존 관계 표시 (예: 모델 → 데이터 접근 → 화면). 작업 추적 도구가 있으면 활용한다(필수 아님).
+
+### 7단계: 각 작업 사이클
+
+각 작업 시작 시 **테스트 작성 가능 여부** 판정. 4-C 의 테스트 환경 이용.
+
+판정 기준: "테스트 환경이 이미 존재 + 작성 비용 대비 회귀 방지 가치".
+
+- **테스트 가능** — 입출력 명확 + 외부 의존 통제 가능 (도메인 로직·계산·변환·서버 함수·데이터 접근 헬퍼).
+  사이클: **RED → GREEN → REFACTOR**
+  - **RED**: 테스트만 작성 → 테스트 러너 실행 → 실패(또는 대상 미존재) 확인. **이 단계에서 구현 파일 절대 손대지 말 것.** 실패를 눈으로 본 뒤에만 GREEN 진입.
+  - **GREEN**: 테스트가 통과하는 **최소** 구현만 (YAGNI) → 러너 재실행 → 통과 확인.
+  - **REFACTOR**: 중복·가독성·기존 패턴 정합 정리 → 러너 재실행 → 통과 유지 확인. 정리할 게 없으면 스킵.
+- **테스트 불가/비효율** — UI 시각·인터랙션, 외부 서비스 실호출, 환경 의존 코드.
+  사이클: **구현 → REFACTOR**
+  - **구현**: YAGNI 로 작성. 동작 검증은 10단계 시연으로 미룬다.
+  - **REFACTOR**: 위와 동일. 정리할 게 없으면 스킵.
+
+### 8단계: spec 대조
+
+시연 진입 전, spec §4.x 요구가 실제 구현·테스트에 다 들어갔는지 self-check.
+
+대조 대상:
+
+- 5단계에서 뽑은 산출물 목록 — 전부 작업 완료 상태인지
+- §4.x 본문의 와이어프레임·항목표·동작·도메인 규칙 — 항목 단위로 누락 여부 (와이어프레임은 컴포넌트 구조 대 레이아웃 매핑 수준에서 대조)
+- §4.x 가 참조하는 §5(자동 처리)·§6(공통)·§7(도메인 모델)·§8(외부 인터페이스) 항목 — 구현 반영 여부
+
+누락·불일치 발견 시 해당 작업으로 돌아가 7단계 사이클 재수행. 전부 일치 확인된 뒤에만 다음 단계.
+
+### 9단계: 코드 정리
+
+전체 변경분을 한번 훑어 정돈. 7단계 REFACTOR 가 잡지 못한 횡단 이슈와 작업 잔재가 대상.
+
+- **횡단 중복**: 작업 사이클 사이에 동일 로직이 흩어져 있으면 합치기.
+- **답습 패턴 재확인**: 4-B 에서 채택한 화면 vs 실제 작성 — 파일 위치·네이밍·구조 정합.
+- **불필요한 코드**: 미사용 import·변수·주석, 요구 없는 옵션·추상화 제거. 7단계 갱신·덮어쓰기 결과로 어디서도 참조되지 않는 파일도 포함 (검사 범위는 화면 스코프 넘어 전체 워크스페이스). **단 파일 단위 삭제는 후보 목록을 사용자에게 보고 → 확정분만 삭제** (dynamic import·마이그레이션·문서 자산 등 보존분 사용자 제외).
+- **매뉴얼 권위 규약**: 4-A 에서 Read 한 매뉴얼(@simplysm/* 면 sd-simplysm14) 위반 항목 수정.
+
+정리 후 단위 테스트 재실행 — 회귀 없음 확인.
+
+### 10단계: 시연 검증
+
+사용자에게 요청: "**dev 서버**를 실행하고 접속 주소를 알려달라."
+
+주소 회신 후 `playwright-cli` 로 spec §4.x 의 동작 시나리오를 직접 시연:
+
+- 기능 개요·동작에 적힌 사용자 흐름 1회씩 수행.
+- 화면 항목·와이어프레임 위치와 실제 렌더 결과 비교.
+
+회귀 발견 시 해당 작업으로 돌아가 수정 → 재시연.
+
+### 11단계: 완료 보고
+
+- 대상 spec.md 의 해당 §4.x / §5.x 헤더 `[확정: 날짜]` 를 `[확정: 날짜, 구현: 오늘날짜]` 로 확장 (오늘날짜는 Bash `date +%Y-%m-%d`). 이미 `구현: …` 가 들어있으면 그 날짜만 갱신.
+- 만들거나 갱신한 파일 목록 보고 (마커 부착한 spec.md 도 포함).
+- 본 세션에서 §5/§6/§7/§8 공통 자원을 신규/변경했다면, 그 자원을 참조하는 **다른 §4.x 화면 중 이미 구현된 것**을 spec 역인용으로 수집해 영향 화면 목록으로 보고 (재구현 필요 여부 사용자 판단용). 변경 없었으면 생략.
+- 시연에서 사용자 확인이 끝나면 종료.
+
+## 운용
+
+- 결정 근거: `sd-base-rules.md` "결정 근거" 적용.
+- **spec.md 동기화**: sd-impl 이 직접 손대는 spec 변경은 다음 2건뿐. 헤더 OPEN·구조 변경은 3단계 규칙대로 종료 후 sd-spec.
+  - 본문 인라인 `[OPEN]` 해소 시 해당 위치의 마커를 결정 내용으로 교체 (3단계).
+  - 11단계 완료 시 §4.x / §5.x 헤더 `[확정: …]` 마커를 `[확정: …, 구현: 날짜]` 로 확장.

package/claude/skills/sd-impl/evals/fixtures/case-new/.specs/260514120000_/352/261/260/353/236/230/354/262/230/spec.md

@@ -0,0 +1,101 @@
+# 거래처 관리 요구 분석서
+
+## 1. 개요
+
+### 1.1 핵심 목적 [확정: 2026-05-14]
+
+거래처 정보 조회·검색.
+
+### 1.2 주요 목표 [확정: 2026-05-14]
+
+- 거래처 목록 조회·검색
+
+### 1.3 최종 사용자/이해관계자 [확정: 2026-05-14]
+
+- 영업 담당자: 거래처 정보를 조회하는 사람
+
+### 1.4 환경/장치 [확정: 2026-05-14]
+
+PC — Windows 11, Chrome 최신, 1920 x 1080
+
+## 2. 업무 프로세스
+
+### 2.1 거래처 조회 [확정: 2026-05-14]
+
+영업 담당자가 거래처 목록을 검색·조회한다.
+
+관련 섹션: [화면.거래처 목록]
+
+## 3. 기타 요구사항
+
+없음.
+
+## 4. 화면
+
+| §   | 분류     | 화면        | 유형   | 장치 |
+| --- | -------- | ----------- | ------ | ---- |
+| 4.1 | 기준정보 | 거래처 목록 | 마스터 | PC   |
+
+### 4.1 거래처 목록 (PC) [확정: 2026-05-14]
+
+Actor: 영업 담당자
+관련 섹션: [프로세스.거래처 조회]
+
+기능 개요:
+
+- 거래처 목록 표시
+- 거래처명·사업자번호로 검색
+
+와이어프레임:
+
+```
+┌──────────────────────────────────────────────────┐
+│ 검색어: [_______________]  [조회]                │
+├────┬───────────┬──────────────┬──────────────────┤
+│ #  │ 거래처명  │ 사업자번호   │ 연락처           │
+├────┼───────────┼──────────────┼──────────────────┤
+│ 1  │ ABC상사   │ 123-45-67890 │ 02-1234-5678     │
+│ 2  │ XYZ유통   │ 234-56-78901 │ 02-2345-6789     │
+└────┴───────────┴──────────────┴──────────────────┘
+```
+
+항목:
+
+| 항목       | 타입   | 비고               |
+| ---------- | ------ | ------------------ |
+| 거래처명   | 문자열 | 필수               |
+| 사업자번호 | 문자열 | 10자리 하이픈 포함 |
+| 연락처     | 문자열 | 선택               |
+
+동작:
+
+- [조회] 클릭 → 검색어로 필터된 목록 갱신.
+
+## 5. 자동 처리
+
+없음.
+
+## 6. 공통 정의
+
+없음.
+
+## 7. 도메인 모델
+
+### 7.1 거래처 [확정: 2026-05-14]
+
+- id: 식별자
+- 거래처명: 문자열, 필수
+- 사업자번호: 문자열, 10자리 하이픈 포함
+- 연락처: 문자열, 선택
+
+## 8. 외부 인터페이스
+
+없음.
+
+## 9. 본문 외 결정사항
+
+없음.
+
+## 10. 변경 이력
+
+- 2026-05-14: 초안 작성