@simplysm/sd-claude 14.0.65 → 14.0.68

package/claude/skills/sd-dev/evals/fixtures/case-modify/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "sd-dev-eval-fixture",
+  "version": "0.0.0",
+  "type": "module",
+  "scripts": {
+    "test": "vitest run"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^2.0.0"
+  }
+}

package/claude/skills/sd-dev/evals/fixtures/case-modify/src/index.ts

@@ -0,0 +1,10 @@
+export function toCamelCase(input: string): string {
+  return input
+    .split(/[-_]/)
+    .map((part, i) =>
+      i === 0
+        ? part.toLowerCase()
+        : part.charAt(0).toUpperCase() + part.slice(1).toLowerCase(),
+    )
+    .join("");
+}

package/claude/skills/sd-dev/evals/fixtures/case-modify/tests/index.test.ts

@@ -0,0 +1,11 @@
+import { describe, it, expect } from "vitest";
+import { toCamelCase } from "../src/index.js";
+
+describe("toCamelCase", () => {
+  it("converts kebab-case to camelCase", () => {
+    expect(toCamelCase("foo-bar")).toBe("fooBar");
+  });
+  it("converts snake_case to camelCase", () => {
+    expect(toCamelCase("foo_bar_baz")).toBe("fooBarBaz");
+  });
+});

package/claude/skills/sd-dev/evals/fixtures/case-modify/tsconfig.json

@@ -0,0 +1,12 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "verbatimModuleSyntax": true
+  },
+  "include": ["src/**/*", "tests/**/*"]
+}

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

@@ -1,3 +1,3 @@
-{"id": "single-req-auto-chain-001", "input": "/sd-dev 할인율 계산 함수 추가 (10만원 이상 5%, 50만원 이상 10%, 100만원 이상 15%, 큰 구간 우선)", "rubric": [".specs/ 디렉토리 안에 12자리 숫자 디렉토리(세션 폴더)가 1개 이상 존재하는가?", "세션 폴더 안 어느 'REQ-' 시작 디렉토리에 'spec.md' 파일이 존재하는가?", "동일 REQ 디렉토리에 'plan.md' 파일이 존재하는가? (자동 chain으로 spec → plan 진행)", "동일 REQ 디렉토리에 'impl.md' 파일이 존재하는가? (자동 chain으로 plan → impl 진행)", "동일 REQ 디렉토리에 'verify.md' 파일이 존재하는가? (자동 chain으로 impl → verify 진행)", "src/ 디렉토리 하위에 .ts 또는 .tsx 확장자 파일이 1개 이상 새로 생성되었는가? (구현 코드)"], "fixture": "single-req-auto-chain"}
-{"id": "multi-req-stop-after-spec-001", "input": "/sd-dev .docs/ 폴더 자료 정리해줘", "rubric": [".specs/ 디렉토리 안에 12자리 숫자 디렉토리(세션 폴더)가 1개 이상 존재하는가?", "세션 폴더 안에 'REQ-' 로 시작하는 디렉토리가 2개 이상 존재하는가? (다중 REQ 생성)", "각 REQ-* 디렉토리에 'spec.md' 파일이 존재하는가?", "어느 REQ-* 디렉토리에도 'plan.md' 파일이 존재하지 않는가? (REQ 다수로 sd-spec 후 멈춤, plan 진행 안 함)", "에이전트의 마지막 텍스트 응답에 '멈춤' 또는 '선택' 또는 '결정' 같은 분기 안내 표현이 포함되어 있는가? (멈춤 보고 + 다음 권장 액션 안내)"], "fixture": "multi-req-stop-after-spec"}
-{"id": "start-from-plan-001", "input": "/sd-dev .specs/260503143025/REQ-001-할인계산/spec.md 기반으로 진행해줘", "rubric": [".specs/260503143025/REQ-001-할인계산/spec.md 본문에 fixture의 R1 텍스트인 '할인율 계산 함수' 가 그대로 포함되어 있는가? (sd-spec 단계가 spec.md를 새로 만들지 않고 기존 것을 사용했는지 확인 — 메타 상태 갱신은 허용)", ".specs/260503143025/REQ-001-할인계산/plan.md 파일이 새로 생성되었는가? (plan 단계 진행)", ".specs/260503143025/REQ-001-할인계산/impl.md 파일이 새로 생성되었는가? (자동 chain으로 plan → impl)", ".specs/260503143025/REQ-001-할인계산/verify.md 파일이 새로 생성되었는가? (자동 chain으로 impl → verify)", "src/lib/ 디렉토리에 'discount' 키워드를 포함한 파일(.ts / .js / .mjs 등 JS 계열 확장자)이 1개 이상 새로 생성되었는가? (할인 계산 함수 구현)"], "fixture": "start-from-plan"}
+{"id": "case-add", "input": "/sd-dev toSnakeCase 함수를 추가해줘", "fixture": "case-add", "rubric": ["src/index.ts (또는 src 하위 신규 파일) 에 toSnakeCase 함수가 export 키워드로 추가되었는가?", "tests 디렉토리에 toSnakeCase 의 테스트 케이스가 1건 이상 추가되었는가?", "기존 toCamelCase 함수 정의가 src/index.ts 에 보존되어 있는가?", "vitest run 명령이 Bash 도구로 1회 이상 호출되었고 최종 호출의 종료 코드가 0 인가?"]}
+{"id": "case-modify", "input": "/sd-dev toCamelCase 가 공백도 구분자로 처리하게 바꿔줘", "fixture": "case-modify", "rubric": ["src/index.ts 의 toCamelCase 가 공백 문자를 구분자로 인식하도록 변경되었는가? (split 정규식에 공백 포함 또는 동등 처리)", "tests 디렉토리에 공백 구분자 입력 케이스 테스트가 1건 이상 추가되었는가?", "기존 kebab-case 및 snake_case 테스트 케이스가 삭제되지 않고 보존되어 있는가?", "vitest run 명령이 Bash 도구로 1회 이상 호출되었고 최종 호출의 종료 코드가 0 인가?"]}
+{"id": "case-bug", "input": "/sd-dev toCamelCase 빈 문자열 입력하면 에러나, 고쳐줘", "fixture": "case-bug", "rubric": ["tests 디렉토리에 빈 문자열 입력 케이스 테스트가 1건 이상 추가되었는가?", "src/index.ts 의 toCamelCase 가 빈 문자열 입력 시 throw 하지 않고 빈 문자열을 반환하도록 수정되었는가?", "최종 vitest run 의 종료 코드가 0 이고 기존 테스트와 신규 빈 문자열 테스트가 모두 통과하는가?"]}

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,170 @@
 ---
 name: sd-impl
-description: plan.md를 따라 실제 코드를 작성하고 변경 결과를 impl.md로 기록하는 스킬. Use when plan 단계 후 실제 구현이 필요할 때 (human-in-the-loop, 평소 자동·막힘 시만 사용자 개입)
+description: spec.md 의 단위(§4.x 화면 또는 §5.x 자동 처리) 1개를 현재 코드베이스 상태와 비교해 차이만큼 풀 구현(테스트·시연 포함)한다. Use when "화면 풀 구현", "데모를 실 구현으로", "화면 실가동", "자동 처리 풀 구현" 을 요청할 때.
 ---
 
-# implement 단계
+# sd-impl
 
-plan.md 따라 코드 작성. 평소 자동, 막힘 시만 사용자 개입(human-in-the-loop).
-**커밋 안 함** (사용자 정책 — 병렬 작업 충돌 방지).
+spec.md 단위(§4.x 화면 또는 §5.x 자동 처리) 1개를 현재 코드베이스 상태와 비교해 빠지거나 어긋난 부분만큼 풀 구현한다. 데모 골격이 있으면 보존. 신규/갱신 무관 동일 워크플로. 끝에 사용자 시연으로 회귀를 잡는다.
 
-## 산출물
+## 본질
 
-```
-.specs/{yyMMdd_HHmmss}/REQ-XXX-슬러그/
-  spec.md / plan.md   ← 입력
-  impl.md             ← 본 단계 산출물
-+ 코드 변경 (uncommitted)
-```
+- **차이만 작업**: spec 항목 1개당 (없음 / 불일치 / 일치) 판정. 일치 항목은 손대지 않는다.
+- **YAGNI**: spec 에 없는 기능·옵션·추상화 추가 금지.
+- **임의 채움 금지**: spec 본문에 명시 없거나 모호한 분기를 발견하면 즉시 멈추고 사용자에게 질문. 자체 판단으로 채우지 않는다. 신규/갱신 무관.
+- **환경 무관**: framework 처방을 본문에 박지 않는다. 코드베이스 매뉴얼·기준 단위 + 계층별 보강 패턴·테스트 환경은 발견되면 따르고, 없으면 표준 패턴.
 
 ## 워크플로
 
-1. 입력: 대상 REQ ID
+### 1단계: 입력 확보
 
-2. 읽기: plan.md + spec.md + 코드베이스
+- 대상 spec.md 경로
+- 구현할 단위 식별자 — `§4.x` (화면) 또는 `§5.x` (자동 처리)
 
-3. plan.md 권장 순서대로 R 단위 순차 진행 (병렬 X)
+없으면 묻기. spec.md 에 식별자 매칭이 안 되면 §4 화면 목록 / §5 자동 처리 목록 표에서 후보 제시 후 확정.
 
-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))
+### 2단계: 외부 입력 점검 (BLOCKING)
 
-5. 모든 R `완료` 도달 → **impl.md 전체 재검토** (R별 변경/테스트/차이/의도 정합성 / plan 대비 누락 / 막힘·보류 잔존 여부 / 회귀 검증 누락) → 신규 이슈 발견 시 해당 R 재진입 → 재검토 후에도 이슈 0개 → **역방향 문서(overview, spec, demo, plan) 검토** → 신규 모순/수정 발견 시 해당 R 재진입 → 정합성 OK → **결과 보고** → 메타 `상태: implemented` 전환
-   - 보고: 안내 텍스트라 별도 사용자 승인 게이트 X.
+작업 대상 §4.x/§5.x 와 그가 참조하는 §5/§6/§7/§8 항목 점검:
 
-## R 진행 상태 (impl.md)
+- **헤더 `[OPEN: 날짜]` 섹션**: 본문이 재분석 포인터일 뿐 임의안 부재 → sd-impl 해소 불가. 사용자 보고 후 **종료**. 사용자가 sd-spec 으로 확정 받은 뒤 sd-impl 재호출.
+- **본문 인라인 `[OPEN]`**: `sd-base-rules` "결정 근거" 적용 — 근거 없으면 1건씩 질문. 답변 후 즉시 spec.md 반영 → 다음 건. 결정이 다른 섹션의 구조 변경(필드 추가, 새 규칙 항목 등)을 요구하면 헤더 OPEN 과 동일 처리: 종료 + sd-spec 재호출. 종료 전 식별·보고:
+  - sd-spec 에 넘길 변경 항목 (§ 위치 + 변경 내용)
+  - 그 변경이 영향 미치는 **다른 §4.x/§5.x 단위 목록** — 구조 변경된 §5/§6/§7/§8 항목을 spec 에서 역인용해 수집
+  - 영향 단위 중 이미 구현된 것 / 미구현인 것 구분
+- **사용자 제공 예정 자료**: spec 본문에 "사용자 제공 예정" 류로 적힌 파일·값. 사용자 회신 후 진행.
+- **묵시적 모호**: 명시 마커 없지만 spec 본문이 분기·정의·정의식·경계 케이스를 다루지 않는 부분. 4단계 분해 표 작성 중 발견될 가능성 높음. 발견 시 본 단계로 회귀해 인라인 `[OPEN]` 절차 적용.
 
-| 상태 | 의미 |
-|---|---|
-| 진행중 | 현재 작업 중 |
-| 완료 | 검증 통과, impl.md 갱신됨 |
-| 막힘 | 자동 시도 후 미해결, 사용자 Q |
-| 보류 | plan 모순으로 plan 재진입 필요 |
+### 3단계: 보조 자료 수집 (있다면 활용)
 
-종료 시점엔 모든 R `완료` 상태. 막힘/보류는 모두 해소되어야.
+부재로 워크플로를 멈추지 않는다.
 
-## 핵심 원칙
+**A. 라이브러리/개발 매뉴얼**
 
-- self-contained 블록 (R 블록 안에 변경/테스트/차이/의도 인라인)
-- raw input 불변
-- ID 불변
-- 자동 판단 금지 (모드 변경/스킵 등)
-- **human-in-the-loop** (다이얼로그 루프 X, 막힘 시만 Q)
+- `@simplysm/*` 14.x — [.claude/references/sd-simplysm14/README.md](../../references/sd-simplysm14/README.md) Read 후 "개발 매뉴얼" 진입.
+- 그 외 framework — 코드베이스 안의 동등 위치 문서 Read.
+- 없으면 표준 패턴.
 
-## 안티패턴
+**B. 기준 단위 + 계층별 보강**
 
-- ❌ 커밋 시도 (사용자 정책 위반)
-- ❌ implement 단독으로 R 스킵/dropped 결정 (spec/plan 수준)
-- ❌ R별 사용자 확인 받기 (human-in-the-loop 위반)
-- ❌ 검증 생략하고 다음 R 진행
-- ❌ 자동 시도 무한 반복 (N=2 정책)
-- ❌ 막힘 시 임의 우회 (사용자 확인 없이)
-- ❌ plan.md / spec.md 직접 수정 (plan 재진입 절차)
-- ❌ 라인 번호 기반 변경 위치 표기
-- ❌ 모든 R 완료 직후 impl.md 전체 재검토 없이 implemented 전환
-- ❌ 역방향 검토 없이 implemented 전환
+풀 구현은 다층 흐름이 한 줄로 가야 일관성이 유지된다. 답습 단위 1개를 통째 답습하는 모델이 아니라, 기준 단위 1개를 잡고 비어있거나 부적합한 계층만 다른 단위에서 보강한다. 계층 간 의존성(모델 → 데이터 접근 → 본체 → 테스트)을 끊지 않으면서, 기준 단위에 부재한 계층의 LLM 단독 처방을 막는다.
+
+**4계층**: 도메인 모델 / 데이터 접근 / 본체(§4.x = 화면 컴포넌트, §5.x = 자동 처리 로직 + 트리거) / 테스트.
+
+**B-1. 기준 단위 선정** (같은 종류 §4.x↔§4.x, §5.x↔§5.x 안에서):
+
+1. 도메인/sub-app 인접 풀구현 단위 후보 Glob 탐색.
+2. 1개 → 자동 채택. 2개 이상 → 후보 목록 제시 후 사용자 1회 질문. 0개 → 같은 종류 전 범위로 확장 후 동일 규칙.
+3. 전 범위에도 0개 → 기준 단위 없이 매뉴얼(3-A) + 표준 패턴.
+
+**B-2. 계층별 보강**:
+
+기준 단위의 4계층 각각을 (비어있음 / 부적합 / 적합) 으로 평가:
+
+- 비어있음: 해당 계층 파일이 기준 단위에 없음 (예: 테스트 없음).
+- 부적합: 있지만 spec 요구와 어긋남 (예: 단일 테이블 접근인데 spec 은 조인 요구).
+- 적합: 그대로 답습.
+
+비어있음·부적합 계층은 같은 종류 다른 단위에서 그 계층만 발췌해 다수 반복 패턴 자동 채택. 1회만 쓰인 변종은 배제. 다수 패턴이 갈리면 사용자 1회 질문.
+
+**B-3. Read**: 기준 단위의 적합 계층 파일 + 보강 출처 파일을 모두 Read. 7단계 정합 점검 입력.
+
+**C. 테스트 환경**
+
+단위 테스트 프로젝트 구분·실행 명령·mocking 패턴·dev 서버 실행 명령 파악. 없으면 표준 조합.
+
+### 4단계: spec 분해 표
+
+대상 §4.x/§5.x 와 참조 §5/§6/§7/§8 본문을 **항목 단위까지 분해**해 표 작성. 표는 assistant 응답으로 출력 (이후 5·6단계 입력).
+
+| 항목 | spec 인용 | 현재 코드 상태 | 판정 | 매핑 파일 | 의존 |
+| ---- | --------- | -------------- | ---- | --------- | ---- |
+
+**항목 분해 단위:**
+
+- 도메인 모델: 필드 1개당 1줄 (타입·제약·기본값)
+- 계산식: 정의식 1개당 1줄 (좌변·우변·참조)
+- 상태값·분기: 케이스 1개당 1줄 (조건·결과)
+- UI 항목: 컬럼·필드·버튼 1개당 1줄
+- 동작·자동 처리: 트리거·결과 단위 1줄
+
+**컬럼:**
+
+- **항목**: 분해 단위 1개의 짧은 식별자
+- **spec 인용**: spec.md 의 § 위치 + 본문 문구를 그대로
+- **현재 코드 상태**: 코드베이스 조사 결과 사실. 신규 호출은 "없음", 갱신 호출은 "있음(어떻게)". 조사는 워킹트리 파일 Read·Grep·Glob 만. **git 호출(`status`/`diff`/`log`/`show`/`blame` 등) 금지** — 갱신 호출이라도 현재 워킹트리 자체가 진실 원천이며, git 으로 변경분만 훑으면 일관성을 놓침 (sd-base-rules "분석 작업" 참조).
+- **판정**: 없음 / 불일치(차이) / 일치
+- **매핑 파일**: 이 항목이 작성·갱신될 파일 경로
+- **의존**: 다른 항목 ID
+
+분해 중 spec 본문이 정의·정의식·분기·경계 케이스를 다루지 않거나 모순되는 부분 발견 → 2단계 회귀.
+
+표 작성 완료 후 5단계 진입.
+
+### 5단계: 작업 사이클
+
+표의 (없음·불일치) 항목만 의존 순서로 진행. 일치 항목은 손대지 않는다.
+
+각 항목 시작 시 **테스트 작성 가능 여부** 판정 (3-C 의 테스트 환경 이용):
+
+- **테스트 가능** — 입출력 명확 + 외부 의존 통제 가능 (도메인 로직·계산·변환·서버 함수·데이터 접근).
+  사이클: **RED → GREEN → REFACTOR**
+  - **RED**: 테스트만 작성 → 러너 실행 → 실패 확인. **구현 파일 손대지 않음.**
+  - **GREEN**: 테스트 통과하는 **최소** 구현 → 러너 통과 확인.
+  - **REFACTOR**: 중복·가독성·기존 패턴 정합 정리 → 러너 통과 유지. 정리할 게 없으면 스킵.
+- **테스트 불가/비효율** — UI 시각·인터랙션, 외부 서비스 실호출, 환경 의존.
+  사이클: **구현 → REFACTOR**
+
+**임의 채움 금지**: 작업 사이클 중 spec 미정의/모호 분기 만나면 즉시 멈추고 2단계 회귀. 자체 판단으로 채우지 않는다.
+
+### 6단계: spec 대조 (subagent 위탁)
+
+5단계 모든 항목 완료 후, 별도 subagent 에 위탁해 spec ↔ 현재 코드 전체를 독립 대조. 같은 LLM 셀프 검증의 표면 훑기 편향 제거.
+
+**대조는 단위 전체 대상.** 신규/갱신 무관, "이번 변경분만" 스코프 제한 없음.
+
+상세 (subagent 호출 형식, 입력 패키지, 4분류 출력 스키마, 분류별 처리): [references/spec-cross-check.md](references/spec-cross-check.md) Read 후 진행.
+
+차이 0건이면 7단계 진입. 1건 이상이면 분류별 처리 후 본 단계 재실행.
+
+### 7단계: 코드 정리
+
+- **횡단 중복**: 작업 사이클 사이 흩어진 동일 로직 합치기.
+- **계층별 정합 점검**: 3-B 의 기준 단위 + 보강 출처 파일을 다시 Read 해 4계층별로 실제 작성분과 비교. 한 계층이라도 채택 패턴과 어긋나면 (임의 변형·새 발명) 수정.
+  - 도메인 모델: 필드·타입·제약·네이밍 패턴 일치
+  - 데이터 접근: 함수 시그니처·쿼리 패턴·에러 처리 일치
+  - 본체: 컴포넌트 구조·상태·핸들러·의존성 패턴 일치 (§4.x) / 트리거·처리 단계 구조 일치 (§5.x)
+  - 테스트: 러너·assertion·mock 패턴 일치
+- **불필요한 코드**: 미사용 import·변수·주석, 요구 없는 옵션·추상화 제거. 작업 결과로 어디서도 참조되지 않는 파일도 포함 (검사 범위는 전체 워크스페이스). **단 파일 단위 삭제는 후보 목록을 사용자에게 보고 → 확정분만 삭제** (dynamic import·마이그레이션·문서 자산 등 보존분 사용자 제외).
+- **매뉴얼 권위 규약**: 3-A Read 한 매뉴얼 위반 항목 수정.
+
+정리 후 단위 테스트 재실행 — 회귀 없음 확인.
+
+### 8단계: 시연 검증
+
+사용자에게 요청: "**dev 서버**를 실행하고 접속 주소를 알려달라."
+
+**dev 서버·외부 프로세스 자체 실행 금지**: assistant 가 직접 `ng serve`·`npm run dev`·`vite`·`pnpm dev` 등으로 dev 서버를 띄우지 않는다. 사용자가 띄워 주소를 회신할 때까지 대기. 사용자가 본 단계 스킵을 지시하거나 시연 불가 환경이 명시되면 본 단계 스킵 후 9단계.
+
+주소 회신 후 `playwright-cli` 로 §4.x/§5.x 동작 시나리오 직접 시연:
+
+- 기능 개요·동작 사용자 흐름 1회씩 수행.
+- 화면 항목·와이어프레임 위치와 실제 렌더 비교.
+- §5.x (자동 처리) 는 트리거 발생 → 결과 확인.
+
+회귀 발견 시 5단계 회귀 → 수정 → 재시연.
+
+### 9단계: 완료 보고
+
+- 대상 spec.md 의 해당 §4.x / §5.x 헤더 `[확정: 날짜]` 를 `[확정: 날짜, 구현: 오늘날짜]` 로 확장 (Bash `date +%Y-%m-%d`). 이미 `구현: …` 가 들어있으면 그 날짜만 갱신.
+- 만들거나 갱신한 파일 목록 보고 (마커 부착한 spec.md 포함).
+- 본 세션에서 §5/§6/§7/§8 공통 자원을 신규/변경했다면, 그 자원을 참조하는 **다른 §4.x/§5.x 중 이미 구현된 것**을 spec 역인용으로 수집해 영향 단위 목록 보고 (재구현 필요 여부 사용자 판단용). 변경 없었으면 생략.
+- 시연에서 사용자 확인 끝나면 종료.
+
+## 운용
+
+- 결정 근거: `sd-base-rules.md` "결정 근거" 적용.
+- **사용자 보고 어휘**: 코드 식별자(변수명·SQL 함수명·타입 키워드 등) 노출 금지. 도메인 어휘로 풀어 보고. (`sd-base-rules.md` "산출물 소비자 도메인 어휘" 적용)
+- **spec.md 동기화**: sd-impl 이 직접 손대는 spec 변경은 다음 2건뿐. 헤더 OPEN·구조 변경은 2단계 규칙대로 종료 후 sd-spec.
+  - 본문 인라인 `[OPEN]` 해소 시 마커를 결정 내용으로 교체 (2단계).
+  - 9단계 완료 시 §4.x/§5.x 헤더 `[확정: …]` 를 `[확정: …, 구현: 날짜]` 로 확장.

package/claude/skills/sd-impl/evals/fixtures/case-001-new-screen/spec.md

@@ -0,0 +1,55 @@
+# 도서 관리 시스템 spec
+
+## §1 개요
+
+도서관 내부 시스템. 사서가 도서를 등록·조회.
+
+## §4 화면
+
+| ID    | 이름     | Actor | 장치 |
+| ----- | -------- | ----- | ---- |
+| §4.1  | 도서 목록 | 사서  | PC   |
+
+### §4.1 도서 목록 [확정: 2026-05-01]
+
+**Actor**: 사서
+**관련 섹션**: §7.1 도서
+**장치**: PC 웹
+
+**기능 개요**:
+- 등록된 도서 전체 목록 표시.
+- 제목·저자로 부분일치 검색 (대소문자 무시).
+
+**와이어프레임**:
+```
+[검색창: 제목/저자]              [등록]
++----------+----------+-----------+
+| 제목     | 저자     | 출판일    |
++----------+----------+-----------+
+| ...      | ...      | ...       |
++----------+----------+-----------+
+```
+
+**항목표**:
+
+| 항목   | 타입   | 비고                              |
+| ------ | ------ | --------------------------------- |
+| 제목   | text   | §7.1.title                        |
+| 저자   | text   | §7.1.author                       |
+| 출판일 | date   | §7.1.publishedAt, YYYY-MM-DD 형식 |
+
+**동작**:
+- 진입 시 도서 전체를 출판일 내림차순으로 로드.
+- 검색창 입력 시 제목·저자 부분일치 필터링 (대소문자 무시).
+- "등록" 클릭 시 등록 화면 (본 spec 범위 외).
+
+## §7 도메인 모델
+
+### §7.1 도서 [확정: 2026-05-01]
+
+| 필드        | 타입          | 제약                  | 기본값    |
+| ----------- | ------------- | --------------------- | --------- |
+| id          | string (UUID) | PK                    | 자동 생성 |
+| title       | string        | NOT NULL, 최대 200자  | -         |
+| author      | string        | NOT NULL, 최대 100자  | -         |
+| publishedAt | date          | NOT NULL              | -         |