@simplysm/sd-claude 14.0.42 → 14.0.44

package/claude/references/sd-simplysm14/lint/usage.md

@@ -1,6 +1,6 @@
 # @simplysm/lint
 
-Simplysm 모노레포 전용 ESLint 플러그인 및 공유 Flat Config 설정. 커스텀 규칙 7개와 권장 설정을 제공한다.
+Simplysm 모노레포 전용 ESLint 플러그인 및 공유 Flat Config 설정. 커스텀 규칙 8개와 권장 설정을 제공한다.
 
 ## Installation
 
@@ -14,7 +14,7 @@ npm install @simplysm/lint
 
 | API | Type | Description |
 |-----|------|-------------|
-| `default` | object | `{ rules: {...} }` 형태의 ESLint 플러그인 객체. 7개의 커스텀 규칙을 포함한다 |
+| `default` | object | `{ rules: {...} }` 형태의 ESLint 플러그인 객체. 8개의 커스텀 규칙을 포함한다 |
 
 #### Rules
 
@@ -26,6 +26,7 @@ npm install @simplysm/lint
 | `ts-no-unused-injects` | problem | autofix | 미사용 Angular `inject()` 필드를 감지하여 제거한다. 클래스 내 `inject()` 호출로 초기화된 프로퍼티 중 다른 곳에서 참조되지 않는 필드를 보고 |
 | `ts-no-unused-protected-readonly` | problem | autofix | Angular `@Component` 클래스의 미사용 `protected readonly` 필드를 감지하여 제거한다. 인라인 템플릿과 클래스 본문 모두에서 참조 여부를 확인 |
 | `ng-template-no-todo-comments` | problem | - | HTML 템플릿 내 `<!-- TODO: ... -->` 주석을 경고한다. raw text regex 방식으로 동작 |
+| `ng-template-no-strict-null-check` | problem | - | Angular 템플릿에서 `=== null`, `!== null`, `=== undefined`, `!== undefined` 사용을 금지한다. `== null` / `!= null`로 통일하도록 강제. autofix 미제공(인라인 템플릿 offset 매핑 문제) |
 | `ng-template-sd-require-binding-attrs` | problem | autofix | `sd-*` 컴포넌트에서 허용 목록 외 plain attribute 사용을 금지하고 Angular property binding(`[attr]="..."`)을 강제한다 |
 
 #### `ng-template-sd-require-binding-attrs` Options

package/claude/references/sd-simplysm14/orm-common/docs/queryable-executable.md

@@ -59,11 +59,11 @@ export class Queryable<TData extends DataRecord, TFrom extends TableBuilder | ne
 
   // UPDATE
   update(recordFwd: (cols: QueryableRecord<TData>) => QueryableWriteRecord<TFrom["$inferUpdate"]>): Promise<void>;
-  update<K>(recordFwd: ..., outputColumns: K[]): Promise<Pick<TFrom["$columns"], K>[]>;
+  update<K>(recordFwd: ..., outputColumns: K[]): Promise<Pick<TFrom["$inferColumns"], K>[]>;
 
   // DELETE
   delete(): Promise<void>;
-  delete<K>(outputColumns: K[]): Promise<Pick<TFrom["$columns"], K>[]>;
+  delete<K>(outputColumns: K[]): Promise<Pick<TFrom["$inferColumns"], K>[]>;
 
   // UPSERT
   upsert(updateFn: (cols: QueryableRecord<TData>) => QueryableWriteRecord<TFrom["$inferUpdate"]>): Promise<void>;
@@ -129,11 +129,19 @@ Queryable의 column 프록시 레코드 타입. 각 column이 `ExprUnit`으로
 export type QueryableRecord<TData extends DataRecord> = {
   [K in keyof TData]: TData[K] extends ColumnPrimitive
     ? ExprUnit<TData[K]>
-    : TData[K] extends (infer U extends DataRecord)[]
-      ? [QueryableRecord<U>]
-      : TData[K] extends DataRecord
-        ? QueryableRecord<TData[K]>
-        : ExprUnit<TData[K] & ColumnPrimitive>;
+    : TData[K] extends (infer U)[]
+      ? U extends DataRecord
+        ? QueryableRecord<U>[]
+        : never
+      : TData[K] extends (infer U)[] | undefined
+        ? U extends DataRecord
+          ? QueryableRecord<U>[] | undefined
+          : never
+        : TData[K] extends DataRecord
+          ? QueryableRecord<TData[K]>
+          : TData[K] extends DataRecord | undefined
+            ? QueryableRecord<Exclude<TData[K], undefined>> | undefined
+            : never;
 };
 ```
 
@@ -143,23 +151,7 @@ UPDATE/INSERT용 column 레코드 타입. `ExprUnit` 또는 리터럴 값을 받
 
 ```typescript
 export type QueryableWriteRecord<TData> = {
-  [K in keyof TData]: ExprInput<TData[K] & ColumnPrimitive>;
-};
-```
-
-## `NullableQueryableRecord`
-
-모든 column이 nullable인 Queryable 레코드 타입.
-
-```typescript
-export type NullableQueryableRecord<TData extends DataRecord> = {
-  [K in keyof TData]: TData[K] extends ColumnPrimitive
-    ? ExprUnit<TData[K] | undefined>
-    : TData[K] extends (infer U extends DataRecord)[]
-      ? [NullableQueryableRecord<U>]
-      : TData[K] extends DataRecord
-        ? NullableQueryableRecord<TData[K]>
-        : ExprUnit<(TData[K] & ColumnPrimitive) | undefined>;
+  [K in keyof TData]: TData[K] extends ColumnPrimitive ? ExprInput<TData[K]> : never;
 };
 ```
 
@@ -169,25 +161,28 @@ QueryableRecord에서 실제 데이터 타입을 추출한다.
 
 ```typescript
 export type UnwrapQueryableRecord<R> = {
-  [K in keyof R]: R[K] extends ExprUnit<infer T> ? T
-    : R[K] extends [infer U] ? UnwrapQueryableRecord<U>[]
-    : R[K] extends Record<string, any> ? UnwrapQueryableRecord<R[K]>
-    : R[K];
+  [K in keyof R as K extends symbol ? never : K]: R[K] extends ExprUnit<infer T>
+    ? T
+    : NonNullable<R[K]> extends (infer U)[]
+      ? U extends Record<string, any>
+        ? UnwrapQueryableRecord<U>[] | Extract<R[K], undefined>
+        : never
+      : NonNullable<R[K]> extends Record<string, any>
+        ? UnwrapQueryableRecord<NonNullable<R[K]>> | Extract<R[K], undefined>
+        : never;
 };
 ```
 
 ## `PathProxy`
 
-include()에서 관계 경로를 타입 안전하게 지정하기 위한 프록시 타입.
+include()에서 관계 경로를 타입 안전하게 지정하기 위한 프록시 타입. `ColumnPrimitive`가 아닌 필드(FK, FKT 관계)만 접근 가능하다.
 
 ```typescript
 export type PathProxy<TObject> = {
-  [K in keyof TObject]-?: TObject[K] extends (infer U)[] | undefined
-    ? PathProxy<U>
-    : TObject[K] extends infer U | undefined
-      ? PathProxy<U>
-      : PathProxy<TObject[K]>;
-} & { [PATH_SYMBOL]: string[] };
+  [K in keyof TObject as TObject[K] extends ColumnPrimitive ? never : K]-?: PathProxy<
+    UnwrapArray<TObject[K]>
+  >;
+} & { readonly [PATH_SYMBOL]: string[] };
 ```
 
 ## `Executable`

package/claude/references/sd-simplysm14/orm-common/usage.md

@@ -22,7 +22,7 @@ npm install @simplysm/orm-common
 | `DbErrorCode` | enum | 트랜잭션 에러 코드 (NO_ACTIVE_TRANSACTION, DEADLOCK 등) |
 | `DbTransactionError` | class | DBMS 네이티브 에러를 표준 에러 코드로 래핑하는 에러 클래스 |
 
--> See [docs/core.md](./docs/core.md) for details.
+See [docs/core.md](./docs/core.md) for detailed API documentation.
 
 ### Queryable / Executable
 
@@ -33,7 +33,6 @@ npm install @simplysm/orm-common
 | `getMatchedPrimaryKeys` | function | FK column 배열과 대상 테이블 PK를 매칭하여 PK column 이름 반환 |
 | `QueryableRecord` | type | Queryable column 프록시 레코드 타입 |
 | `QueryableWriteRecord` | type | UPDATE/INSERT용 column 레코드 타입 |
-| `NullableQueryableRecord` | type | 모든 column이 nullable인 Queryable 레코드 타입 |
 | `UnwrapQueryableRecord` | type | QueryableRecord에서 실제 데이터 타입 추출 |
 | `PathProxy` | type | include()에서 관계 경로를 타입 안전하게 지정하기 위한 프록시 타입 |
 | `Executable` | class | Stored Procedure 실행 래퍼 클래스 |
@@ -41,7 +40,7 @@ npm install @simplysm/orm-common
 | `parseSearchQuery` | function | 검색 쿼리 문자열을 SQL LIKE 패턴으로 파싱 |
 | `ParsedSearchQuery` | interface | parseSearchQuery 결과 타입 (or, must, not 배열) |
 
--> See [docs/queryable-executable.md](./docs/queryable-executable.md) for details.
+See [docs/queryable-executable.md](./docs/queryable-executable.md) for detailed API documentation.
 
 ### Expression
 
@@ -54,7 +53,7 @@ npm install @simplysm/orm-common
 | `ExprInput` | type | ExprUnit 또는 리터럴 값을 받는 입력 타입 |
 | `toExpr` | function | ExprInput을 Expr AST로 변환하는 내부 헬퍼 (커스텀 빌더 작성 시 사용) |
 
--> See [docs/expression.md](./docs/expression.md) for details.
+See [docs/expression.md](./docs/expression.md) for detailed API documentation.
 
 ### Schema Builders
 
@@ -88,7 +87,7 @@ npm install @simplysm/orm-common
 | `ExtractRelationTargetResult` | type | FKTarget에서 대상 타입 추출 (배열/단일) |
 | `InferDeepRelations` | type | 관계 정의에서 심층 타입 추론 |
 
--> See [docs/schema-builders.md](./docs/schema-builders.md) for details.
+See [docs/schema-builders.md](./docs/schema-builders.md) for detailed API documentation.
 
 ### Models
 
@@ -96,7 +95,7 @@ npm install @simplysm/orm-common
 |-----|------|-------------|
 | `_Migration` | const | 시스템 마이그레이션 테이블 정의 (TableBuilder 인스턴스) |
 
--> See [docs/models.md](./docs/models.md) for details.
+See [docs/models.md](./docs/models.md) for detailed API documentation.
 
 ### Query Builder
 
@@ -112,7 +111,7 @@ npm install @simplysm/orm-common
 | `PostgresqlQueryBuilder` | class | PostgreSQL용 QueryBuilder |
 | `PostgresqlExprRenderer` | class | PostgreSQL용 ExprRenderer |
 
--> See [docs/query-builder.md](./docs/query-builder.md) for details.
+See [docs/query-builder.md](./docs/query-builder.md) for detailed API documentation.
 
 ### Types
 
@@ -142,18 +141,20 @@ npm install @simplysm/orm-common
 | `WinFn` | type | Window 함수 유니온 타입 |
 | `QueryDef` | type | 모든 쿼리 정의의 유니온 타입 |
 | `SelectQueryDef` | interface | SELECT 쿼리 정의 |
+| `SelectQueryDefJoin` | interface | SELECT 쿼리 JOIN 정의 (SelectQueryDef 확장) |
 | `InsertQueryDef` | interface | INSERT 쿼리 정의 |
 | `UpdateQueryDef` | interface | UPDATE 쿼리 정의 |
 | `DeleteQueryDef` | interface | DELETE 쿼리 정의 |
 | `UpsertQueryDef` | interface | UPSERT 쿼리 정의 |
 | `QueryDefObjectName` | interface | 테이블/뷰 이름 정의 (database, schema, name) |
+| `CudOutputDef` | interface | INSERT/UPDATE/DELETE output 정의 (columns, pkColNames, aiColName) |
 | `DDL_TYPES` | const | DDL 타입 문자열 목록 |
 | `DdlType` | type | DDL 타입 유니온 |
 | 60+ `Expr*` interfaces | interface | 각 표현식 AST 인터페이스 (ExprColumn, ExprValue, ExprEq, ...) |
 | 13+ `WinFn*` interfaces | interface | Window 함수 AST 인터페이스 |
 | DDL QueryDef interfaces | interface | DDL 쿼리 정의 인터페이스 (CreateTable, DropTable, ...) |
 
--> See [docs/types.md](./docs/types.md) for details.
+See [docs/types.md](./docs/types.md) for detailed API documentation.
 
 ## Usage Examples
 

package/claude/references/sd-simplysm14/sd-claude/docs/assets.md

@@ -9,15 +9,16 @@ claude/
 ├── references/          ← 스킬/규칙에서 참조하는 공유 문서
 ├── rules/               ← Claude Code 규칙 파일
 ├── skills/              ← 스킬 파일 디렉토리
-├── sd-check-bash.py      ← 훅 스크립트
-├── sd-check-write.py    ← 훅 스크립트
-├── sd-session-start.sh  ← 훅 스크립트
-└── sd-statusline.py     ← 훅 스크립트
+├── sd-check-bash.py             ← 훅 스크립트
+├── sd-check-forbidden-files.py ← 훅 스크립트
+├── sd-check-write.py            ← 훅 스크립트
+├── sd-session-start.sh          ← 훅 스크립트
+└── sd-statusline.py             ← 훅 스크립트
 ```
 
 ## `claude/skills/`
 
-16개 `sd-*` 접두어 스킬 디렉토리. 각 스킬은 아래 파일을 포함한다:
+다수의 스킬 디렉토리. `sd-*` 접두어 스킬은 postinstall로 소비 프로젝트에 배포되고, `my-apk-decompile/`·`playwright-cli/` 같이 `sd-*`로 시작하지 않는 스킬은 모노레포 로컬 전용이다. 각 스킬은 아래 파일을 포함한다:
 
 | 파일            | 필수 | Description                                                  |
 | --------------- | ---- | ------------------------------------------------------------ |
@@ -27,24 +28,28 @@ claude/
 
 ### 스킬 목록
 
-| 디렉토리            | 스킬 이름        | Description                                      |
-| ------------------- | ---------------- | ------------------------------------------------ |
-| `sd-check/`         | sd-check         | typecheck/lint/test 실행 및 에러 해결            |
-| `sd-claude-docs/`   | sd-claude-docs   | CLAUDE.md + usage 문서 동시 생성                 |
-| `sd-commit/`        | sd-commit        | 전체 변경사항에 대한 단일 커밋 생성              |
-| `sd-debug/`         | sd-debug         | 버그 근본 원인 분석 및 해결책 제안               |
-| `sd-deliverable/`   | sd-deliverable   | 매뉴얼/SIT 문서 생성                             |
-| `sd-dev/`           | sd-dev           | 통합 개발 오케스트레이터 (요구명세 → TDD → 리뷰) |
-| `sd-doc-extract/`   | sd-doc-extract   | 문서 파일 텍스트/이미지 추출 (Python)            |
-| `sd-issue/`         | sd-issue         | GitHub 이슈 생성                                 |
-| `sd-outlook/`       | sd-outlook       | Outlook 메일 검색/다운로드 (Python)              |
-| `sd-plan/`          | sd-plan          | 요구명세/구현계획 작성                           |
-| `sd-prompt/`        | sd-prompt        | 스킬/프롬프트 파일 작성/개선                     |
-| `sd-refactor/`      | sd-refactor      | 리팩토링 분석 리포트 생성                        |
-| `sd-review/`        | sd-review        | 코드 리뷰 리포트 생성                            |
-| `sd-tdd/`           | sd-tdd           | TDD 개발                                         |
-| `sd-use/`           | sd-use           | 자연어 → sd-\* 스킬 라우팅                       |
-| `sd-wbs/`           | sd-wbs           | WBS Feature 분해                                 |
+| 디렉토리              | 스킬 이름          | Description                                        |
+| --------------------- | ------------------ | -------------------------------------------------- |
+| `my-apk-decompile/`   | my-apk-decompile   | APK 파일 디컴파일 및 소스코드 분석                 |
+| `playwright-cli/`     | playwright-cli     | 브라우저 자동화 및 Playwright 테스트               |
+| `sd-check/`           | sd-check           | typecheck/lint/test 실행 및 에러 해결              |
+| `sd-claude-docs/`     | sd-claude-docs     | CLAUDE.md + usage 문서 동시 생성                   |
+| `sd-commit/`          | sd-commit          | 전체 변경사항에 대한 단일 커밋 생성                |
+| `sd-debug/`           | sd-debug           | 버그 근본 원인 분석 및 해결책 제안                 |
+| `sd-deliverable/`     | sd-deliverable     | 매뉴얼/SIT 문서 생성                               |
+| `sd-dev/`             | sd-dev             | 통합 개발 오케스트레이터 (요구명세 → TDD → 리뷰)   |
+| `sd-doc-extract/`     | sd-doc-extract     | 문서 파일 텍스트/이미지 추출 (Python)              |
+| `sd-inner-debug/`     | sd-inner-debug     | (내부 전용) 근본 원인 분석(ACH) 로직               |
+| `sd-inner-review/`    | sd-inner-review    | (내부 전용) 코드 리뷰 분석 로직                    |
+| `sd-issue/`           | sd-issue           | GitHub 이슈 생성                                   |
+| `sd-outlook/`         | sd-outlook         | Outlook 메일 검색/다운로드 (Python)                |
+| `sd-plan/`            | sd-plan            | 요구명세/구현계획 작성                             |
+| `sd-prompt/`          | sd-prompt          | 스킬/프롬프트 파일 작성/개선                       |
+| `sd-refactor/`        | sd-refactor        | 리팩토링 분석 리포트 생성                          |
+| `sd-review/`          | sd-review          | 코드 리뷰 리포트 생성                              |
+| `sd-tdd/`             | sd-tdd             | TDD 개발                                           |
+| `sd-use/`             | sd-use             | 자연어 → sd-\* 스킬 라우팅                         |
+| `sd-wbs/`             | sd-wbs             | WBS Feature 분해                                   |
 
 ### SKILL.md frontmatter 형식
 
@@ -73,17 +78,21 @@ Claude Code 규칙 파일. 세션 시작 시 `sd-session-start.sh`에 의해 읽
 
 ## `claude/references/`
 
-스킬과 규칙에서 참조하는 공유 문서. 규칙 파일에서 `Read tool로 읽으라`는 지시로 참조된다. 7개 md파일 + 1개 디렉토리.
-
-| 파일/디렉토리           | Description                               |
-| ----------------------- | ----------------------------------------- |
-| `sd-clarify.md`         | 사용자 요청 명확화 지침                   |
-| `sd-debug.md`           | 디버그 프로세스 참조 문서                 |
-| `sd-frontend-design.md` | 프론트엔드 UI 코드 작성 지침              |
-| `sd-review.md`          | 코드 리뷰 관점 참조 문서                  |
-| `sd-simplysm14.md`      | simplysm 패키지 문서 진입점               |
-| `sd-simplysm14/`        | simplysm v14 패키지별 usage 문서 디렉토리 |
-| `sd-testing.md`         | 테스트 작성 지침                          |
+스킬과 규칙에서 참조하는 공유 문서. 규칙 파일에서 `Read tool로 읽으라`는 지시로 참조된다. 공유 문서(md파일)와 패키지별 사용 설명서 디렉토리.
+
+### 공유 문서
+
+| 파일 | Description |
+|------|-------------|
+| `sd-frontend-design.md` | 프론트엔드 UI 코드 작성 지침 |
+| `sd-simplysm14.md` | simplysm 패키지 문서 진입점 |
+| `sd-testing.md` | 테스트 작성 지침 |
+
+### 패키지 문서 디렉토리
+
+| 디렉토리 | Description |
+|----------|-------------|
+| `sd-simplysm14/` | simplysm v14 패키지별 CLAUDE.md와 usage.md |
 
 ## 소스 오브 트루스
 

package/claude/references/sd-simplysm14/sd-claude/docs/cli.md

@@ -80,4 +80,4 @@
 - 다른 계정: 마지막 저장/전환 시점의 데이터 사용 (← 저장 시점 표시)
 - 사용량 정보 없음: `[사용량 정보 없음]` 표시
 
-남은 시간 형식: `Xd Yh` (일+시간), `Xh Ym` (시간+분), `Xm` (분), `리셋됨` (만료)
+남은 시간 형식: `Xd Yh` (일+시간), `Xh Ym` (시간+분), `Xm` (분), `0m` (만료)

package/claude/references/sd-simplysm14/sd-claude/docs/hooks.md

@@ -1,6 +1,6 @@
 # Hooks
 
-`claude/` 디렉토리의 훅 스크립트. `postinstall`에 의해 `.claude/`에 설치되고, `settings.json`에 자동 등록되어 Claude Code 세션에서 실행된다.
+`claude/` 디렉토리의 훅 스크립트 (총 5개). `postinstall`에 의해 `.claude/`에 설치되고, `settings.json`에 자동 등록되어 Claude Code 세션에서 실행된다.
 
 ## `sd-session-start.sh`
 
@@ -57,6 +57,24 @@ PreToolUse 훅 (matcher: `Bash`). 금지된 명령어를 차단한다. 명령어
 | `npx\s+tsc` | `npx tsc` | `pnpm typecheck` 사용 필수 |
 | `npx\s+eslint` | `npx eslint` | `pnpm lint` 사용 필수 |
 
+## `sd-check-forbidden-files.py`
+
+PreToolUse 훅 (matcher: `Write|Edit`). `tsconfig.json`, `eslint.config.ts` 등 보호 대상 파일의 수정을 차단한다.
+
+```python
+# stdin으로 tool_input JSON을 받아 file_path를 검사
+# 보호 대상 파일이면 stderr에 메시지 출력 후 exit(2)
+```
+
+입력: stdin JSON (`tool_input.file_path`)
+
+차단 대상 파일:
+
+| 파일명 | 이유 |
+|--------|------|
+| `tsconfig.json` | 빌드 설정 보호 |
+| `eslint.config.ts` | 린트 설정 보호 |
+
 ## `sd-statusline.py`
 
 statusLine 훅. Claude Code 상태바에 `폴더 | 모델 | 컨텍스트% | 5h사용량 | 7d사용량 | $추가요금` 형식으로 표시한다.
@@ -99,7 +117,7 @@ statusLine 훅. Claude Code 상태바에 `폴더 | 모델 | 컨텍스트% | 5h
 | Function | Description |
 |----------|-------------|
 | `format_model(model_id)` | 모델 ID를 `Name X.Y` 형식으로 변환 (예: `claude-opus-4-6` → `Opus 4.6`) |
-| `format_remaining(reset_epoch)` | 리셋까지 남은 시간을 `Xd Yh` / `Xh Ym` / `Xm` 형식으로 변환 |
+| `format_remaining(reset_epoch)` | 리셋까지 남은 시간을 `Xd Yh` / `Xh Ym` / `Xm` 형식으로 변환. 만료 시 `0m` 반환 |
 | `format_rate_limit(rate_limit)` | rate limit을 `X%(남은시간)` 형식으로 변환 |
 | `read_cache()` | 캐시 파일을 읽어 딕셔너리로 반환 |
 | `should_fetch(cache)` | 캐시가 없거나 180초 이상 경과했으면 `True` |

package/claude/references/sd-simplysm14/sd-claude/docs/scripts.md

@@ -4,7 +4,7 @@
 
 ## `postinstall.mjs`
 
-`pnpm install` 후 자동 실행되는 라이프사이클 스크립트. `claude/` 디렉토리의 에셋을 소비 프로젝트의 `.claude/`에 설치하고 `settings.json`에 훅을 등록한다.
+`pnpm install` 후 자동 실행되는 라이프사이클 스크립트. `claude/` 디렉토리의 에셋을 소비 프로젝트의 `.claude/`에 복사한다. `settings.json`도 `sd-*` 항목과 함께 복사된다.
 
 전체 try-catch로 감싸서 실패해도 `pnpm install`을 차단하지 않는다.
 
@@ -14,22 +14,9 @@
 2. **자기 자신 설치 방지**: simplysm 모노레포에서 동일 메이저 버전이면 건너뜀
 3. **소스 디렉토리 확인**: `claude/` 디렉토리가 없으면 건너뜀
 4. **cleanSdEntries**: 기존 `.claude/` 내 `sd-*` 항목 삭제
-5. **copySdEntries**: `claude/` → `.claude/` 복사
-6. **setupSettings**: `.claude/settings.json`에 훅 등록
+5. **copySdEntries**: `claude/sd-*` + `settings.json` → `.claude/` 복사
 
-### setupSettings 훅 등록
-
-`settings.json`에 아래 훅을 멱등적으로 등록한다. 기존 항목이 있으면 덮어쓰고, 없으면 추가한다.
-
-| Hook Type | Matcher | Command | Description |
-|-----------|---------|---------|-------------|
-| `SessionStart` | `startup\|resume\|clear\|compact` | `bash .claude/sd-session-start.sh` | 세션 시작 시 규칙 파일 경로 출력 |
-| `PreToolUse` | `Write` | `python .claude/sd-check-write.py` | 기존 파일 Write 차단 |
-| `PreToolUse` | `Bash` | `python .claude/sd-check-bash.py` | 금지 명령어 차단 (git, cd, npx tsc/eslint) |
-| `SubagentStart` | (없음) | `bash .claude/sd-session-start.sh` | 서브에이전트 시작 시 규칙 파일 경로 출력 |
-| `statusLine` | — | `python .claude/sd-statusline.py` | 상태바 표시 |
-
-마이그레이션: 루트 레벨에 잘못 위치한 `SessionStart` 키를 `hooks.SessionStart`로 이동한다.
+`settings.json`은 훅이 미리 등록된 정적 파일로 관리된다. 소비 프로젝트에서 커스텀 훅이 필요하면 `settings.local.json`을 사용한다.
 
 ### 내부 함수
 
@@ -96,8 +83,8 @@ function setupSettings(targetDir) → void
 
 동작:
 1. 기존 `claude/` 디렉토리 삭제
-2. 루트 `.claude/`에서 `sd-*` 항목을 수집
-3. 수집된 항목을 `claude/`로 복사
+2. 루트 `.claude/`에서 `sd-*` 항목 수집, `settings.json` 포함
+3. 수집된 항목을 `claude/`로 복사 (단, `SKILL.eval.md`와 `eval_*` 파일은 제외)
 
 ---
 

package/claude/references/sd-simplysm14/sd-claude/usage.md

@@ -1,6 +1,6 @@
 # @simplysm/sd-claude
 
-Claude Code 에셋을 소비 프로젝트의 `.claude/` 디렉토리에 자동 설치하는 패키지. 16개 스킬(`sd-*` 접두어), 2개 rules 파일, 참조 문서, 훅 스크립트를 포함한다. CLI(`sd-claude`)로 멀티 계정 전환 기능도 제공한다.
+Claude Code 에셋을 소비 프로젝트의 `.claude/` 디렉토리에 자동 설치하는 패키지. 다수의 스킬(`sd-*` 접두어 포함), 2개 rules 파일, 참조 문서, 훅 스크립트를 포함한다. CLI(`sd-claude`)로 멀티 계정 전환 기능도 제공한다.
 
 TypeScript 소스 없음. `scripts/`는 Node.js `.mjs` 스크립트이고, `claude/`는 배포 에셋 디렉토리다.
 
@@ -10,7 +10,7 @@ TypeScript 소스 없음. `scripts/`는 Node.js `.mjs` 스크립트이고, `clau
 npm install @simplysm/sd-claude
 ```
 
-설치 시 `postinstall` 스크립트가 자동 실행되어, `claude/` 디렉토리의 에셋을 프로젝트 루트 `.claude/`에 복사하고 `settings.json`에 훅을 등록한다.
+설치 시 `postinstall` 스크립트가 자동 실행되어, `claude/sd-*` 에셋과 `settings.json`을 프로젝트 루트 `.claude/`에 복사한다. `settings.json`은 훅이 미리 등록된 정적 파일이다.
 
 ## API Overview
 
@@ -27,7 +27,7 @@ npm install @simplysm/sd-claude
 
 | API | Type | Description |
 |-----|------|-------------|
-| `postinstall.mjs` | lifecycle script | `pnpm install` 후 `.claude/`에 에셋 설치 및 settings.json 훅 등록 |
+| `postinstall.mjs` | lifecycle script | `pnpm install` 후 `claude/sd-*` 및 `settings.json`을 소비 프로젝트 `.claude/`에 복사 |
 | `sync.mjs` | lifecycle script | `prepack` 시 루트 `.claude/sd-*` 에셋을 `claude/`로 동기화 |
 | `forEachSdEntry(dir, callback)` | function | 디렉토리에서 `sd-*` 항목을 2단계 깊이로 탐색하며 콜백 호출 |
 | `collectSdEntries(dir)` | function | `forEachSdEntry`로 수집한 `sd-*` 항목의 상대 경로 배열 반환 |
@@ -41,6 +41,7 @@ npm install @simplysm/sd-claude
 | `sd-session-start.sh` | SessionStart / SubagentStart hook | 세션 시작 시 `.claude/rules/*.md`와 `CLAUDE.md` 경로를 출력하여 Claude가 읽도록 안내 |
 | `sd-check-write.py` | PreToolUse hook (Write) | 기존 파일에 Write 도구 사용 시 차단하고 Edit 도구 사용을 안내 |
 | `sd-check-bash.py` | PreToolUse hook (Bash) | 금지된 명령어 차단 (git stash/checkout/restore/reset/clean, cd, npx tsc, npx eslint) |
+| `sd-check-forbidden-files.py` | PreToolUse hook (Write/Edit) | `tsconfig.json`, `eslint.config.ts` 등 보호 파일 수정 차단 |
 | `sd-statusline.py` | statusLine hook | 상태바에 `폴더 | 모델 | 컨텍스트% | 5h사용량 | 7d사용량 | $추가요금` 표시 |
 
 → See [docs/hooks.md](./docs/hooks.md) for details.
@@ -49,9 +50,9 @@ npm install @simplysm/sd-claude
 
 | API | Type | Description |
 |-----|------|-------------|
-| `claude/skills/` | asset directory | 16개 sd-* 스킬 디렉토리 (각 스킬은 `SKILL.md` + 선택적 `references/` 포함) |
+| `claude/skills/` | asset directory | 16개 sd-* 스킬 디렉토리 (각 스킬은 `SKILL.md` + 선택적 `SKILL.eval.md`와 `references/` 포함) |
 | `claude/rules/` | asset directory | Claude Code 규칙 파일 (`sd-claude-rules.md`, `sd-options.md`) |
-| `claude/references/` | asset directory | 스킬/규칙에서 참조하는 공유 문서 (7개 md파일 + 1개 디렉토리) |
+| `claude/references/` | asset directory | 스킬/규칙에서 참조하는 공유 문서 및 패키지 문서 디렉토리 |
 
 → See [docs/assets.md](./docs/assets.md) for details.