@simplysm/sd-claude 13.0.83 → 13.0.85

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

@@ -1,126 +1,126 @@
 ---
 name: sd-readme
-description: "README 문서 생성", "sd-readme" 등을 요청할 때 사용.
+description: Used when requesting "README documentation generation", "sd-readme", etc.
 ---
 
-# SD Readme — 모노레포 패키지 README 문서 생성기
+# SD Readme — Monorepo Package README Documentation Generator
 
-모노레포의 각 패키지에 대해 README.md 문서를 자동 생성한다. 패키지 규모에 따라 단일 README.md 또는 README.md + docs/*.md 구조로 점진적 공개(Progressive Disclosure) 원칙을 적용한다.
+Automatically generates README.md documentation for each package in the monorepo. Applies Progressive Disclosure principles by choosing either a single README.md or a README.md + docs/*.md structure depending on the package size.
 
-ARGUMENTS: 패키지명 (선택). 지정하면 해당 패키지만 처리, 미지정 시 전체 패키지 병렬 처리.
+ARGUMENTS: Package name (optional). If specified, only that package is processed; if omitted, all packages are processed in parallel.
 
-## 작업 방법
+## Workflow
 
 ```mermaid
 flowchart TD
-    A[인자 파싱] --> B{패키지명 지정?}
-    B -- Yes --> C[README.md 생성]
-    B -- No --> D[public 패키지 목록 수집]
-    D --> E[패키지별 Agent 병렬 실행]
-    E -- 각 Agent --> C
+    A[Parse arguments] --> B{Package name specified?}
+    B -- Yes --> C[Generate README.md]
+    B -- No --> D[Collect public package list]
+    D --> E[Run Agent per package in parallel]
+    E -- Each Agent --> C
 ```
 
-### A. 인자 파싱
+### A. Parse Arguments
 
-스킬 호출 시 전달된 ARGUMENTS에서 패키지명을 추출하라.
+Extract the package name from the ARGUMENTS passed when invoking the skill.
 
-- **패키지명 지정됨** → `packages/` 하위에서 해당 디렉토리를 찾아 바로 **C. README.md 생성**으로 이동.
-- **패키지명 미지정** → **D. public 패키지 목록 수집**으로 이동.
+- **Package name specified** → Find the corresponding directory under `packages/` and proceed directly to **C. Generate README.md**.
+- **Package name not specified** → Proceed to **D. Collect public package list**.
 
-### C. README.md 생성
+### C. Generate README.md
 
-대상 패키지 하나에 대해 아래를 수행하라.
+Perform the following for a single target package.
 
-#### C-1. package.json 분석
+#### C-1. Analyze package.json
 
-`packages/<name>/package.json`을 읽어라:
+Read `packages/<name>/package.json`:
 
-1. `name` 및 `description`을 확인하라.
-2. `"private": true`이면 해당 패키지를 **건너뛰어라**.
-3. 패키지 진입점 소스코드가 무엇인지 확인하라.
+1. Check the `name` and `description` fields.
+2. If `"private": true`, **skip** this package.
+3. Identify the package entry point source code.
 
-#### C-2. 소스 코드 분석
+#### C-2. Analyze Source Code
 
-1. 진입점 파일 및 export를 재귀적으로 모두 읽어, 모든 public API를 수집하라.
-2. JSDoc 주석이 있으면 각 항목의 설명으로 활용하라.
+1. Recursively read the entry point file and all exports to collect every public API.
+2. If JSDoc comments exist, use them as descriptions for each item.
 
-#### C-3. 문서 구조 결정 및 생성
+#### C-3. Determine Document Structure and Generate
 
-소스 코드의 규모와 논리적 카테고리 수를 보고, 아래 두 가지 중 적절한 구조를 **자율적으로** 판단하라:
+Examine the source code size and the number of logical categories, then **autonomously** decide which of the two structures below is appropriate:
 
-- **단일 README.md**: 패키지가 작고 API가 적어 카테고리 분류가 불필요한 경우
-- **README.md + docs/*.md**: 패키지가 크거나 논리적 카테고리가 여러 개인 경우
+- **Single README.md**: When the package is small, has few APIs, and category classification is unnecessary
+- **README.md + docs/*.md**: When the package is large or has multiple logical categories
 
-기존 README.md 또는 docs/가 있으면 기존 내용을 기반으로 **변경된 부분만 수정**하라. 기존 문서가 없으면 새로 생성하라.
-구조가 변경되는 경우(B→A) 불필요해진 `docs/` 디렉토리를 삭제하라.
-**영어**로 작성하라.
+If an existing README.md or docs/ directory exists, **modify only the changed parts** based on the existing content. If no existing documentation exists, create it from scratch.
+If the structure changes (B to A), delete the now-unnecessary `docs/` directory.
+Write in **English**.
 
-#### C-4. package.json files 필드 관리
+#### C-4. Manage package.json files Field
 
-`docs/` 디렉토리 생성·삭제 시 `package.json`의 `files` 배열을 함께 업데이트하라:
+When creating or deleting the `docs/` directory, update the `files` array in `package.json` accordingly:
 
-- **구조 B 적용 시**: `files`에 `"docs"` 항목이 없으면 추가하라.
-- **구조 A 적용 시**: `files`에 `"docs"` 항목이 있으면 제거하라.
+- **When applying Structure B**: If the `files` array does not contain `"docs"`, add it.
+- **When applying Structure A**: If the `files` array contains `"docs"`, remove it.
 
 ---
 
-##### 구조 A: 단일 README.md (소규모 패키지)
+##### Structure A: Single README.md (Small Packages)
 
-`packages/<name>/README.md` 파일을 생성하라:
+Create the `packages/<name>/README.md` file:
 
 ```markdown
 # <package-name from package.json>
 
 > <description from package.json>
 
-<패키지의 주요 기능과 목적에 대한 상세 설명을 영어로 작성>
+<Write a detailed description of the package's main features and purpose in English>
 
 ## API Reference
 
 ### <exportedName>
 
 ```typescript
-<export 시그니처 코드>
+<export signature code>
 ```
 
-<해당 API에 대한 설명>
+<Description of this API>
 
 ---
 
-(... 모든 exported 항목에 대해 반복 ...)
+(... Repeat for all exported items ...)
 
 ## Usage Examples
 
 ```typescript
 import { ... } from "<package-name>";
 
-// 주요 사용 예제 코드
+// Main usage example code
 ```
 ```
 
 ---
 
-##### 구조 B: README.md + docs/*.md (대규모 패키지)
+##### Structure B: README.md + docs/*.md (Large Packages)
 
-**README.md** — `packages/<name>/README.md` 파일을 생성하라:
+**README.md** — Create the `packages/<name>/README.md` file:
 
 ```markdown
 # <package-name from package.json>
 
 > <description from package.json>
 
-<패키지의 주요 기능과 목적에 대한 상세 설명을 영어로 작성>
+<Write a detailed description of the package's main features and purpose in English>
 
 ## Documentation
 
 | Category | Description |
 |----------|-------------|
-| [<Category1>](docs/<category1>.md) | <카테고리 설명 및 주요 항목 나열> |
-| [<Category2>](docs/<category2>.md) | <카테고리 설명 및 주요 항목 나열> |
+| [<Category1>](docs/<category1>.md) | <Category description and list of key items> |
+| [<Category2>](docs/<category2>.md) | <Category description and list of key items> |
 | ... | ... |
 ```
 
-**docs/*.md** — 각 카테고리별로 `packages/<name>/docs/<category>.md` 파일을 생성하라:
+**docs/*.md** — Create a `packages/<name>/docs/<category>.md` file for each category:
 
 ```markdown
 # <Category Name>
@@ -128,39 +128,39 @@ import { ... } from "<package-name>";
 ## <exportedName>
 
 ```typescript
-<export 시그니처 코드>
+<export signature code>
 ```
 
-<해당 API에 대한 설명>
+<Description of this API>
 
 ---
 
-(... 이 카테고리의 모든 exported 항목에 대해 반복 ...)
+(... Repeat for all exported items in this category ...)
 
 ## Usage Examples
 
 ```typescript
 import { ... } from "<package-name>";
 
-// 이 카테고리의 주요 사용 예제 코드
+// Main usage example code for this category
 ```
 ```
 
-카테고리명과 분류는 소스 코드의 디렉토리 구조, 기능적 유사성 등을 고려하여 자율적으로 결정하라.
+Determine category names and classifications autonomously, considering the source code directory structure, functional similarity, etc.
 
 ---
 
-### D. public 패키지 목록 수집
+### D. Collect Public Package List
 
-`packages/*/package.json`을 Glob으로 탐색하되, `private: true`인 패키지는 제외하라.
+Use Glob to search `packages/*/package.json`, excluding packages with `private: true`.
 
 ---
 
-### E. 패키지별 Agent 병렬 실행
+### E. Run Agent Per Package in Parallel
 
-남은 각 패키지에 대해 Agent 도구를 사용하여 **병렬로** 다음 프롬프트를 전달하라:
+For each remaining package, use the Agent tool to pass the following prompt **in parallel**:
 ```
-/sd-readme <패키지명>
+/sd-readme <package-name>
 ```
 
-모든 subagent가 완료되면 종료.
+Terminate once all subagents have completed.

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

@@ -1,65 +1,72 @@
 ---
 name: sd-review
-description: "버그 리뷰", "bug review", "sd-review", "코드 리뷰", "버그 찾기" 등을 요청할 때 사용. 지정한 경로의 코드에서 잠재적 버그를 분석한 뒤 계획 수립을 거쳐 수정한다.
+description: Used when requesting "bug review", "sd-review", "code review", "find bugs", etc. Analyzes code at the specified path for potential bugs, then creates a plan and applies fixes.
 ---
 
-# SD Review — 잠재적 버그 탐지
+# SD Review — Potential Bug Detection
 
-지정한 경로의 코드를 읽고 잠재적 버그를 분석한 뒤, `/sd-plan` 프로세스로 계획을 수립하고 실행한다.
+Reads the code at the specified path, analyzes it for potential bugs, then creates and executes a plan via the `/sd-plan` process.
 
-ARGUMENTS: 대상 경로 (필수). 레포 내 임의 경로를 지정한다.
+ARGUMENTS: Target path (required). Specify any path within the repo.
 
 ---
 
-## Step 1: 인자 확인
+## Step 1: Validate Arguments
 
-1. ARGUMENTS에서 대상 경로를 추출하라.
-2. 경로가 없으면 "대상 경로를 지정해 주세요. 예: `/sd-review packages/my-pkg`"라고 안내하고 종료하라.
+1. Extract the target path from ARGUMENTS.
+2. If no path is provided, display "Please specify a target path. Example: `/sd-review packages/my-pkg`" and stop.
 
-## Step 2: 버그 분석 (수정 금지)
+## Step 2: Bug Analysis (Do Not Modify Code)
 
-대상 경로의 코드를 읽고 아래 5가지 관점에서 잠재적 버그를 찾아라.
-코드를 절대 수정하지 마라. 발견 항목 목록만 정리하여 출력하라.
+Read the code at the target path and search for potential bugs from the following 5 perspectives.
+Do not modify the code under any circumstances. Only compile and output a list of findings.
 
-**분석 관점:**
-1. **로직/정확성** — 잘못된 조건, off-by-one, 잘못된 연산자, 의도와 다른 분기
-2. **Null/Undefined 안전성** — 누락된 null 체크, optional chaining 미사용, 타입 단언 오용
-3. **에러 처리** — 삼켜진 에러, 누락된 catch, 부적절한 에러 전파
-4. **엣지 케이스** — 빈 배열/문자열, 경계값, 동시성/race condition, 누락된 await
-5. **리소스 관리** — 닫히지 않은 연결, 이벤트 리스너 누수, 메모리 릭 패턴
+**Analysis Perspectives:**
+1. **Logic/Correctness** — Incorrect conditions, off-by-one errors, wrong operators, unintended branching
+2. **Null/Undefined Safety** — Missing null checks, unused optional chaining, misuse of type assertions
+3. **Error Handling** — Swallowed errors, missing catch blocks, improper error propagation
+4. **Edge Cases** — Empty arrays/strings, boundary values, concurrency/race conditions, missing await
+5. **Resource Management** — Unclosed connections, event listener leaks, memory leak patterns
 
-각 항목은 다음 형식으로 작성하라:
+Write each finding in the following format:
 ```
-- **파일경로:라인** — 문제 설명 — 개선 방안
+- **filepath:line**
+  - Current code: (excerpt of the relevant code)
+  - Problem description:
+  - Suggested fix:
+  - Reasons to fix: Rationale for applying the fix
+  - Reasons not to fix: Rationale for keeping the current code
 ```
 
-발견 항목이 없으면 "잠재적 버그가 발견되지 않았습니다."라고 안내하고 종료하라.
+If no findings are discovered, display "No potential bugs were found." and stop.
 
-## Step 3: sd-plan으로 계획 수립
+## Step 3: Create Plan via sd-plan
 
-Step 2에서 도출된 발견 항목 목록을 작업 설명으로 하여, Skill 도구로 `sd-plan`을 호출하라. args에 아래를 전달하라:
+Using the list of findings from Step 2 as the task description, invoke `sd-plan` via the Skill tool. Pass the following as args:
 
 ```
-아래는 **LLM이 분석하여 제안한** 잠재적 버그 수정안이다.
-수정안은 사용자가 명시적으로 요청한 수정이 아니므로, 불명확한 것으로 취급하라.
+The following are potential bug fixes **analyzed and suggested by the LLM**.
+Since these fixes were not explicitly requested by the user, treat them as uncertain.
 
-## 대상
-<대상 경로>
+## Target
+<target path>
 
-## LLM 제안 수정안
-불명확한 수정안을 사용자에게 질문할 때, 아래 내용을 **반드시 먼저** 제시하여 사용자가 맥락을 파악할 수 있도록 하라.
+## LLM-Suggested Fixes
+When asking the user about uncertain fixes, **always present** the following information first so the user can understand the context.
 
 ```
-수정안:
-- 파일경로:라인:
-- 문제 설명:
-- 현재 코드: (해당 부분 코드 발췌)
-- 개선 방안:
+Fix:
+- Filepath:line:
+- Current code: (excerpt of the relevant code)
+- Problem description:
+- Suggested fix:
+- Reasons to fix:
+- Reasons not to fix:
 ```
 
-<Step 2에서 도출된 발견 항목 목록 전체>
+<Full list of findings from Step 2>
 ```
 
-## Step 4: 계획 실행
+## Step 4: Execute Plan
 
-sd-plan이 완료되어 확정된 계획서가 나오면, 그 계획서에 따라 코드를 수정하라.
+Once sd-plan completes and produces a finalized plan, apply the code modifications according to that plan.

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

@@ -1,59 +1,66 @@
 ---
 name: sd-simplify
-description: "코드 단순화", "simplify", "sd-simplify", "코드 정제" 등을 요청할 때 사용. 지정한 경로의 코드를 분석 후 계획 수립을 거쳐 수정한다.
+description: Used when requesting "code simplification", "simplify", "sd-simplify", "code refinement", etc. Analyzes code at a specified path, creates a plan, and applies modifications.
 ---
 
-# SD Simplify — 경로 지정 코드 단순화
+# SD Simplify — Path-Specific Code Simplification
 
-지정한 경로의 코드를 내장 `/simplify`로 분석한 뒤, `/sd-plan` 프로세스로 계획을 수립하고 실행한다.
+Analyzes code at a specified path using the built-in `/simplify`, then creates and executes a plan via the `/sd-plan` process.
 
-ARGUMENTS: 대상 경로 (필수). 레포 내 임의 경로를 지정한다.
+ARGUMENTS: Target path (required). Specify any path within the repository.
 
 ---
 
-## Step 1: 인자 확인
+## Step 1: Validate Arguments
 
-1. ARGUMENTS에서 대상 경로를 추출하라.
-2. 경로가 없으면 "대상 경로를 지정해 주세요. 예: `/sd-simplify packages/my-pkg`"라고 안내하고 종료하라.
+1. Extract the target path from ARGUMENTS.
+2. If no path is provided, display the message "Please specify a target path. Example: `/sd-simplify packages/my-pkg`" and stop.
 
-## Step 2: simplify 분석 (수정 금지)
+## Step 2: simplify Analysis (Do Not Modify)
 
-Skill 도구로 `simplify`를 호출하라. args에 아래 지침을 전달하라:
+Invoke `simplify` using the Skill tool. Pass the following instructions as args:
 
 ```
-<대상 경로> 경로의 현재 코드베이스를 대상으로 리뷰하라. (최근 변경 코드가 아님)
-단, 코드를 절대 수정하지 마라. 수정할 점 목록만 정리하여 출력하라.
-각 항목은 다음 형식으로 작성하라:
-- **파일경로:라인** — 문제 설명 — 개선 방안
+Review the current codebase at the <target path> path. (Not recently changed code)
+Do NOT modify any code. Only compile and output a list of items to fix.
+Write each item in the following format:
+- **file-path:line**
+  - Current code: (excerpt of the relevant code)
+  - Problem description:
+  - Suggested improvement:
+  - Reasons to change: Rationale for applying the improvement
+  - Reasons not to change: Rationale for keeping the current code
 ```
 
-`<대상 경로>` 부분은 Step 1에서 추출한 실제 경로로 치환하라.
+Replace the `<target path>` placeholder with the actual path extracted in Step 1.
 
-## Step 3: sd-plan으로 계획 수립
+## Step 3: Create a Plan with sd-plan
 
-Step 2에서 도출된 수정할 점 목록을 작업 설명으로 하여, Skill 도구로 `sd-plan`을 호출하라. args에 아래를 전달하라:
+Using the list of items to fix from Step 2 as the task description, invoke `sd-plan` using the Skill tool. Pass the following as args:
 
 ```
-아래는 **LLM이 분석하여 제안한** 코드 개선안이다.
-개선안은 사용자가 명시적으로 요청한 수정이 아니므로, 불명확한 것으로 취급하라.
+The following are code improvement suggestions **proposed by an LLM analysis**.
+Since these suggestions were not explicitly requested by the user, treat them as unclear.
 
-## 대상
-<대상 경로>
+## Target
+<target path>
 
-## LLM 제안 개선안
-불명확한 개선안을 사용자에게 질문할 때, 아래 내용을 **반드시 먼저** 제시하여 사용자가 맥락을 파악할 수 있도록 하라.
+## LLM-Suggested Improvements
+When asking the user about unclear suggestions, **always present** the following details first so the user can understand the context.
 
 ```
-개선안:
-- 파일경로:라인:
-- 문제 설명:
-- 현재 코드: (해당 부분 코드 발췌)
-- 개선 방안:
+Suggestion:
+- File path:line:
+- Current code: (excerpt of the relevant code)
+- Problem description:
+- Suggested improvement:
+- Reasons to change:
+- Reasons not to change:
 ```
 
-<Step 2에서 도출된 수정할 점 목록 전체>
+<Full list of items to fix from Step 2>
 ```
 
-## Step 4: 계획 실행
+## Step 4: Execute the Plan
 
-sd-plan이 완료되어 확정된 계획서가 나오면, 그 계획서에 따라 코드를 수정하라.
+Once sd-plan completes and a finalized plan is produced, modify the code according to that plan.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@simplysm/sd-claude",
-  "version": "13.0.83",
+  "version": "13.0.85",
   "description": "Simplysm Claude Code asset installer",
   "author": "simplysm",
   "license": "Apache-2.0",
@@ -10,6 +10,9 @@
     "directory": "packages/sd-claude"
   },
   "type": "module",
+  "bin": {
+    "sd-claude": "scripts/cli.mjs"
+  },
   "files": [
     "scripts",
     "claude"

package/scripts/cli.mjs

@@ -0,0 +1,12 @@
+#!/usr/bin/env node
+
+const command = process.argv[2];
+
+if (command === "postinstall") {
+  await import("./postinstall.mjs");
+} else {
+  console.log("Usage: sd-claude <command>");
+  console.log("Commands:");
+  console.log("  postinstall   Install Claude Code assets to .claude/");
+  process.exit(1);
+}

package/scripts/postinstall.mjs

@@ -46,7 +46,7 @@ try {
   console.warn("[@simplysm/sd-claude] postinstall warning:", err.message);
 }
 
-/** Finds the project root from INIT_CWD or node_modules path. */
+/** Finds the project root from INIT_CWD, node_modules path, or cwd. */
 function findProjectRoot(dirname) {
   if (process.env["INIT_CWD"] != null) {
     return process.env["INIT_CWD"];
@@ -55,7 +55,12 @@ function findProjectRoot(dirname) {
   const sep = path.sep;
   const marker = sep + "node_modules" + sep;
   const idx = dirname.indexOf(marker);
-  return idx !== -1 ? dirname.substring(0, idx) : undefined;
+  if (idx !== -1) {
+    return dirname.substring(0, idx);
+  }
+
+  // Fallback to cwd for manual CLI invocation (e.g., npx sd-claude postinstall)
+  return process.cwd();
 }
 
 /** Checks if this is the simplysm monorepo with the same major version. */
@@ -107,16 +112,27 @@ function setupSettings(targetDir) {
   // statusLine: always overwrite
   settings["statusLine"] = { type: "command", command: "python .claude/sd-statusline.py" };
 
+  // Migrate: move root-level SessionStart to hooks.SessionStart
+  if (settings["SessionStart"] != null) {
+    settings["hooks"] = settings["hooks"] ?? {};
+    settings["hooks"]["SessionStart"] = [
+      ...(settings["hooks"]["SessionStart"] ?? []),
+      ...settings["SessionStart"],
+    ];
+    delete settings["SessionStart"];
+  }
+
   // SessionStart: ensure sd-session-start hook exists with correct config
+  settings["hooks"] = settings["hooks"] ?? {};
   const sdSessionEntry = {
     matcher: "startup|resume|clear|compact",
     hooks: [{ type: "command", command: "bash .claude/sd-session-start.sh" }],
   };
 
-  const sessionStart = settings["SessionStart"];
+  const sessionStart = settings["hooks"]["SessionStart"];
 
   if (sessionStart == null) {
-    settings["SessionStart"] = [sdSessionEntry];
+    settings["hooks"]["SessionStart"] = [sdSessionEntry];
   } else {
     const idx = sessionStart.findIndex((entry) =>
       entry.hooks?.some((hook) => hook.command.includes("sd-session-start")),