@simplysm/sd-claude 13.0.78 → 13.0.81

package/claude/rules/sd-claude-rules.md

@@ -1,66 +1,7 @@
-# Claude Code Rules
+## 요청 수행 규칙
 
-## Language
+- 사용자가 명시적으로 수정을 요청하지 않은 경우, 코드를 절대 수정하지 않는다. (질문등에 대해 자의적 판단 금지)
 
-Respond in the **system's configured language** (set via Claude Code's language setting).
+## 코드 작성 규칙
 
-- Technical terms, code identifiers (variable names, function names, etc.), and library names should remain as-is
-- Show English error messages and logs in their original form, but provide explanations in the system language
-
-## Missing References
-
-If a referenced file or document cannot be found, **stop immediately and ask the user for the correct path.**
-
-- Do NOT skip or proceed on your own judgment.
-- Responses like "I couldn't find the file, so I'll skip it" are strictly prohibited.
-- Always confirm with the user before proceeding.
-
-## Scope of Work
-
-**Do only what is explicitly asked.** Never perform work that was not requested.
-
-### Questions vs. Code Requests — CRITICAL
-
-- **If the user asks a question** (e.g., "Why is this like this?", "What is this?", "How does this work?") → **answer with text only**. Do NOT edit, write, or create any files.
-- **If the user discusses, explains, or shares opinions** → **respond with text only**. Do NOT touch any files.
-- **Only edit/write/create files when the user explicitly requests code changes** (e.g., "Fix this", "Create this", "Change this", "Add this").
-- Reading files to answer a question is fine. **Modifying files to answer a question is prohibited.**
-
-### General Rules
-
-- When the user says "ask", "request", or "confirm" → **ask the user**. Do NOT decide or create it yourself.
-- Do NOT add features, refactoring, improvements, or documentation beyond the requested scope.
-- When in doubt, **ask first** before proceeding.
-- Responses like "I'll create it myself" or "I'll add that as well" are strictly prohibited.
-- **Do NOT comment on code outside the requested change.** This includes:
-  - Listing issues you noticed but did not fix
-  - Describing what you "left alone" or "did not change"
-  - "reference", "suggestions", "by the way", "note", "what I left alone"
-  - Any unsolicited observations about surrounding code quality
-  - Only describe **what you changed** — nothing else
-
-### Analysis & Comparison
-
-- When analyzing, comparing, diffing, or auditing: **enumerate all items exhaustively**. Never provide a shallow summary — list every difference, even minor ones.
-  - Example: v12 vs v13 migration gap → list ALL API, type, pattern differences item by item
-
-### Direct Action Requests
-
-- When the user provides a specific action (e.g., "rename X to Y", "delete this file"), **execute it directly**. Do not route through skill agents or sub-agent workflows for trivial operations.
-
-## Worktree Rules
-
-All git worktrees MUST be created under the **`.worktrees/`** directory (project root). Never use `.claude/worktrees/` or any other location.
-
-- When using `isolation: "worktree"` on Agent tool calls, the worktree is created in `.worktrees/`.
-- **After work is complete, you MUST delete the worktree and its branch** before finishing. No worktree may be left behind.
-- Prefer using the **`/sd-worktree`** skill for worktree creation/deletion. It includes fixes for Claude Code's built-in worktree bugs.
-
-## Asking Clarifying Questions
-
-When you need to ask the user a question, you MUST use the `AskUserQuestion` tool. Do NOT ask questions in plain text.
-
-- **Wrong:** Writing questions as text in your response
-- **Right:** Calling the `AskUserQuestion` tool
-
-**Before EVERY `AskUserQuestion` call, output `---` as the last line.** The widget clips text above it. No exceptions.
+- YAGNI 원칙 준수

package/claude/rules/sd-simplysm-usage.md

@@ -0,0 +1,7 @@
+# @simplysm 패키지 문서
+
+`@simplysm/*` 패키지의 API 상세 정보, 사용 예시, 컴포넌트 props 등이 필요할 때,
+해당 패키지의 README.md를 읽는다.
+
+1. 패키지의 README.md를 읽기: `packages/{package-name}/README.md`
+2. README.md에 `docs/` 인덱스(Documentation 테이블)가 있으면, 필요한 카테고리의 `docs/*.md` 파일만 추가로 읽기

package/claude/sd-session-start.sh

@@ -0,0 +1,10 @@
+#!/bin/bash
+echo "Read the following rule files before proceeding:"
+files=$(ls -1 .claude/rules/*.md 2>/dev/null)
+if [ -n "$files" ]; then
+  echo "$files" | while read f; do echo "- $f"; done
+fi
+echo
+if [ -f "CLAUDE.md" ]; then
+  echo "- CLAUDE.md"
+fi

package/claude/sd-statusline.py

@@ -0,0 +1,249 @@
+#!/usr/bin/env python3
+"""Claude Code statusline: folder | model | context% | 5h%(time) | 7d%(time)"""
+
+import json
+import os
+import re
+import subprocess
+import sys
+import tempfile
+import time
+from contextlib import contextmanager
+
+_IS_WINDOWS = os.name == "nt"
+if _IS_WINDOWS:
+    import msvcrt
+else:
+    import fcntl
+
+CACHE_FILE = os.path.expanduser("~/.claude/statusline-cache.json")
+CACHE_DIR = os.path.dirname(CACHE_FILE)
+LOCK_FILE = os.path.expanduser("~/.claude/statusline-cache.lock")
+CREDS_FILE = os.path.expanduser("~/.claude/.credentials.json")
+FETCH_INTERVAL = 180  # 3 minutes
+
+
+def format_model(model_id: str) -> str:
+    m = re.match(r"claude-(\w+)-(\d+)-(\d+)", model_id)
+    if m:
+        name = m.group(1).capitalize()
+        ver = f"{m.group(2)}.{m.group(3)}"
+        return f"{name} {ver}"
+    return model_id
+
+
+def format_remaining(reset_epoch: int) -> str:
+    delta = reset_epoch - time.time()
+    if delta <= 0:
+        return "0m"
+    total_min = int(delta / 60)
+    days = total_min // (24 * 60)
+    hours = (total_min % (24 * 60)) // 60
+    minutes = total_min % 60
+    if days > 0:
+        return f"{days}d{hours}h"
+    elif hours > 0:
+        return f"{hours}h{minutes}m"
+    else:
+        return f"{minutes}m"
+
+
+def read_cache():
+    try:
+        with open(CACHE_FILE) as f:
+            return json.load(f)
+    except (json.JSONDecodeError, OSError):
+        return None
+
+
+def should_fetch(cache):
+    if cache is None:
+        return True
+    last_ts = cache.get("last_fetch_ts", 0)
+    return (time.time() - last_ts) > FETCH_INTERVAL
+
+
+@contextmanager
+def _exclusive_lock():
+    fd = os.open(LOCK_FILE, os.O_CREAT | os.O_WRONLY, 0o600)
+    try:
+        if _IS_WINDOWS:
+            msvcrt.locking(fd, msvcrt.LK_NBLCK, 1)
+        else:
+            fcntl.flock(fd, fcntl.LOCK_EX | fcntl.LOCK_NB)
+        yield True
+    except (BlockingIOError, OSError):
+        yield False
+    finally:
+        if _IS_WINDOWS:
+            try:
+                msvcrt.locking(fd, msvcrt.LK_UNLCK, 1)
+            except OSError:
+                pass
+        os.close(fd)
+
+
+def _make_bucket(util, reset):
+    return {
+        "used_pct": round(float(util) * 100) if util is not None else None,
+        "reset_epoch": int(reset) if reset is not None else None,
+    }
+
+
+def try_spawn_fetch():
+    try:
+        with _exclusive_lock() as locked:
+            if locked:
+                subprocess.Popen(
+                    [sys.executable, os.path.abspath(__file__), "--fetch"],
+                    stdin=subprocess.DEVNULL,
+                    stdout=subprocess.DEVNULL,
+                    stderr=subprocess.DEVNULL,
+                    start_new_session=True,
+                )
+    except OSError:
+        pass
+
+
+def do_fetch():
+    try:
+        with _exclusive_lock() as locked:
+            if not locked:
+                return
+            _do_fetch_locked()
+    except OSError:
+        pass
+
+
+def _do_fetch_locked():
+    cache = read_cache()
+    if cache and not should_fetch(cache):
+        return
+
+    import urllib.request
+
+    try:
+        with open(CREDS_FILE) as f:
+            creds = json.load(f)
+        oauth = creds["claudeAiOauth"]
+        token = oauth["accessToken"]
+        expires_at = oauth.get("expiresAt", 0)
+
+        if expires_at < time.time() * 1000:
+            write_cache(cache, error="token_expired")
+            return
+
+        req = urllib.request.Request(
+            "https://api.anthropic.com/v1/messages",
+            data=json.dumps({
+                "model": "claude-haiku-4-5-20251001",
+                "max_tokens": 1,
+                "messages": [{"role": "user", "content": "quota"}],
+            }).encode(),
+            headers={
+                "Authorization": f"Bearer {token}",
+                "Content-Type": "application/json",
+                "anthropic-version": "2023-06-01",
+                "anthropic-beta": "oauth-2025-04-20",
+                "x-app": "cli",
+                "User-Agent": "claude-code/2.1.72",
+            },
+            method="POST",
+        )
+
+        resp = urllib.request.urlopen(req, timeout=15)
+        headers = resp.headers
+        resp.read()
+
+        buckets = {}
+        for key, prefix in (("five_hour", "5h"), ("seven_day", "7d")):
+            util = headers.get(f"anthropic-ratelimit-unified-{prefix}-utilization")
+            reset = headers.get(f"anthropic-ratelimit-unified-{prefix}-reset")
+            buckets[key] = _make_bucket(util, reset)
+
+        new_cache = {
+            "last_fetch_ts": time.time(),
+            **buckets,
+            "error": None,
+        }
+
+        write_cache_atomic(new_cache)
+    except Exception as e:
+        write_cache(cache, error=str(e))
+
+
+def write_cache(old_cache, error=None):
+    data = dict(old_cache) if old_cache else {}
+    data["last_fetch_ts"] = time.time()
+    data["error"] = error
+    write_cache_atomic(data)
+
+
+def write_cache_atomic(data):
+    fd, tmp_path = tempfile.mkstemp(dir=CACHE_DIR, suffix=".tmp")
+    try:
+        with os.fdopen(fd, "w") as f:
+            json.dump(data, f)
+        os.replace(tmp_path, CACHE_FILE)
+    except Exception:
+        try:
+            os.unlink(tmp_path)
+        except OSError:
+            pass
+
+
+def format_usage(bucket: dict) -> str:
+    pct = bucket.get("used_pct")
+    reset = bucket.get("reset_epoch")
+    if pct is not None and reset is not None:
+        return f"{pct}%({format_remaining(reset)})"
+    elif pct is not None:
+        return f"{pct}%"
+    return "?"
+
+
+def main():
+    # Read stdin JSON
+    try:
+        stdin_data = json.load(sys.stdin)
+    except Exception:
+        stdin_data = {}
+
+    # Extract folder
+    cwd = stdin_data.get("workspace", {}).get("current_dir") or stdin_data.get("cwd", "")
+    folder = os.path.basename(cwd) if cwd else "?"
+
+    # Extract model
+    model_id = stdin_data.get("model", {}).get("id", "")
+    model = format_model(model_id) if model_id else "?"
+
+    # Extract context %
+    ctx_pct = stdin_data.get("context_window", {}).get("used_percentage")
+    ctx_str = f"{ctx_pct}%" if ctx_pct is not None else "?"
+
+    # Read cached usage data
+    cache = read_cache()
+
+    if cache and not cache.get("error"):
+        h5_str = format_usage(cache.get("five_hour", {}))
+        d7_str = format_usage(cache.get("seven_day", {}))
+    else:
+        h5_str = "?"
+        d7_str = "?"
+
+    # Spawn background fetch if needed
+    if should_fetch(cache):
+        try_spawn_fetch()
+
+    # Output
+    print(f"{folder} | {model} | {ctx_str} | {h5_str} | {d7_str}")
+
+
+if __name__ == "__main__":
+    try:
+        if "--fetch" in sys.argv:
+            do_fetch()
+        else:
+            main()
+    except Exception:
+        pass  # statusline should never crash Claude Code

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

@@ -0,0 +1,89 @@
+---
+name: sd-api-review
+description: "API 리뷰", "api-review", "sd-api-review", "API 개선", "공개 API 검토", "API 직관성" 등을 요청할 때 사용.
+---
+
+# SD API Review — Public API 직관성 리뷰 및 개선
+
+지정한 경로(패키지/폴더/파일)의 public API를 추출하고, 관련 표준 및 유사 라이브러리와 비교하여 직관성 개선안을 도출한 뒤, `/sd-plan` 프로세스로 계획을 수립하여 구현한다. Breaking change를 허용하며 사용자 직관성을 최우선으로 한다.
+
+ARGUMENTS: 대상 경로 (필수). 예: `/sd-api-review packages/my-pkg`
+
+---
+
+## Step 1: 인자 확인
+
+1. ARGUMENTS에서 **대상 경로**를 추출하라. 경로가 없으면 "대상 경로를 지정해 주세요. 예: `/sd-api-review packages/my-pkg`"라고 안내하고 종료하라.
+
+## Step 2: Public API 추출
+
+대상의 public API를 수집하라.
+- **폴더/파일 대상**: 해당 경로의 export를 직접 분석
+- **깊이**: export된 심볼(클래스, 함수, 인터페이스, 타입, 상수) + export된 클래스의 public 메서드/프로퍼티
+
+export가 없으면 "대상에 export된 API가 없습니다."라고 안내하고 종료하라.
+
+## Step 3: 비교 분석 및 개선안 도출
+
+### 3-1. 비교 대상 결정
+
+- 패키지 메타데이터와 코드 내용을 분석하여 도메인을 추론하고, 해당 도메인에서 가장 널리 사용되는 다수의 라이브러리 자동 선정하라.
+- 관련 표준(HTML, WAI-ARIA, Web API, TC39, Javascript, CSS 등)도 도메인에 따라 자동으로 포함하라.
+
+### 3-2. 외부 API 조사
+
+WebSearch와 WebFetch를 사용하여 아래 두 축을 **동등한 비중**으로 조사하라.
+**카테고리/패턴 단위**로 비교하라 (개별 심볼마다 검색하지 않음).
+
+1. **표준**: 도메인 관련 표준의 공식 사양에서 네이밍, 속성, 패턴을 조사하라.
+2. **라이브러리**: 선정된 라이브러리들의 공식 문서에서 API를 조사하라.
+
+### 3-3. 개선안 도출
+
+Step 2의 API 카탈로그와 외부 API를 비교하여 개선점을 도출하라. 네이밍, 구조, 일관성, 패턴, 사용 편의성, 타입 품질 관점에서 검토하라.
+
+주의사항:
+- Breaking change는 고려대상이 아니다. 완전히 허용된다.
+- input/output/목적이 다를경우 동작이 다른경우, 제안이 잘못될 수 있음을 반드시 인지해야함. (자주하는 실수)
+
+각 개선안은 아래를 포함하라:
+- **현재**: 현재 API 상태 (코드 예시)
+- **제안**: 개선된 API (코드 예시)
+- **전환이유**: 변경해야 하는 근거 (표준/라이브러리 비교 포함)
+- **비전환이유**: 현재 상태를 유지해도 되는 근거
+
+## Step 4: sd-plan으로 구현 계획 수립
+
+Step 3에서 도출된 개선안을 작업 설명으로 하여, Skill 도구로 `sd-plan`을 호출하라. args에 아래를 전달하라:
+
+```
+아래는 **LLM이 분석하여 제안한** API 개선안이다.
+개선안은 사용자가 명시적으로 요청한 수정이 아니므로, 불명확한 것으로 취급하라.
+
+## 대상
+<대상 경로>
+
+## LLM 제안 개선안 — 비교 분석 표
+불명확한 개선안을 사용자에게 질문할 때, 아래 내용을 **반드시 먼저** 제시하여 사용자가 맥락을 파악할 수 있도록 하라.
+
+```
+개선안:
+- 현재:
+- 제안:
+- 전환이유:
+- 비전환이유:
+```
+
+## 구현 시 필수 고려사항
+1. Breaking change는 고려 대상이 아니다. 완전히 허용된다.
+2. 모노레포 전체에서 변경된 API의 사용처를 Grep으로 검색하여 함께 수정하라.
+3. deprecated 래퍼를 남기지 않는다 (clean break).
+```
+
+## Step 5: 계획 실행
+
+sd-plan이 완료되어 확정된 계획서가 나오면, 그 계획서에 따라 코드를 수정하라.
+
+## Step 6: README 업데이트 추천
+
+코드 수정이 발생한 경우, 사용자에게 `/sd-readme` 수행을 추천하라.

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

@@ -1,71 +1,69 @@
 ---
 name: sd-check
-description: "Typecheck, lint, test verification (explicit invocation only)"
+description: "체크", "check", "sd-check", "타입체크+린트+테스트", "전체 검사" 등을 요청할 때 사용.
 ---
 
-# sd-check
+# SD Check — 자동 검사 및 오류 수정 루프
 
-Run `$PM run check`, fix errors, repeat until clean.
+패키지 매니저를 감지하고 check 스크립트를 실행하여 결과를 확인한 뒤, 코드 오류가 있으면 sd-debug로 근본 원인을 분석·수정하고 재검사하는 과정을 오류가 없을 때까지 반복한다.
 
-## Package Manager Detection
+ARGUMENTS: 타겟 경로 (선택, 복수 가능). 미지정 시 대화 컨텍스트에서 파악하며, 특정 타겟이 없거나 "전체/all"이면 타겟 없이 실행.
 
-Before running any commands, detect the package manager:
-- If `pnpm-lock.yaml` exists in project root → use `pnpm`
-- If `yarn.lock` exists in project root → use `yarn`
-- Otherwise → use `npm`
+---
 
-`$PM` in all commands below refers to the detected package manager.
+## Step 1: 준비 (PM 감지 + 스크립트 확인 + 타겟 결정)
 
-## Usage
+1. **PM 감지**: 프로젝트 루트의 락 파일로 판별하라.
+   - `pnpm-lock.yaml` 존재 → `pnpm`
+   - `yarn.lock` 존재 → `yarn`
+   - `package-lock.json` 존재 → `npm`
+   - 모두 없으면 → `npm` (기본값)
+2. **스크립트 확인**: `package.json`의 `scripts.check` 존재 여부를 확인하라. 없으면 `"check 스크립트가 package.json에 정의되어 있지 않습니다."` 안내 후 **종료**.
+3. **타겟 결정**: 아래 우선순위로 결정하라.
+   1. ARGUMENTS에 명시된 타겟
+   2. 현재 대화 컨텍스트에서 파악 (사용자가 특정 패키지 작업 중인 경우)
+   3. 위 둘 모두 해당 없거나 "전체/all" → 타겟 없이 실행 (전체)
+
+## Step 2: 검사 실행
+
+1. `mkdir -p .tmp/check` (Bash)
+2. Bash로 아래 명령을 실행하라:
+   ```
+   $PM check [targets...] > .tmp/check/{yyMMddHHmmss}.txt 2>&1; echo "EXIT_CODE:$?" >> .tmp/check/{yyMMddHHmmss}.txt
+   ```
+   - `$PM` = Step 1에서 감지한 패키지 매니저
+   - `{yyMMddHHmmss}` = 연월일시분초
+   - 타겟이 있으면 명령에 포함, 없으면 생략
+3. Read 도구로 결과 파일(`.tmp/check/{yyMMddHHmmss}.txt`)을 읽어라.
+
+## Step 3: 결과 분석
+
+결과 파일 내용을 읽고 아래 세 가지 중 하나로 분류하라:
+
+- **성공**: 오류 없이 모든 검사를 통과한 경우 → **Step 5(완료)**로 이동
+- **환경 오류**: 코드 문제가 아닌 환경/인프라 문제로 판단되는 경우 (예: 의존성 미설치, 메모리 부족, 명령어 없음, 네트워크 문제 등) → 사용자에게 해당 오류 내용을 보여주고 **즉시 종료**. 코드 수정을 시도하지 않는다.
+- **코드 오류**: 소스 코드의 타입 에러, 린트 위반, 테스트 실패 등으로 판단되는 경우 → **Step 4**로 이동
+
+> 위 분류는 하드코딩된 패턴 매칭이 아닌, 결과 내용을 읽고 자유롭게 판단한다.
+
+**반복 제한**: 현재 반복 횟수가 5회를 초과하면, 잔여 오류를 사용자에게 보고하고 `"5회 반복 후에도 오류가 남아 있습니다. 남은 오류를 확인해 주세요."` 안내 후 **종료**.
+
+## Step 4: 오류 분석 및 수정 (sd-debug 활용)
+
+Skill 도구로 `sd-debug`를 호출하라. args에 아래 내용을 전달하라:
 
 ```
-$PM run check [path] [--type typecheck|lint|test]
-```
+아래 check 결과의 코드 오류를 분석하라.
+**중요: Step 2(코드베이스 심층 분석) 완료 후 Step 3~5를 건너뛰고, 분석 결과를 바탕으로 바로 코드를 수정하라. 진단 보고서 출력, 사용자 확인, sd-plan 호출 없이 즉시 수정한다.**
 
-| Example                               | Effect                    |
-| ------------------------------------- | ------------------------- |
-| `/sd-check`                           | Full project, all checks  |
-| `/sd-check packages/core-common`      | Specific path, all checks |
-| `/sd-check test`                      | Tests only, full project  |
-| `/sd-check packages/core-common lint` | Specific path + type      |
-
-Multiple types: `--type typecheck,lint`. No path = full project. No type = all checks.
-
-## Workflow
-
-```mermaid
-flowchart TD
-    A[Run check] --> B{All passed?}
-    B -->|yes| C[Report results → done]
-    B -->|no| D["Fix errors (typecheck → lint → test)"]
-    D --> E{Stuck after 2-3 tries?}
-    E -->|no| A
-    E -->|yes| F[Recommend /sd-debug]
+<.tmp/check/{yyMMddHHmmss}.txt 의 오류 내용을 여기에 포함>
 ```
 
-**Run command:** `$PM run check [path] [--type type]` (timeout: 600000)
-
-- **Output capture:** Bash truncates long output. Always redirect to a file and read it:
-  ```bash
-  mkdir -p .tmp && $PM run check [path] [--type type] > .tmp/check-output.txt 2>&1; echo "EXIT:$?"
-  ```
-  Then use the **Read** tool on `.tmp/check-output.txt` to see the full result. Check `EXIT:0` for success or non-zero for failure.
-
-**Fixing errors:**
-- **Before fixing any code**: Read `.claude/refs/sd-code-conventions.md` and check `.claude/rules/sd-refs-linker.md` for additional refs relevant to the affected code area (e.g., `sd-solid.md` for SolidJS, `sd-orm.md` for ORM). Fixing errors does NOT exempt you from following project conventions.
-- Test failures: **MUST** run `git log` to decide — update test or fix source
-- **E2E test failures**: use Playwright MCP to investigate before fixing
-  1. `browser_navigate` to the target URL
-  2. `browser_snapshot` / `browser_take_screenshot` (save to `.tmp/playwright/`) to see page state
-  3. `browser_console_messages` for JS errors
-  4. `browser_network_requests` for failed API calls
-  5. Interact with the page following the test steps to reproduce the failure
-  6. Fix based on observed evidence, not guesswork
-
-## Rules
-
-- **Always re-run ALL checks** after any fix — never assume other checks still pass
-- **Report with evidence** — cite actual numbers (e.g., "0 errors, 47 tests passed"), not "should work"
-- **No build, no dev server** — typecheck + lint + test only
-- **Run Bash directly** — no Task/agent/team overhead
-- **Never run in background** — always run Bash in foreground (do NOT set `run_in_background: true`), wait for result before proceeding
+sd-debug 완료 후 → **Step 2**로 복귀 (새로운 txt로 재검사)
+
+## Step 5: 완료 보고
+
+모든 검사 통과 시 아래를 출력하라:
+- 총 반복 횟수
+- 각 반복에서 수정한 내용 요약
+- 형식: `"✔ 체크 완료: {N}회 만에 모든 검사를 통과했습니다."` + 수정 내역 bullet list

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

@@ -1,68 +1,63 @@
 ---
 name: sd-commit
-description: "Git commit with conventional messages (explicit invocation only)"
-argument-hint: "[all]"
-model: haiku
+description: "커밋", "commit", "sd-commit" 등을 요청할 때 사용.
 ---
 
-# sd-commit
+# SD Commit — 변경사항 분석 후 커밋
 
-## Overview
+변경사항을 스테이징하고, 변경 내용을 분석하여 커밋 메시지를 생성한 뒤 커밋한다.
 
-Stages and commits changes using Conventional Commits format. Two modes: **default** (context-relevant files, single commit) and **all** (all changed files, single commit).
+ARGUMENTS: `all` (선택). 지정하면 모든 변경사항 대상, 미지정 시 대화 내 수정 파일만 대상.
 
-## Mode
-
-- **Default mode** (no arguments): Stage files relevant to the current conversation context. Always a **single commit**.
-- **"all" mode** (`$ARGUMENTS` is "all"): Target **all** changed/untracked files. Always a **single commit**.
+---
 
-## File Selection Rules
+## Step 1: 인자 파싱 및 스테이징
 
-**NEVER arbitrarily exclude files.** The ONLY valid reason to exclude a file is:
+ARGUMENTS에서 `all` 여부를 확인하라.
 
-- It is in `.gitignore`
-- It is completely unrelated to the conversation context (default mode only)
+- **`all`**: 워킹 트리의 모든 변경사항(수정, 삭제, 신규)을 스테이징하라.
+- **`all`이 아니거나 인자 없음**: 현재 대화에서 Edit 또는 Write 도구로 수정하거나 생성한 파일들만 스테이징하라. 대화 컨텍스트를 되돌아보며 해당 파일 목록을 추출하라.
 
-**Do NOT exclude files based on:**
+## Step 2: 변경사항 확인
 
-- File type or extension (e.g., `.styles.ts`, `.config.ts`)
-- Folder name or path (e.g., `node_modules` is handled by `.gitignore`)
-- Personal judgment about importance or "cleanliness"
-- Assumption that generated/config/style files are unimportant
+스테이징된 변경사항이 없으면 "커밋할 변경사항이 없습니다."라고 안내하고 **종료**하라.
 
-**When in doubt, INCLUDE the file.** Over-inclusion is always better than silent exclusion.
+## Step 3: 커밋 메시지 생성 및 커밋
 
-## Context
+스테이징된 diff를 분석하여 아래 규칙에 따라 커밋 메시지를 생성하고 커밋하라.
 
-- Current status: !`git status`
-- Current diff: !`git diff HEAD`
-- Current branch: !`git branch --show-current`
-- Recent commits: !`git log --oneline -10`
+### 커밋 메시지 규칙
 
-## Commit Message Format
+- **Conventional Commits** 형식: prefix + 설명
+  - prefix 예: `feat`, `fix`, `refactor`, `chore`, `docs`, `style`, `test`, `perf`, `ci`, `build`
+- **subject** (첫 줄): 변경 요약. 70자 이내.
+- **body**: 빈 줄 후 주요 변경 내용을 나열. 여러 주제의 변경이 섞여 있으면 주제별로 `[prefix]` 태그를 붙여 그룹화하라.
+- 마지막에 `Co-Authored-By: Claude <noreply@anthropic.com>` 포함.
 
+단일 주제 예시:
 ```
-type(scope): short description
-```
+feat: 사용자 인증 로직 추가
 
-| Field         | Values                                                                       |
-| ------------- | ---------------------------------------------------------------------------- |
-| `type`        | `feat`, `fix`, `refactor`, `docs`, `test`, `chore`, `build`, `style`, `perf` |
-| `scope`       | package name or area (e.g., `solid`, `core-common`, `orm-node`)              |
-| `description` | English, imperative, lowercase, no period at end |
+- AuthService에 JWT 토큰 검증 로직 구현
+- 로그인 페이지에 폼 유효성 검사 추가
 
-Examples:
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
 
-- `feat(solid): add Select component`
-- `fix(orm-node): handle null values in bulk insert`
-- `docs: update README with new API examples`
+여러 주제 예시:
+```
+chore: 인증 기능 추가 및 결제 오류 수정
 
-Use a HEREDOC for multi-line messages when needed.
+[feat] 사용자 인증
+- AuthService에 JWT 토큰 검증 로직 구현
+- 로그인 페이지에 폼 유효성 검사 추가
 
-## Execution
+[fix] 결제 모듈
+- 결제 실패 시 재시도 로직 수정
 
-**Default mode:** `git add <context-relevant files>` → `git commit`
+Co-Authored-By: Claude <noreply@anthropic.com>
+```
 
-**All mode:** `git add .` → `git commit` with a single message summarizing all changes (message may be long).
+## Step 4: 결과 출력
 
-Call multiple tools in one response when possible. Do not use other tools or output other text.
+커밋 완료 후 커밋 메시지 전문을 사용자에게 보여줘라.