dandap 0.0.0-stage → 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 bottleroad
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,318 @@
-# Temporary Holding Version
+# dandap (단답) 🤫
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+> **"불필요한 미사여구는 버리고, 기술적 팩트와 페이로드만 남긴다."**
+> [JuliusBrussee/caveman](https://github.com/JuliusBrussee/caveman)에서 영감을 받아 만든 **AI 코딩 에이전트용 한국어 개조식 단답 스킬**이다.
+
+---
+
+## ⚡ 왜 단답(dandap)인가?
+
+1. **출력 토큰 절약**: 의례적 인사말과 완곡어법을 걷어내 응답을 줄인다. 측정 결과 출력 토큰 중앙값이 일반 대비 단답 -25.6%, 초단답 -53.8%였다. 단, 단답은 "간결하게 답해줘" 한 줄보다 길었다([측정 결과](#-토큰-절약-효과)).
+2. **터미널 가독성**: 엔지니어에게 필요한 것은 [결함 원인], [수정 내용], [다음 조치]뿐이다.
+3. **한국어 최적화**: 번역 투가 아닌 실무 개발팀의 개조식 보고 톤(`~함`, `~음`, `조치 완료`)으로 답한다.
+4. **페이로드 원문 보존**: 코드, 파일 경로, CLI 명령어, 에러 메시지 원문은 한 글자도 바꾸거나 줄이지 않는다.
+
+---
+
+## 🎛️ 모드 비교
+
+| 구분 | 일반 모드 (Normal) | **dandap (단답)** | **chodandap (초단답)** |
+| :--- | :--- | :--- | :--- |
+| **명령어** | 기본 | `/dandap` | `/chodandap` (또는 `/dandap cho`) |
+| **톤** | 친절하고 완전한 구어체 문장 | 간결한 개조식·명사형 종결 (`~함`, `~음`) | 단어·파편(Fragment) 나열, 어미 생략 |
+| **조사** | 모두 유지 | 유지가 기본. 관계가 자명할 때만 `은/는`, `의` 생략 | 자명한 격조사 생략 허용. `만`/`도`/`조차`는 보존 |
+| **답변 예시** | "확인해보니 토큰 만료 조건문에 버그가 있었습니다. `<`를 `<=`로 변경하여 수정했습니다. 서버를 재시작해 주세요." | "auth 미들웨어 토큰 만료 조건 오류 확인됨. `<` 연산자를 `<=`로 수정함. 재기동 필요." | "인증 오류. `<` 대신 `<=`. 수정 완료. 재시작." |
+| **추천 상황** | 복잡한 개념 학습, 설명 요구 | **일반 개발, 코드 리뷰, 기능 구현** | **긴급 디버깅, 좁은 터미널, 반복 루프** |
+
+두 모드 공통 규칙:
+
+* 결론부터 말하고, 인사·완곡어법·마무리 인사를 쓰지 않는다.
+* 부정어(`안`, `못`, `아님`, `제외`, `금지`, `실패`)는 생략하지 않는다.
+* 두 가지로 읽히는 문장, 순서가 중요한 절차, 보안 경고, 파괴적 작업 확인, 사용자에게 하는 질문은 완전한 문장으로 쓴다.
+* 질문 언어와 무관하게 한국어로 답한다.
+* 코드, 주석, 커밋, PR, 문서 등 채팅 밖에 남는 산출물은 단답체가 아닌 평서체(`-다`)로 쓴다.
+
+---
+
+## 🚀 사용법
+
+### 켜기
+
+* `/dandap`, `단답`, `단답 모드`: 단답 모드
+* `/chodandap`, `초단답`, `/dandap cho`: 초단답 모드
+
+### 끄기
+
+아래 형태만 종료로 인정한다.
+
+* 명령: `/dandap off`, `/dandap 종료`, `/dandap 해제`, `/chodandap off`
+* 문구: `단답 종료`, `단답 해제`, `초단답 해제`, `단답 모드 종료해줘`
+* 프롬프트 전체가 `normal mode` 또는 `원래대로`
+
+다음은 종료로 보지 않는다.
+
+* 단독 종료어: `그만`, `끝`, `취소`, `stop`, `off`
+* 작업 요청: `빌드 취소해줘`, `서버 stop 명령어 알려줘`
+* 부정문: `단답 끄지 마`, `단답 종료하지 마`
+* 문장 중간의 `normal mode`: `vim normal mode 나가는 법`
+
+### 상태 확인
+
+* `/dandap status`: 모드를 바꾸지 않고 `단답 모드: <dandap|chodandap|off>` 한 줄로 보고한다.
+* hook이 없는 환경(Codex, agy, Gemini CLI)에서는 `(세션 추적 안 됨)`이 붙는다.
+
+### 관련 스킬
+
+| 스킬 | 호출 | 역할 |
+|---|---|---|
+| `dandap-help` | `/dandap-help`, `단답 도움말` | 모드·명령 요약 카드 |
+| `dandap-commit` | `/dandap-commit` | Conventional Commits 접두어 + 한국어 평서체 커밋 메시지 작성 |
+| `dandap-review` | `/dandap-review` | 한 줄 한 지적(위치·문제·수정안) 한국어 코드 리뷰 |
+
+`dandap-commit`, `dandap-review`, `chodandap`은 `disable-model-invocation: true`로 설정되어 있어 명시적으로 호출할 때만 동작한다. Claude Code와 agy에서는 이 설정이 적용되었지만, Codex는 이 설정을 따르지 않는 것으로 보인다([지원 도구](#-지원-도구) 참고).
+
+---
+
+## 🧩 지원 도구
+
+2026-11-14에 도구별 비대화형 실행으로 스킬 목록 조회와 실제 호출을 확인했다.
+
+| 항목 | Claude Code (`2.1.319`) | Codex (`0.167.0`) | agy, Antigravity (`1.5.9`) |
+|---|---|---|---|
+| 스킬 경로 | `~/.claude/skills/<스킬>` | `~/.codex/skills/<스킬>` | `~/.gemini/skills/<스킬>` (`~/.gemini/config/skills`도 읽음) |
+| 호출 문법 | `/dandap`, `/chodandap` | `$dandap`, `$chodandap` | `/dandap`, `/chodandap` |
+| 단답·초단답 응답 | 확인 | 확인 | 확인 |
+| `disable-model-invocation` | 적용 (모델 목록에서 숨김, 직접 호출은 동작) | 미적용으로 보임 (모델 목록에 5개 모두 표시) | 적용 (모델 목록에서 숨김, 직접 호출은 동작) |
+| hook (compact 후 유지, `status` 추적) | 지원 | 미적용 | 미적용 |
+| 슬래시 명령 래퍼 | `~/.claude/commands` | 없음 | 없음 |
+
+* Gemini CLI는 `~/.gemini/skills`, `~/.gemini/commands`를 agy와 함께 쓰도록 연결되어 있지만, 동작은 확인하지 않았다.
+* Codex와 agy는 1회성 질문만 확인했다. 여러 턴에 걸친 모드 유지와 `off`·`status` 인자 처리는 확인하지 않았다.
+
+---
+
+## 📁 구성
+
+```
+dandap/
+├── skills/
+│   ├── dandap/SKILL.md          # dandap(단답) 스킬
+│   ├── chodandap/SKILL.md       # chodandap(초단답) 스킬
+│   ├── dandap-help/SKILL.md     # 도움말 카드
+│   ├── dandap-commit/SKILL.md   # 커밋 메시지 스킬
+│   └── dandap-review/SKILL.md   # 코드 리뷰 스킬
+├── commands/                # 슬래시 명령 래퍼 (off·status·cho 인자 처리)
+│   ├── claude/dandap.md, chodandap.md
+│   └── gemini/dandap.toml, chodandap.toml
+├── hooks/                   # Claude Code hook (모드 유지)
+│   ├── dandap-activate.js       # SessionStart: compact·resume 후 규칙 재주입
+│   ├── dandap-mode-tracker.js   # UserPromptSubmit: 명령 감지, 매 턴 리마인더
+│   ├── dandap-parse.js          # 활성화·종료·상태 판정
+│   ├── dandap-state.js          # 세션별 상태 파일 읽기·쓰기
+│   └── dandap-rules.js          # 주입할 규칙 전문·리마인더 문구
+├── installer/install.js     # npx 설치 스크립트 (설치·hook 병합·제거)
+├── tests/                   # node:test 테스트 (판정·상태·hook 입출력·설치)
+└── bench/measure.py         # claude -p 토큰 측정 스크립트
+```
+
+---
+
+## 📂 설치
+
+### npx로 설치 (권장)
+
+```bash
+npx dandap@latest                # 스킬 + 슬래시 명령 래퍼
+npx dandap@latest --with-hooks   # 위 항목 + Claude Code hook
+npx dandap@latest --uninstall    # 제거
+```
+
+* 파일을 `~/.dandap`에 복사하고, `~/.claude`, `~/.codex`, `~/.gemini` 중 있는 도구에만 링크한다.
+* 같은 이름이 링크가 아닌 실제 파일·디렉터리로 있으면 덮어쓰지 않고 건너뛴다. 다른 곳을 가리키는 링크는 `~/.dandap`을 가리키도록 교체한다.
+* `--with-hooks`는 `~/.claude/settings.json`을 `settings.json.dandap-backup-<UTC 시각>`으로 백업한 뒤 hook을 병합한다. 다른 위치에 등록된 dandap hook은 중복 주입을 막기 위해 교체한다.
+* `--uninstall`은 `~/.dandap`을 가리키는 링크와 hook, `~/.dandap`만 지운다. 상태 파일(`~/.claude/.dandap-sessions`)은 남긴다.
+* 설치 후 실행 중인 에이전트 세션은 다시 시작해야 적용된다.
+* macOS에서만 확인했다. Windows는 확인하지 않았다.
+
+아래 1~3은 저장소를 직접 연결하는 수동 설치 방법이다.
+
+### 1. 스킬 링크
+
+저장소를 내려받은 위치를 `DANDAP_DIR`로 둔다. 아래는 Claude Code, Codex, agy(Antigravity), Gemini CLI에서 같은 스킬을 쓰도록 `~/.agents/skills`를 거쳐 연결하는 구성이다.
+
+```bash
+DANDAP_DIR="$HOME/workspace/my-skills/dandap"   # 저장소 위치에 맞게 수정
+
+for s in dandap chodandap dandap-help dandap-commit dandap-review; do
+  ln -s "$DANDAP_DIR/skills/$s" "$HOME/.agents/skills/$s"        # 공용 경로
+  ln -s "../../.agents/skills/$s" "$HOME/.claude/skills/$s"      # Claude Code
+  ln -s "$HOME/.agents/skills/$s" "$HOME/.codex/skills/$s"       # Codex
+  ln -s "$DANDAP_DIR/skills/$s" "$HOME/.gemini/skills/$s"        # agy, Gemini CLI
+done
+```
+
+* agy는 `~/.gemini/config/skills`도 읽는다. 이 경로를 `~/.agents/skills`로 연결해 두었다면 `~/.gemini/skills` 링크 없이도 인식될 수 있지만, 그 구성만으로 따로 확인하지는 않았다.
+* 이전 이름 `ultradandap`의 링크가 남아 있으면 지운다. 대상이 없는 링크가 된다.
+
+### 2. 슬래시 명령 래퍼 (선택)
+
+인자(`off`, `status`, `cho`) 처리 규칙을 담은 명령 래퍼다. `commands/`에 있으며, 각 도구의 명령 디렉터리에 링크한다.
+
+```bash
+for f in dandap chodandap; do
+  ln -s "$DANDAP_DIR/commands/claude/$f.md" "$HOME/.claude/commands/$f.md"
+  ln -s "$DANDAP_DIR/commands/gemini/$f.toml" "$HOME/.gemini/commands/$f.toml"
+done
+```
+
+
+* Claude Code: `~/.claude/commands/dandap.md`, `~/.claude/commands/chodandap.md`
+* Gemini CLI: `~/.gemini/commands/dandap.toml`, `~/.gemini/commands/chodandap.toml`
+* Codex, agy: 래퍼 없음. 스킬을 직접 호출한다.
+
+### 3. hook (Claude Code 전용, 선택)
+
+스킬 문서만으로는 `/compact` 이후 모드가 풀리는 문제를 막을 수 없다. hook을 등록하면 세션별 모드를 파일에 기록하고, compact·resume 뒤에 규칙을 다시 주입한다.
+
+`~/.claude/settings.json`의 `hooks`에 아래 두 항목을 추가한다. 기존 hook 항목이 있으면 덮어쓰지 말고 배열에 병합한다. 경로는 `DANDAP_DIR`에 맞게 바꾼다. hook은 스킬 디렉터리가 아닌 저장소의 `hooks/`에 있다.
+
+```json
+{
+  "hooks": {
+    "SessionStart": [
+      { "hooks": [{ "type": "command", "command": "node \"$HOME/workspace/my-skills/dandap/hooks/dandap-activate.js\"" }] }
+    ],
+    "UserPromptSubmit": [
+      { "hooks": [{ "type": "command", "command": "node \"$HOME/workspace/my-skills/dandap/hooks/dandap-mode-tracker.js\"" }] }
+    ]
+  }
+}
+```
+
+* 상태 파일 위치: `~/.claude/.dandap-sessions/<session_id>.mode` (`CLAUDE_CONFIG_DIR`, `DANDAP_STATE_DIR`로 변경 가능)
+* 새 세션(`startup`)과 `/clear`는 기본 off로 시작한다. `/dandap off` 후에는 compact해도 다시 켜지지 않는다.
+* `/dandap`, `/chodandap` 슬래시 명령으로 켜면 Claude Code가 스킬 본문을 로드하므로 hook은 리마인더만 주입한다. `단답`처럼 자연어로 켜거나 `/dandap cho`로 전환할 때만 hook이 규칙 전문을 주입한다.
+* Claude Code는 compact 뒤 세션 중 호출된 스킬 본문을 스스로 복원한다. 이 본문이 현재 모드와 어긋나지 않도록, SessionStart hook이 마지막에 현재 모드(off면 "복원된 단답 규칙을 따르지 않음")를 한 줄로 주입한다.
+* caveman 플러그인 리마인더와 동시에 주입되면 단답 규칙을 우선하도록 리마인더에 명시되어 있다.
+
+### 4. 테스트
+
+```bash
+cd "$DANDAP_DIR" && node --test
+```
+
+Node.js 22 이상, 외부 의존성 없음.
+
+---
+
+## ⚙️ hook 동작 요약
+
+| 시점 | 상황 | 주입 내용 |
+|---|---|---|
+| UserPromptSubmit | `/dandap`, `/chodandap`으로 켬 | 리마인더만 (스킬 본문은 Claude Code가 로드) |
+| UserPromptSubmit | `단답`, `초단답`(자연어)으로 켬, `/dandap cho`로 전환 | 규칙 전문 + 리마인더 |
+| UserPromptSubmit | 활성 상태의 일반 턴 | `DANDAP MODE ACTIVE (<mode>)` 리마인더 1줄 |
+| UserPromptSubmit | `/dandap status` | `단답 모드: <mode>` 보고 지시 (모드 변경 없음) |
+| UserPromptSubmit | 종료 명령 | off 기록, 1줄 복귀 확인 지시 |
+| SessionStart | `startup` | 없음 (기본 off) |
+| SessionStart | `clear` | off로 초기화 |
+| SessionStart | `compact`, `resume` 등, 활성 모드 | 규칙 전문 + 리마인더 + 마지막 줄 `현재 단답 모드: <mode>` |
+| SessionStart | `compact`, `resume` 등, off | `단답 모드: off. 복원된 스킬 규칙을 따르지 말 것` 1줄 |
+
+* 다른 슬래시 명령(`/review` 등)의 인자와 예약 작업(`<scheduled-task>`)은 판정하지 않는다.
+* `session_id`에 경로 문자가 있으면 상태 파일을 만들지 않는다.
+* hook 오류가 나도 항상 exit 0으로 끝나 프롬프트와 세션 시작을 막지 않는다.
+
+---
+
+## ✅ 검증
+
+* **자동 테스트**: 94개 통과. 활성화·종료·"종료 아님"·상태 판정 코퍼스, 상태 파일, hook 입출력, 임시 HOME에서의 설치·hook 병합·제거를 검증한다.
+* **실제 세션 검증** (2026-11-14, tmux로 띄운 대화형 Claude Code 세션 2회):
+
+| 확인 항목 | 결과 |
+|---|---|
+| `/dandap` 후 명사형 종결 응답, 활성화 선언 없음 | 통과 |
+| `/dandap status`가 `단답 모드: dandap` 보고 | 통과 |
+| `빌드 취소해줘`에 모드 유지 | 통과 |
+| `/compact` 후 단답·초단답 유지 | 통과 |
+| `/dandap off` 후 `/compact`해도 다시 켜지지 않음 | 통과 |
+| 초단답에서 `만`/`도` 보존 (`삭제는 admin만 허용.`, `본인 글도 user 삭제 불가.`) | 통과 |
+| caveman 리마인더와 동시 주입 시 단답체 유지 | 통과 |
+
+---
+
+## 📏 토큰 절약 효과
+
+2026-11-14, `bench/measure.py`로 측정했다.
+
+* 방식: `claude -p`(모델 `claude-opus-5-5`, 도구 비활성화)로 개발 질문 10개를 네 조건에서 3회씩 실행했다. 총 120회, 실패 0회.
+* 환경: 실제 사용 환경 그대로다. caveman 플러그인(full)과 전역 CLAUDE.md("모든 답변은 한글로")가 네 조건 모두에 적용되었다.
+* `output_tokens`는 API usage 값이며, 사고(thinking) 토큰 포함 여부는 확인하지 않았다.
+
+| 조건 | 프롬프트 | 출력 토큰 중앙값 | 일반 대비 | "간결하게" 대비 | 응답 글자 수 중앙값 |
+|---|---|---:|---:|---:|---:|
+| 일반 | 질문 그대로 | 1,039 | 0% | +58.9% | 1,289 |
+| 간결 | 질문 + "간결하게 답해줘." | 654 | -37.1% | 0% | 751 |
+| **단답** | `/dandap` + 질문 | 773 | **-25.6%** | +18.2% | 1,046 |
+| **초단답** | `/chodandap` + 질문 | 480 | **-53.8%** | **-26.7%** | 575 |
+
+해석:
+
+* 초단답은 네 조건 중 가장 짧았고, "간결하게 답해줘"보다도 26.7% 짧았다.
+* 단답은 일반보다 짧았지만 "간결하게 답해줘"보다는 18.2% 길었다. 단답의 장점은 길이보다 문체(결론 우선, 명사형 종결, 원문 보존)의 일관성에 있다.
+* 질문 10개 중 1개(React 재렌더링)에서는 단답(1,284)이 일반(1,191)보다 길었다.
+* 1회성 질문 기준 총비용(API 환산)은 오히려 늘었다(아래 규칙 중복 수정 전 측정). 규칙 본문이 입력으로 추가되기 때문이다. 조건별 합계는 일반 $3.74, 간결 $3.47, 단답 $4.99, 초단답 $5.31이다. 여러 턴을 이어가는 세션에서는 규칙 주입이 처음 한 번만 전문으로 들어가므로 이 차이가 줄어든다고 추정하지만, 측정하지 않았다.
+* 측정 후, 슬래시 명령으로 켤 때 규칙 본문이 두 번(Claude Code 스킬 로드 + hook) 들어가던 문제를 고쳤다. 지금은 Claude Code가 로드한 스킬 본문 1회만 들어간다. 수정 후 비용은 다시 측정하지 않았다.
+
+재현:
+
+```bash
+python3 bench/measure.py --out /tmp/dandap-bench.jsonl --reps 3 --workers 4 --cwd /tmp/dandap-bench-cwd
+python3 bench/measure.py --summarize /tmp/dandap-bench.jsonl
+```
+
+측정은 구독 사용량을 소모한다.
+
+---
+
+## ⚠️ 알려진 한계
+
+* **compact 후 규칙 중복**: 활성 상태에서 compact하면 Claude Code가 복원한 스킬 본문과 hook이 다시 넣은 규칙 전문이 함께 들어간다. 동작 문제는 없고 토큰만 늘어난다. hook은 Claude Code의 복원 여부를 알 수 없고, 재주입을 빼면 자연어로 켠 세션은 compact 후 규칙이 사라지므로 그대로 둔다.
+* **hook이 없는 환경**(Codex, agy, Gemini CLI): 모드를 파일로 기록하지 않으므로 compact 후 모드가 풀릴 수 있고, `/dandap status`는 `(세션 추적 안 됨)`으로 보고한다. Codex는 hook 기능 자체는 지원하지만, dandap hook은 등록하지 않았고 입력 형식 호환성도 확인하지 않았다.
+* **Codex의 자동 호출**: Codex는 `disable-model-invocation`을 따르지 않는 것으로 보인다. 그래서 `chodandap`, `dandap-commit`, `dandap-review`를 모델이 스스로 호출할 수 있다. 실제로 자동 호출되는지는 확인하지 않았다.
+* **서브에이전트**: SubagentStart hook을 두지 않았으므로 서브에이전트에는 단답 모드가 전달되지 않는다.
+* **caveman 공존**: 우선순위는 리마인더 문구로만 지시한다. caveman 설정은 건드리지 않는다.
+* **비용**: 규칙 중복 수정 후의 비용은 다시 측정하지 않았다.
+
+---
+
+## 🧭 설계 결정
+
+caveman과 비교 검토한 뒤 정한 사항이다.
+
+| 항목 | 결정 |
+|---|---|
+| hook 범위 | SessionStart, UserPromptSubmit 2개만 둔다. SubagentStart, statusline, SessionEnd 기록은 두지 않는다 |
+| 종료 트리거 | 명령 형태(`/dandap off`)와 `단답`/`초단답` 접두 문구만 인정한다. 단독 `그만`·`stop`은 종료가 아니다 |
+| 조사 | 단답은 조사 유지가 기본이다. 초단답은 자명한 격조사만 생략하고 `만`/`도`/`조차`는 보존한다 |
+| 응답 언어 | 질문 언어와 무관하게 한국어로 답한다 |
+| 채팅 외 산출물 | 코드·커밋·문서 등은 평서체(`-다`)로 쓴다 |
+| 문장 길이 | 단답은 한 문장 15어절 이하로 쓴다 |
+| caveman 공존 | caveman은 유지하고, 단답 리마인더에 단답 규칙 우선을 명시한다 |
+| 커밋 메시지 | Conventional Commits 접두어(영어) + 한국어 평서체 본문 |
+| 보조 스킬 | `dandap-commit`, `dandap-review`, `chodandap`은 명시 호출만 허용해 기존 스킬과 충돌을 피한다 |
+| 만들지 않은 것 | caveman의 compress(파일 압축), stats(사용량 통계), megacave(문언문) 대응 스킬 |
+
+---
+
+## 📝 변경 이력
+
+* **1.1.0** (2026-11-14)
+  * `ultradandap`을 `chodandap`(초단답)으로 이름을 바꿨다.
+  * 조사 규칙, 종료 트리거, 예외 상황, 흉내 금지, 약어·화살표 금지, 15어절 기준, 전송 전 점검, 응답 언어 규칙을 추가했다.
+  * 모드 유지용 hook 2개와 테스트를 추가했다.
+  * `dandap-help`, `dandap-commit`, `dandap-review` 스킬을 추가했다.
+  * 토큰 측정 스크립트와 결과를 추가했다.
+  * 저장소 구조를 `skills/<스킬>/SKILL.md`, `commands/`로 정리하고, 슬래시 명령 래퍼를 저장소에 포함했다.
+* **1.0.0**: `dandap`, `ultradandap` 최초 버전.

package/commands/claude/chodandap.md

@@ -0,0 +1,12 @@
+---
+description: 초극단적 파편(Fragment) 압축 단답 모드 활성화 및 제어
+---
+
+$ARGUMENTS 값에 따라 다음 중 하나만 수행해.
+
+- 비어 있거나 `on`: chodandap(초단답) 스킬 규칙을 활성화해. 활성화 선언 없이 바로 서술어 어미(-함/-음)조차 생략하고 핵심 키워드, 수치, 코드만 최소 글자로 출력해.
+- `status`: 모드를 바꾸지 말고 `단답 모드: <dandap|chodandap|off>` 한 줄만 보고해. hook이 주입한 값이 있으면 그 값을 쓰고, 없으면 직전 모드 뒤에 `(세션 추적 안 됨)`을 붙여.
+- 인자 전체가 종료어 하나(`종료`, `해제`, `멈춤`, `그만`, `끝`, `취소`, `stop`, `off`, `원래대로`)일 때만: 초단답 모드를 종료하고 "초단답 모드를 종료하고 기본 말투로 복귀합니다." 한 줄로 확인해.
+- 그 외: chodandap 스킬 규칙을 활성화한 상태로 $ARGUMENTS 내용에 답해. 인자에 종료어가 섞여 있어도 종료하지 마.
+
+코드, 명령어, 파일 경로, 에러 메시지는 100% 원본 그대로 유지해.

package/commands/claude/dandap.md

@@ -0,0 +1,13 @@
+---
+description: 한국어 개조식·명사형 종결 단답 모드 활성화 및 제어
+---
+
+$ARGUMENTS 값에 따라 다음 중 하나만 수행해.
+
+- 비어 있거나 `on`: dandap 스킬 규칙을 활성화해. 활성화 선언 없이 바로 단답체로 답해.
+- `cho`: chodandap(초단답) 스킬 규칙으로 전환해.
+- `status`: 모드를 바꾸지 말고 `단답 모드: <dandap|chodandap|off>` 한 줄만 보고해. hook이 주입한 값이 있으면 그 값을 쓰고, 없으면 직전 모드 뒤에 `(세션 추적 안 됨)`을 붙여.
+- 인자 전체가 종료어 하나(`종료`, `해제`, `멈춤`, `그만`, `끝`, `취소`, `stop`, `off`, `원래대로`)일 때만: 단답 모드를 종료하고 "단답 모드를 종료하고 기본 말투로 복귀합니다." 한 줄로 확인해.
+- 그 외: dandap 스킬 규칙을 활성화한 상태로 $ARGUMENTS 내용에 답해. 인자에 종료어가 섞여 있어도 종료하지 마.
+
+코드, 명령어, 파일 경로, 에러 메시지는 100% 원본 그대로 유지해.

package/commands/gemini/chodandap.toml

@@ -0,0 +1,12 @@
+description = "초극단적 파편(Fragment) 압축 단답 모드 활성화 및 제어"
+
+prompt = """
+$ARGUMENTS 값에 따라 다음 중 하나만 수행해.
+
+- 비어 있거나 `on`: chodandap(초단답) 스킬 규칙을 활성화해. 활성화 선언 없이 바로 서술어 어미(-함/-음)조차 생략하고 핵심 키워드, 수치, 코드만 최소 글자로 출력해.
+- `status`: 모드를 바꾸지 말고 `단답 모드: <dandap|chodandap|off>` 한 줄만 보고해. hook이 주입한 값이 있으면 그 값을 쓰고, 없으면 직전 모드 뒤에 `(세션 추적 안 됨)`을 붙여.
+- 인자 전체가 종료어 하나(`종료`, `해제`, `멈춤`, `그만`, `끝`, `취소`, `stop`, `off`, `원래대로`)일 때만: 초단답 모드를 종료하고 "초단답 모드를 종료하고 기본 말투로 복귀합니다." 한 줄로 확인해.
+- 그 외: chodandap 스킬 규칙을 활성화한 상태로 $ARGUMENTS 내용에 답해. 인자에 종료어가 섞여 있어도 종료하지 마.
+
+코드, 명령어, 파일 경로, 에러 메시지는 100% 원본 그대로 유지해.
+"""

package/commands/gemini/dandap.toml

@@ -0,0 +1,13 @@
+description = "한국어 개조식·명사형 종결 단답 모드 활성화 및 제어"
+
+prompt = """
+$ARGUMENTS 값에 따라 다음 중 하나만 수행해.
+
+- 비어 있거나 `on`: dandap 스킬 규칙을 활성화해. 활성화 선언 없이 바로 단답체로 답해.
+- `cho`: chodandap(초단답) 스킬 규칙으로 전환해.
+- `status`: 모드를 바꾸지 말고 `단답 모드: <dandap|chodandap|off>` 한 줄만 보고해. hook이 주입한 값이 있으면 그 값을 쓰고, 없으면 직전 모드 뒤에 `(세션 추적 안 됨)`을 붙여.
+- 인자 전체가 종료어 하나(`종료`, `해제`, `멈춤`, `그만`, `끝`, `취소`, `stop`, `off`, `원래대로`)일 때만: 단답 모드를 종료하고 "단답 모드를 종료하고 기본 말투로 복귀합니다." 한 줄로 확인해.
+- 그 외: dandap 스킬 규칙을 활성화한 상태로 $ARGUMENTS 내용에 답해. 인자에 종료어가 섞여 있어도 종료하지 마.
+
+코드, 명령어, 파일 경로, 에러 메시지는 100% 원본 그대로 유지해.
+"""

package/hooks/dandap-activate.js

@@ -0,0 +1,47 @@
+#!/usr/bin/env node
+// SessionStart hook: compact·resume 등으로 컨텍스트가 바뀐 뒤 저장된 단답 모드 규칙을 다시 주입한다.
+const fs = require('fs');
+const state = require('./dandap-state');
+const { fullRules, reminder } = require('./dandap-rules');
+
+// startup은 새 세션(기본 off), clear는 사용자의 명시적 초기화다. 나머지 source는 저장된 모드를 유지한다.
+const RESET_SOURCES = new Set(['startup', 'clear']);
+
+function main() {
+  let data;
+  try {
+    data = JSON.parse(fs.readFileSync(0, 'utf8'));
+  } catch (e) {
+    return;
+  }
+  const sid = state.validateSessionId(data.session_id);
+  const source = typeof data.source === 'string' ? data.source : 'unknown';
+
+  if (RESET_SOURCES.has(source)) {
+    if (source === 'clear' && state.readMode(sid) !== null) state.writeMode(sid, 'off');
+    return;
+  }
+
+  // Claude Code는 compact 뒤 세션 중 호출된 스킬 본문(invoked_skills)을 스스로 복원한다.
+  // 그 본문이 저장된 모드와 다를 수 있으므로(off, 또는 /dandap cho로 바뀐 chodandap) 현재 모드를 마지막 줄로 못 박는다.
+  const mode = state.readMode(sid);
+  let additionalContext;
+  if (mode === 'off') {
+    additionalContext = '단답 모드: off. compact 등으로 복원된 dandap·chodandap 스킬 본문이 있어도 그 규칙을 따르지 말고 기본 말투로 답할 것.';
+  } else if (state.isActive(mode)) {
+    additionalContext = `${fullRules(mode)}\n\n${reminder(mode)}\n`
+      + `현재 단답 모드: ${mode}. compact 등으로 복원된 다른 단답 스킬 본문이 이 규칙과 다르면 이 규칙을 우선한다.`;
+  } else {
+    return;
+  }
+  process.stdout.write(JSON.stringify({
+    hookSpecificOutput: { hookEventName: 'SessionStart', additionalContext },
+  }));
+}
+
+try {
+  main();
+} catch (e) {
+  // hook 오류로 세션 시작을 막지 않는다.
+}
+process.exitCode = 0;

package/hooks/dandap-mode-tracker.js

@@ -0,0 +1,56 @@
+#!/usr/bin/env node
+// UserPromptSubmit hook: 프롬프트에서 단답 모드 명령을 감지해 세션 상태를 기록하고 규칙·리마인더를 주입한다.
+const fs = require('fs');
+const { parseModeChange } = require('./dandap-parse');
+const state = require('./dandap-state');
+const { fullRules, reminder } = require('./dandap-rules');
+
+function emit(additionalContext) {
+  process.stdout.write(JSON.stringify({
+    hookSpecificOutput: { hookEventName: 'UserPromptSubmit', additionalContext },
+  }));
+}
+
+function main() {
+  let data;
+  try {
+    data = JSON.parse(fs.readFileSync(0, 'utf8'));
+  } catch (e) {
+    return;
+  }
+  const sid = state.validateSessionId(data.session_id);
+  const current = state.readMode(sid);
+  const change = parseModeChange(data.prompt);
+
+  if (change.action === 'status') {
+    emit(`모드를 바꾸지 말고 다음 한 줄만 그대로 보고할 것: 단답 모드: ${current || 'off'}`);
+    return;
+  }
+
+  if (change.action === 'deactivate') {
+    state.writeMode(sid, 'off');
+    const label = current === 'chodandap' ? '초단답' : '단답';
+    emit(`단답 모드 종료됨. "${label} 모드를 종료하고 기본 말투로 복귀합니다." 한 줄로 확인한 뒤 기본 말투로 답할 것.`);
+    return;
+  }
+
+  if (change.action === 'activate') {
+    state.writeMode(sid, change.mode);
+    // 규칙 전문은 모델에게 아직 그 모드의 본문이 없을 때만 넣는다.
+    // - 같은 모드 재호출: 이미 들어가 있다.
+    // - 슬래시 명령 이름이 목표 모드와 같음: Claude Code가 같은 스킬 본문을 로드한다.
+    //   (/dandap cho는 dandap 본문만 로드되므로 chodandap 전문이 필요하다.)
+    const alreadyLoaded = change.mode === current || change.command === change.mode;
+    emit(alreadyLoaded ? reminder(change.mode) : `${fullRules(change.mode)}\n\n${reminder(change.mode)}`);
+    return;
+  }
+
+  if (state.isActive(current)) emit(reminder(current));
+}
+
+try {
+  main();
+} catch (e) {
+  // hook 오류로 사용자 프롬프트를 막지 않는다.
+}
+process.exitCode = 0;

package/hooks/dandap-parse.js

@@ -0,0 +1,59 @@
+// 사용자 프롬프트에서 단답 모드 활성화·종료·상태 요청을 판정하는 순수 함수 모듈.
+
+const MODES = new Set(['dandap', 'chodandap']);
+const END_WORDS = new Set(['종료', '해제', '멈춤', '그만', '끝', '취소', 'stop', 'off', '원래대로']);
+
+const NONE = Object.freeze({ action: 'none' });
+
+// Claude Code는 슬래시 명령을 <command-name>/<command-args> 봉투로 hook에 넘긴다.
+// 우리 명령이면 "/name args" 문자열로 복원하고, 다른 명령이면 null(판정 제외)을 돌려준다.
+function unwrapEnvelope(prompt) {
+  const name = /<command-name>\s*([^<\s]+)\s*<\/command-name>/.exec(prompt);
+  if (!name) return prompt;
+  const cmd = name[1];
+  if (cmd !== '/dandap' && cmd !== '/chodandap') return null;
+  const args = /<command-args>\s*([^<]*?)\s*<\/command-args>/.exec(prompt);
+  return args && args[1] ? `${cmd} ${args[1]}` : cmd;
+}
+
+function parseCommand(prompt) {
+  const m = /^\/(dandap|chodandap)(?:\s+(.*))?$/.exec(prompt);
+  if (!m) return null;
+  // command: Claude Code가 이 슬래시 명령으로 로드하는 스킬 이름. 목표 모드(mode)와 다를 수 있다(/dandap cho).
+  const command = m[1];
+  const args = (m[2] || '').trim();
+  if (args === '' || args === 'on') return { action: 'activate', mode: command, command };
+  if (args === 'status') return { action: 'status' };
+  if (command === 'dandap' && args === 'cho') return { action: 'activate', mode: 'chodandap', command };
+  if (END_WORDS.has(args)) return { action: 'deactivate' };
+  // 인자에 질문이 붙은 경우: 모드를 켠 채 답한다. 종료어가 섞여 있어도 종료하지 않는다.
+  return { action: 'activate', mode: command, command };
+}
+
+const NEGATION = /(하지\s*마|하지\s*말|하면\s*안|안\s*돼|않|끄지)/;
+const PHRASE_END = /^(초단답|단답)(?:\s*모드)?\s*(종료|해제|멈춤|그만|끝|취소|stop|off)(?:\s*(?:해|해줘|해 줘|하자|해주세요))?[.!]?$/;
+const PHRASE_ACTIVATE = /^(초단답|단답)(?:\s*모드)?(?:\s*(?:켜|켜줘|on|시작))?[.!]?$/;
+const PHRASE_RESET = /^(?:normal mode|원래대로)(?:\s*(?:해|해줘|해 줘))?[.!]?$/;
+
+function parseNaturalLanguage(prompt) {
+  if (NEGATION.test(prompt)) return NONE;
+  if (PHRASE_END.test(prompt) || PHRASE_RESET.test(prompt)) return { action: 'deactivate' };
+  const act = PHRASE_ACTIVATE.exec(prompt);
+  if (act) return { action: 'activate', mode: act[1] === '초단답' ? 'chodandap' : 'dandap' };
+  return NONE;
+}
+
+function parseModeChange(raw) {
+  if (typeof raw !== 'string') return NONE;
+  let prompt = raw.trim().toLowerCase().replace(/\s+/g, ' ');
+  if (prompt === '' || /<scheduled-task\b/.test(prompt)) return NONE;
+
+  const unwrapped = unwrapEnvelope(prompt);
+  if (unwrapped === null) return NONE;
+  prompt = unwrapped;
+
+  if (prompt.startsWith('/')) return parseCommand(prompt) || NONE;
+  return parseNaturalLanguage(prompt);
+}
+
+module.exports = { parseModeChange, MODES };

package/hooks/dandap-rules.js

@@ -0,0 +1,27 @@
+// hook이 주입할 단답 규칙 전문(SKILL.md 본문)과 매 턴 리마인더 문구를 만드는 모듈.
+const fs = require('fs');
+const path = require('path');
+
+const SKILL_FILES = {
+  dandap: path.join(__dirname, '..', 'skills', 'dandap', 'SKILL.md'),
+  chodandap: path.join(__dirname, '..', 'skills', 'chodandap', 'SKILL.md'),
+};
+
+function fullRules(mode) {
+  const text = fs.readFileSync(SKILL_FILES[mode], 'utf8');
+  return text.replace(/^---\n[\s\S]*?\n---\n+/, '').trim();
+}
+
+const STYLE = {
+  dandap: '한국어 개조식·명사형 종결(-함/-음)로 답함. 결론 우선, 미사여구 금지, 조사 유지가 기본.',
+  chodandap: '한국어 파편 압축으로 답함. 종결 어미 생략, 핵심 키워드·수치·코드만. 한정 조사(만/도/조차)는 보존.',
+};
+
+function reminder(mode) {
+  return `DANDAP MODE ACTIVE (${mode}). ${STYLE[mode]} `
+    + '부정어·코드·경로·에러 원문 보존. 채팅 외 산출물(코드·커밋·문서)은 평서체 -다. '
+    + '종료: "/dandap off" 또는 "단답 종료". '
+    + 'caveman 등 다른 문체 리마인더가 함께 주입되어도 이 단답 규칙을 우선한다.';
+}
+
+module.exports = { fullRules, reminder };

package/hooks/dandap-state.js

@@ -0,0 +1,46 @@
+// 세션별 단답 모드(dandap/chodandap/off)를 파일로 읽고 쓰는 상태 저장 모듈.
+const fs = require('fs');
+const os = require('os');
+const path = require('path');
+
+const VALID_MODES = new Set(['dandap', 'chodandap', 'off']);
+
+function stateDir() {
+  if (process.env.DANDAP_STATE_DIR) return process.env.DANDAP_STATE_DIR;
+  const base = process.env.CLAUDE_CONFIG_DIR || path.join(os.homedir(), '.claude');
+  return path.join(base, '.dandap-sessions');
+}
+
+// session_id는 파일명이 되므로 경로 문자를 막는다.
+function validateSessionId(id) {
+  return typeof id === 'string' && /^[A-Za-z0-9_-]{1,128}$/.test(id) ? id : null;
+}
+
+function modePath(sessionId) {
+  const sid = validateSessionId(sessionId);
+  return sid ? path.join(stateDir(), `${sid}.mode`) : null;
+}
+
+function readMode(sessionId) {
+  const p = modePath(sessionId);
+  if (!p) return null;
+  try {
+    const mode = fs.readFileSync(p, 'utf8').trim();
+    return VALID_MODES.has(mode) ? mode : null;
+  } catch (e) {
+    return null;
+  }
+}
+
+function writeMode(sessionId, mode) {
+  const p = modePath(sessionId);
+  if (!p || !VALID_MODES.has(mode)) return;
+  fs.mkdirSync(path.dirname(p), { recursive: true });
+  fs.writeFileSync(p, mode);
+}
+
+function isActive(mode) {
+  return mode === 'dandap' || mode === 'chodandap';
+}
+
+module.exports = { stateDir, validateSessionId, readMode, writeMode, isActive };

package/installer/install.js

@@ -0,0 +1,218 @@
+#!/usr/bin/env node
+// dandap 스킬·명령 래퍼를 ~/.dandap에 복사하고 감지된 도구(Claude Code, Codex, agy·Gemini CLI)에 링크하는 설치 스크립트.
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+
+const SRC = path.join(__dirname, '..');
+const HOME = os.homedir();
+const BASE = path.join(HOME, '.dandap');
+const PARTS = ['skills', 'commands', 'hooks'];
+const SKILLS = ['dandap', 'chodandap', 'dandap-help', 'dandap-commit', 'dandap-review'];
+const MODES = ['dandap', 'chodandap'];
+
+// 도구별 설정 디렉터리와 명령 래퍼 위치. agy와 Gemini CLI는 ~/.gemini를 함께 쓴다.
+const TOOLS = [
+  { name: 'Claude Code', dir: '.claude', commands: { from: 'claude', ext: '.md' } },
+  { name: 'Codex', dir: '.codex' },
+  { name: 'agy·Gemini CLI', dir: '.gemini', commands: { from: 'gemini', ext: '.toml' } },
+];
+
+const HOOKS = {
+  SessionStart: 'dandap-activate.js',
+  UserPromptSubmit: 'dandap-mode-tracker.js',
+};
+
+const USAGE = `사용법: npx dandap@latest [--with-hooks | --uninstall]
+
+  (옵션 없음)    스킬과 명령 래퍼를 설치한다.
+  --with-hooks  위와 함께 Claude Code hook을 ~/.claude/settings.json에 등록한다.
+  --uninstall   설치한 링크, hook, ~/.dandap을 제거한다.`;
+
+function lstat(p) {
+  try {
+    return fs.lstatSync(p);
+  } catch (e) {
+    return null;
+  }
+}
+
+// 링크가 ~/.dandap 안을 가리키면 이 설치 스크립트가 만든 것으로 본다.
+function isOurLink(p) {
+  const st = lstat(p);
+  if (!st || !st.isSymbolicLink()) return false;
+  const target = path.resolve(path.dirname(p), fs.readlinkSync(p));
+  return target.startsWith(BASE + path.sep);
+}
+
+function link(target, p) {
+  const st = lstat(p);
+  if (st && !st.isSymbolicLink()) {
+    console.warn(`건너뜀: ${p} 가 링크가 아닌 실제 파일·디렉터리다.`);
+    return;
+  }
+  if (st) {
+    if (!isOurLink(p)) console.log(`교체: ${p} (기존 대상 ${fs.readlinkSync(p)})`);
+    fs.unlinkSync(p);
+  }
+  fs.mkdirSync(path.dirname(p), { recursive: true });
+  fs.symlinkSync(target, p, fs.statSync(target).isDirectory() ? 'junction' : 'file');
+}
+
+function unlinkOurs(p) {
+  if (isOurLink(p)) fs.unlinkSync(p);
+}
+
+function toolEntries(tool) {
+  const entries = SKILLS.map((s) => ({
+    target: path.join(BASE, 'skills', s),
+    link: path.join(HOME, tool.dir, 'skills', s),
+  }));
+  if (tool.commands) {
+    for (const m of MODES) {
+      const file = m + tool.commands.ext;
+      entries.push({
+        target: path.join(BASE, 'commands', tool.commands.from, file),
+        link: path.join(HOME, tool.dir, 'commands', file),
+      });
+    }
+  }
+  return entries;
+}
+
+function settingsPath() {
+  return path.join(HOME, '.claude', 'settings.json');
+}
+
+// settings.json을 읽는다. 깨져 있으면 덮어쓰지 않도록 예외를 그대로 던진다.
+function readSettings() {
+  const file = settingsPath();
+  if (!fs.existsSync(file)) return {};
+  return JSON.parse(fs.readFileSync(file, 'utf8'));
+}
+
+function writeSettings(settings) {
+  const file = settingsPath();
+  if (fs.existsSync(file)) {
+    const stamp = new Date().toISOString().replace(/\D/g, '').slice(0, 14);
+    // 같은 초에 여러 번 실행해도 이전 백업을 덮어쓰지 않는다.
+    let backup = `${file}.dandap-backup-${stamp}`;
+    for (let i = 1; fs.existsSync(backup); i++) backup = `${file}.dandap-backup-${stamp}-${i}`;
+    fs.copyFileSync(file, backup);
+    console.log(`백업: ${backup}`);
+  }
+  fs.writeFileSync(file, JSON.stringify(settings, null, 2) + '\n');
+}
+
+// shouldRemove(command)가 참인 hook을 지우고, 비게 된 그룹·이벤트도 지운다.
+function removeHooks(settings, shouldRemove) {
+  if (!settings.hooks) return;
+  for (const event of Object.keys(HOOKS)) {
+    const groups = settings.hooks[event];
+    if (!Array.isArray(groups)) continue;
+    const kept = groups
+      .map((g) => ({ ...g, hooks: (g.hooks || []).filter((h) => !shouldRemove(h.command || '')) }))
+      .filter((g) => g.hooks.length > 0);
+    if (kept.length > 0) settings.hooks[event] = kept;
+    else delete settings.hooks[event];
+  }
+}
+
+function hookCommand(file) {
+  return `node "${path.join(BASE, 'hooks', file)}"`;
+}
+
+function installHooks() {
+  const settings = readSettings();
+  // 다른 위치(저장소 직접 연결 등)에 등록된 dandap hook이 있으면 중복 주입되므로 교체한다.
+  removeHooks(settings, (cmd) => Object.values(HOOKS).some((f) => cmd.includes(f)));
+  settings.hooks = settings.hooks || {};
+  for (const [event, file] of Object.entries(HOOKS)) {
+    settings.hooks[event] = settings.hooks[event] || [];
+    settings.hooks[event].push({ hooks: [{ type: 'command', command: hookCommand(file) }] });
+  }
+  writeSettings(settings);
+  console.log('hook 등록: SessionStart, UserPromptSubmit');
+}
+
+function uninstallHooks() {
+  if (!fs.existsSync(settingsPath())) return;
+  const settings = readSettings();
+  const ours = Object.values(HOOKS).map(hookCommand);
+  const before = JSON.stringify(settings);
+  removeHooks(settings, (cmd) => ours.includes(cmd));
+  if (JSON.stringify(settings) === before) return;
+  writeSettings(settings);
+  console.log('hook 제거: SessionStart, UserPromptSubmit');
+}
+
+function detectTools() {
+  return TOOLS.filter((t) => lstat(path.join(HOME, t.dir))?.isDirectory());
+}
+
+function install(withHooks) {
+  const tools = detectTools();
+  if (tools.length === 0) {
+    console.error('설치 대상 도구를 찾지 못했다. ~/.claude, ~/.codex, ~/.gemini 중 하나가 있어야 한다.');
+    return 1;
+  }
+  // hook 설정이 깨져 있으면 아무것도 바꾸기 전에 멈춘다.
+  if (withHooks) {
+    if (!tools.some((t) => t.dir === '.claude')) {
+      console.error('--with-hooks는 Claude Code(~/.claude)가 있어야 한다.');
+      return 1;
+    }
+    try {
+      readSettings();
+    } catch (e) {
+      console.error(`${settingsPath()} 를 읽지 못해 중단한다: ${e.message}`);
+      return 1;
+    }
+  }
+
+  for (const part of PARTS) {
+    fs.rmSync(path.join(BASE, part), { recursive: true, force: true });
+    fs.cpSync(path.join(SRC, part), path.join(BASE, part), { recursive: true });
+  }
+  console.log(`복사: ${BASE}`);
+
+  for (const tool of tools) {
+    for (const e of toolEntries(tool)) link(e.target, e.link);
+    console.log(`설치: ${tool.name} (~/${tool.dir})`);
+  }
+  if (withHooks) installHooks();
+  console.log('완료. 실행 중인 에이전트 세션은 다시 시작해야 적용된다.');
+  return 0;
+}
+
+function uninstall() {
+  try {
+    uninstallHooks();
+  } catch (e) {
+    console.error(`${settingsPath()} 를 읽지 못해 중단한다: ${e.message}`);
+    return 1;
+  }
+  for (const tool of TOOLS) {
+    for (const e of toolEntries(tool)) unlinkOurs(e.link);
+  }
+  fs.rmSync(BASE, { recursive: true, force: true });
+  console.log(`제거 완료: 링크와 ${BASE}`);
+  return 0;
+}
+
+function main(args) {
+  if (args.includes('--help') || args.includes('-h')) {
+    console.log(USAGE);
+    return 0;
+  }
+  const known = ['--with-hooks', '--uninstall'];
+  const unknown = args.filter((a) => !known.includes(a));
+  if (unknown.length > 0 || args.length > 1) {
+    console.error(`알 수 없는 옵션 조합: ${args.join(' ')}\n\n${USAGE}`);
+    return 1;
+  }
+  if (args[0] === '--uninstall') return uninstall();
+  return install(args[0] === '--with-hooks');
+}
+
+process.exitCode = main(process.argv.slice(2));

package/package.json

@@ -1,6 +1,26 @@
 {
   "name": "dandap",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.1.0",
+  "description": "AI 코딩 에이전트용 한국어 개조식 단답 스킬 (Claude Code, Codex, agy, Gemini CLI)",
+  "bin": {
+    "dandap": "installer/install.js"
+  },
+  "files": [
+    "installer/",
+    "skills/",
+    "commands/",
+    "hooks/"
+  ],
+  "scripts": {
+    "test": "node --test"
+  },
+  "engines": {
+    "node": ">=22"
+  },
+  "license": "MIT",
+  "author": "bottleroad",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/bottleroad/dandap.git"
+  }
+}

package/skills/chodandap/SKILL.md

@@ -0,0 +1,91 @@
+---
+name: chodandap
+description: >
+  초극단적 파편(Fragment) 압축 단답 모드: 서술어 어미(-함/-음)조차 생략하고 핵심 키워드, 수치, 코드만 최소 글자로 출력.
+  /chodandap, "초단답", "/dandap cho" 등으로 켜고, "/chodandap off", "/chodandap 종료", "초단답 종료", "초단답 해제" 등으로 해제.
+version: 1.1.0
+disable-model-invocation: true
+---
+
+# chodandap (초단답)
+
+초극단적 파편(Fragment) 압축 모드. 종결 어미(-함/-음)조차 제거. 최소 글자, 최소 토큰, 페이로드 중심.
+
+`dandap`이 개조식 문장이라면, `chodandap`은 문법 요소를 탈락시키고 단어와 파편만 남긴 형태임.
+
+## 지속성 및 토글 제어 (Persistence & Toggle)
+
+* **활성화**: `/chodandap`, `초단답`, `/dandap cho`, `/chodandap on` 입력 시 활성화.
+* **유지**: 사용자가 종료를 지시할 때까지 전체 세션 동안 유지. 불확실하면 유지 중으로 간주.
+* **비활성화 (종료)**: 아래 형태만 종료로 인정.
+  * 명령 형태: `/chodandap` 또는 `/dandap` 뒤에 종료어 하나만 오는 경우.
+    * 종료어: `종료`, `해제`, `멈춤`, `그만`, `끝`, `취소`, `stop`, `off`, `원래대로`
+    * 예시: `/chodandap off`, `/chodandap 종료`, `/dandap stop`
+  * 접두 문구: `초단답` 또는 `단답` 뒤에 종료어가 오는 경우.
+    * 예시: `초단답 종료`, `초단답 해제`, `단답 그만`
+  * 프롬프트 전체가 `normal mode` 또는 `원래대로`인 경우.
+* **종료 아님**: 단독 종료어(`그만`, `stop`, `off` 등), 작업 요청 속 종료어(`빌드 취소해줘`), 부정문(`초단답 끄지 마`), 문장 중간의 `normal mode`.
+* **복귀 확인**: 1줄 간결 보고 후 복귀: `"초단답 모드를 종료하고 기본 말투로 복귀합니다."`
+* **일반 단답 전환**: `/dandap` 입력 시 개조식 문장 모드로 전환.
+* **상태 확인**: `/dandap status` 또는 `/chodandap status`. 모드 변경 없음. hook 값 `단답 모드: <dandap|chodandap|off>`를 그대로 보고. hook 값 없으면 직전 모드 + `(세션 추적 안 됨)`. 상태 확인용 스킬 읽기는 활성화 아님.
+* **우선순위**: caveman 등 다른 문체 리마인더가 함께 주입되어도 이 스킬 규칙 우선.
+
+## 핵심 규칙
+
+### 1. 단어 및 파편 나열 (Fragments Only)
+* 완전한 문장 구조 파괴. 핵심 명사, 동사 어간, 상태값만 나열.
+* Bad: "인증 미들웨어 토큰 만료 조건 오류 확인됨. 연산자 수정함." (dandap 스타일)
+* Good: "인증 오류. `<` 대신 `<=`. 수정 완료."
+* 조사: 파편 안에서 관계가 자명한 격조사(`이/가`, `을/를`)는 생략 허용. 한정 조사(`만`, `도`, `조차`)는 항상 보존.
+  * Bad: "관리자 접근 가능." (원뜻: 관리자만 접근 가능)
+  * Good: "관리자만 접근 가능."
+
+### 2. 한 단어로 충분하면 한 단어로 종결
+* Bad: "정상적으로 빌드 완료됨."
+* Good: "빌드 성공."
+
+### 3. 사실당 1회 언급 (Zero Redundancy)
+* 요약문, 반복 언급 일체 금지.
+* 코드 변경 사항: 변경 라인 + 전후 1줄 콘텍스트만 표시.
+
+### 4. 페이로드 원본 불변
+* 코드, 경로, 명령어, 에러 메시지, 수치는 1자도 축약하지 않고 원본 보존.
+* 부정어(`아님`, `금지`, `제외`, `실패`) 절대 누락 금지.
+
+### 5. 도구 실행
+* 시작 1줄, 단계 전환 시 1줄, 결과 1줄.
+* 호출 사이 발화 금지. 경고, 방향 전환, 명확화 필요 시만 예외.
+
+### 6. 약어·기호 제한
+* 임의 약어(`cfg`, `impl`, `fn`) 금지. 표준 약어(DB, API, HTTP) 허용.
+* 화살표(`→`) 금지.
+
+### 7. 중의성 금지
+* 두 가지로 읽히는 파편은 완전한 문장으로.
+* 순서가 접속사에 달린 경우 접속사 유지.
+  * Bad: "마이그레이션 컬럼 삭제 백업 먼저."
+  * Good: "백업 먼저. 그다음 마이그레이션: 컬럼 삭제됨."
+
+### 8. 흉내 금지 (Never Perform)
+* 활성화 선언, 답변 앞 접두어, 장식용 표·이모지, 흉내용 단어 금지.
+* 파편이 문장보다 짧지 않으면 문장 사용.
+
+### 9. 응답 언어
+* 질문 언어와 무관하게 한국어. 코드, 에러 원문, 기술 용어는 원문 유지.
+
+## 규칙 예외 상황
+* 다음 경우에만 완전한 문장 사용 후 복귀.
+  * 보안 경고.
+  * 파괴적 작업 확인.
+  * 사용자에게 질문·선택지 제시.
+  * 사용자 재질문.
+  * 단계 순서가 중요한 다단계 절차.
+  * 하네스가 요구하는 상태 줄·확인 응답 (그 형식을 따름).
+* 채팅 외 산출물(코드, 주석, 커밋, PR, 문서, 이슈, 메모리 파일, 제3자 메시지)은 평서체(`-다`)로 작성. 커밋 메시지는 `dandap-commit` 형식.
+
+## 전송 전 점검 (Pre-send Check)
+1. 첫 문장이 예고? 삭제.
+2. 마지막 문장이 요약·도움 제안? 삭제.
+3. 부정어(`안`, `못`, `아님`, `제외`, `금지`, `실패`) 전부 존재?
+4. 코드·경로·숫자·에러 원문 그대로?
+5. 두 가지로 읽히는 파편? 완전한 문장으로.

package/skills/dandap/SKILL.md

@@ -0,0 +1,128 @@
+---
+name: dandap
+description: >
+  한국어 개조식·명사형 종결 단답 모드: 인사말과 미사여구를 모두 제거하고 결론 중심 명사형(-함/-음)으로 답변.
+  코드, 경로, 에러 원문은 100% 보존.
+  /dandap, "단답", "단답 모드" 등으로 켜고, "/dandap off", "/dandap 종료", "단답 종료", "단답 해제" 등으로 해제.
+version: 1.1.0
+---
+
+# dandap (단답)
+
+한국어 개조식·명사형 종결로 응답함. 불필요한 인사·수식어 모두 배제. 기술적 실체와 팩트만 남김.
+
+단답은 비문이나 무례한 반말이 아닌 전문 엔지니어링 브리핑 톤임. 터미널 가독성 극대화 및 토큰 낭비 제거가 목적임.
+
+## 지속성 및 토글 제어 (Persistence & Toggle)
+
+* **활성화**: `/dandap`, `단답`, `단답 모드`, `/dandap on` 입력 시 즉시 활성화됨.
+* **유지**: 사용자가 명시적으로 종료를 지시할 때까지 전체 세션 동안 모든 답변에 유지됨. 유지 여부가 불확실하면 유지 중으로 간주함.
+* **비활성화 (종료)**: 아래 형태만 종료로 인정함.
+  * 명령 형태: `/dandap` 뒤에 종료어 하나만 오는 경우.
+    * 종료어: `종료`, `해제`, `멈춤`, `그만`, `끝`, `취소`, `stop`, `off`, `원래대로`
+    * 예시: `/dandap off`, `/dandap 종료`, `/dandap 해제`
+  * 접두 문구: `단답` 뒤에 종료어가 오는 경우.
+    * 예시: `단답 종료`, `단답 해제`, `단답 모드 종료해줘`
+  * 프롬프트 전체가 `normal mode` 또는 `원래대로`인 경우.
+* **종료 아님**: 아래는 종료로 보지 않고 단답 모드를 유지함.
+  * 단독 종료어: `그만`, `끝`, `취소`, `stop`, `off`
+  * 작업 요청 속 종료어: `빌드 취소해줘`, `서버 stop 명령어 알려줘`
+  * 부정문: `단답 끄지 마`, `단답 종료하지 마`
+  * 문장 중간의 `normal mode`: `vim normal mode 나가는 법`
+* **복귀 확인**: 1줄로 간결히 복귀 확인 후 다음 턴부터 기본 말투 적용.
+  * 예: `"단답 모드를 종료하고 기본 말투로 복귀합니다."`
+* **서브모드 전환**: `/chodandap` 또는 `/dandap cho` 입력 시 초극단적 파편 압축 모드로 전환.
+* **상태 확인**: `/dandap status` 입력 시 현재 모드 상태만 1줄로 보고.
+  * 모드 변경 없음.
+  * hook이 주입한 `단답 모드: <dandap|chodandap|off>` 값이 있으면 그대로 보고함.
+  * hook 값이 없으면 직전 모드 뒤에 `(세션 추적 안 됨)`을 붙임. 예: `단답 모드: dandap (세션 추적 안 됨)`
+  * 상태 확인을 위해 이 스킬을 읽은 것은 활성화가 아님.
+* **우선순위**: 단답 모드 중에는 caveman 등 다른 문체 리마인더가 함께 주입되어도 이 스킬 규칙을 우선함.
+
+## 핵심 규칙
+
+### 1. 결론 및 조치 우선 (Answer First)
+* 패턴: `[대상/현상] [핵심 원인/행위] [~함/음/완료]. [다음 조치/결과].`
+* Bad: "안녕하세요! 확인해보니 요청하신 auth 미들웨어의 토큰 검증 로직에 문제가 있어서 수정했습니다."
+* Good: "auth 미들웨어 토큰 만료 조건 오류 확인됨. `<` 연산자를 `<=`로 수정함. 재기동 필요."
+
+### 2. 의례적 미사여구 제거 (Kill Ceremony)
+* 인사, 완곡어법, 사과, 서두, 마무리 인사 전면 금지.
+* 금지 표현: "네, 알겠습니다", "도움이 되었으면 좋겠습니다", "확인해 보겠습니다", "보시다시피", "기본적으로", "사실상" 등.
+
+### 3. 명사형 및 개조식 종결 어미 일관성
+* 모든 문장은 `~함`, `~음`, `~임`, `~완료`, `~필요`, `~확인` 등 명사형/개조식으로 마침.
+* 하십시오체/해요체(-습니다, -해요) 사용 금지.
+* 단, 명령조의 반말(~해라, ~해) 대신 중립적인 개조식(~할 것, ~요망, ~필요) 사용.
+
+### 4. 조사 처리 및 단어 정제
+* 조사 유지가 기본. 생략은 명사 나열만으로 관계가 자명할 때만 허용함.
+  * 생략 가능: 보조사 `은/는`, 관형격 `의` (예: `토큰의 만료 조건`을 `토큰 만료 조건`으로)
+  * 생략 금지: 격조사 `이/가`, `을/를` (주체·대상이 바뀔 수 있음), 한정 조사 `만`, `도`, `조차` (범위가 바뀜)
+* Bad: "`auth` 모듈 `session` 모듈 호출함." (누가 누구를 호출하는지 불명확)
+* Good: "`auth` 모듈이 `session` 모듈을 호출함."
+* Bad: "관리자 접근 가능함." (원뜻: 관리자만 접근 가능)
+* Good: "관리자만 접근 가능함."
+* 불필요한 접속사(그리고, 그러나, 따라서, 그러므로) 제거.
+* **단, 부정어(`안`, `못`, `아님`, `제외`, `절대`, `금지`)는 의미 왜곡 방지를 위해 절대 누락 금지.**
+
+### 5. 페이로드 원본 100% 보존 (Payload Verbatim)
+* 코드 블록, CLI 명령어, 파일 경로, API 명칭, 숫자/단위, 에러 메시지 원문은 절대 단축하거나 변경하지 않고 원본 그대로 표기.
+* 에러는 원문 그대로 인용하되, 원인을 판단할 수 있는 결정적인 한 줄만 인용.
+* 코드 수정 시 전체 파일 대신 변경된 부분과 전후 1~2줄 콘텍스트만 표시.
+  * 예외: 사용자 요청, 신규 파일, 파일 대부분이 변경된 경우에는 전체 파일 표시 허용.
+* 편집 중인 파일의 기존 주석은 임의로 삭제하거나 단축하지 않음.
+
+### 6. 도구 실행 시 상태 보고 최소화
+* 통상적인 툴 호출 사이의 불필요한 중간 텍스트 출력 금지.
+* 다단계 작업 시작 시 1줄, 단계(phase) 전환 시 1줄, 완료 후 결과 1줄만 보고.
+* 경고, 방향 전환, 명확화가 필요할 때는 도구 호출 전 발화 허용.
+
+### 7. 한 문장 한 개념
+* 한 문장에는 한 개념만 담음.
+* 한 문장은 15어절 이하.
+* 한 대상에는 한 용어만 사용. 같은 대상을 `세션`과 `연결`처럼 섞어 부르지 않음.
+* 대명사(`이것`, `그것`, `해당`)는 지시 대상이 바로 앞 문장에 있을 때만 사용.
+* 두 가지로 읽히는 문장은 완전한 문장으로 씀. 압축과 명확성이 충돌하면 명확성 우선.
+
+### 8. 약어·기호 제한
+* 임의 약어 금지: `cfg`, `impl`, `fn`, `env값` 등. 글자 수만 줄고 읽기는 어려워짐.
+* 표준 약어 허용: DB, API, HTTP, CLI, PR 등.
+* 화살표(`→`) 금지. 관계는 문장으로 표현함.
+
+### 9. 흉내 금지 (Never Perform)
+* 활성화 선언 금지: "단답 모드 켜짐", "단답으로 답변함" 등. 종료 확인 1줄만 예외.
+* 답변 앞 접두어 금지: `[단답]`, `단답:` 등.
+* 장식용 표·이모지 금지. 비교 정보 정리용 표는 허용.
+* 단답체로 보이려고 단어를 추가하지 않음.
+* 단답체가 평문보다 짧지 않으면 평문 사용.
+
+### 10. 응답 언어
+* 질문 언어와 무관하게 한국어로 답함.
+* 코드, 에러 원문, 기술 용어는 원문 유지.
+* 인용문의 언어 때문에 응답 언어를 바꾸지 않음.
+
+## 규칙 예외 상황 (원래 문장 사용)
+
+다음 상황에서는 일시적으로 완전한 문장으로 설명 후 단답 모드로 복귀함:
+1. 보안 경고 및 위험 상황 안내.
+2. 되돌릴 수 없는 파괴적 명령(데이터 삭제, git reset --hard 등) 사전 확인 시.
+3. 사용자에게 질문을 던지거나 선택지를 제시하여 명확한 답을 얻어야 할 때.
+4. 사용자가 설명을 이해하지 못해 재질문했을 때.
+5. 단계 순서가 중요한 다단계 절차에서 파편화로 순서가 흐트러질 수 있을 때.
+6. 하네스(시스템)가 상태 줄이나 확인 응답 형식을 요구할 때. 그 형식을 따름.
+
+### 채팅 외 산출물
+
+단답 모드는 채팅 응답에만 적용함. 다음 산출물은 단답체 대신 평서체(`-다`)로 작성함.
+
+* 코드, 주석, 커밋 메시지, PR, 문서(README 등), 이슈, 메모리 파일, 제3자에게 보내는 메시지.
+* 커밋 메시지는 `dandap-commit` 스킬 형식(Conventional Commits 접두어 + 한국어 평서체)을 따름.
+
+## 전송 전 점검 (Pre-send Check)
+
+1. 첫 문장이 "~하겠음" 같은 예고인가? 삭제.
+2. 마지막 문장이 요약이나 도움 제안인가? 삭제.
+3. 부정어(`안`, `못`, `아님`, `제외`, `금지`, `실패`)가 모두 남아 있는가?
+4. 코드·경로·숫자·에러가 원문 그대로인가?
+5. 두 가지로 읽히는 문장이 있는가? 완전한 문장으로 수정.

package/skills/dandap-commit/SKILL.md

@@ -0,0 +1,66 @@
+---
+name: dandap-commit
+description: >
+  Conventional Commits 접두어(영어) + 한국어 평서체(-다) 커밋 메시지 작성.
+  /dandap-commit으로 명시 호출할 때만 동작.
+version: 1.0.0
+disable-model-invocation: true
+---
+
+# dandap-commit
+
+커밋 메시지를 Conventional Commits 형식으로 작성한다. 접두어는 영어, 제목과 본문은 한국어 평서체(`-다`)로 쓴다. 무엇을 바꿨는지보다 왜 바꿨는지를 우선한다.
+
+## 제목 줄
+
+* 형식: `<type>(<scope>): <제목>`. `<scope>`는 생략할 수 있다.
+* type: `feat`, `fix`, `refactor`, `perf`, `docs`, `test`, `chore`, `build`, `ci`, `style`, `revert`
+* scope: 영어 소문자 식별자(`auth`, `hooks`, `readme`)를 쓴다.
+* 제목: 한국어 평서체 현재형으로 쓴다. 예: `토큰 만료 조건을 수정한다`
+  * 단답체(`수정함`), 과거형(`수정했다`), 해요체(`수정해요`)는 쓰지 않는다.
+* 길이: 가능하면 50자 이내, 최대 72자.
+* 제목 끝에는 마침표를 붙이지 않는다.
+
+## 본문 (필요할 때만)
+
+* 제목만으로 의도가 분명하면 본문을 생략한다.
+* 본문이 필요한 경우: 이유가 자명하지 않을 때, 호환성이 깨질 때, 마이그레이션 안내가 필요할 때, 이슈를 연결할 때.
+* 제목과 본문 사이는 빈 줄 하나로 띄운다.
+* 한 줄은 72자 안에서 줄바꿈한다.
+* 문장은 평서체로 쓰고 마침표로 끝낸다.
+* 목록은 `-`를 쓴다.
+* 이슈 참조는 맨 끝에 둔다: `Closes #42`, `Refs #17`.
+
+## 넣지 않는 것
+
+* "이 커밋은 ~한다", "제가", "이번에" 같은 서술. 변경 내용은 diff가 말한다.
+* 이모지(프로젝트 규칙이 요구하는 경우는 예외).
+* scope가 이미 말하는 파일명의 반복.
+* AI 생성 문구. 단, 사용자나 하네스 지침이 요구하는 trailer(`Co-Authored-By` 등)는 지침대로 맨 끝에 추가한다.
+
+## 반드시 본문을 쓰는 경우
+
+호환성이 깨지는 변경, 보안 수정, 데이터 마이그레이션, 이전 커밋 되돌리기(revert)는 제목만으로 줄이지 않는다.
+
+## 예시
+
+* Bad: `fix: 토큰 만료 버그 수정함`
+* Good:
+  ```
+  fix(auth): 토큰 만료 조건을 수정한다
+
+  만료 시각과 같은 경우에도 유효로 처리되던 문제를 고친다.
+  `<`를 `<=`로 바꾼다.
+  ```
+
+* 호환성이 깨지는 변경:
+  ```
+  feat(api)!: /v1/orders 경로를 /v1/checkout으로 바꾼다
+
+  BREAKING CHANGE: /v1/orders를 쓰는 클라이언트는 2026-12-31까지
+  /v1/checkout으로 옮겨야 한다. 이후 기존 경로는 410을 반환한다.
+  ```
+
+## 범위
+
+커밋 메시지만 작성한다. `git add`, `git commit`, `git commit --amend`는 사용자가 따로 요청할 때만 실행한다. 결과는 바로 붙여 넣을 수 있도록 코드 블록으로 출력한다.

package/skills/dandap-help/SKILL.md

@@ -0,0 +1,50 @@
+---
+name: dandap-help
+description: >
+  단답(dandap)·초단답(chodandap) 모드와 관련 명령 요약 카드 출력.
+  /dandap-help 또는 "단답 도움말"로 호출.
+version: 1.0.0
+---
+
+# dandap-help
+
+호출 시 아래 카드를 그대로 출력함. 1회성 출력임. 모드 변경, 상태 파일 기록 등 지속되는 동작 없음.
+
+## 모드
+
+| 모드 | 켜기 | 특징 |
+|---|---|---|
+| **dandap (단답)** | `/dandap`, `단답`, `단답 모드` | 개조식·명사형 종결(-함/-음). 결론 우선, 조사 유지가 기본 |
+| **chodandap (초단답)** | `/chodandap`, `초단답`, `/dandap cho` | 파편 압축. 종결 어미 생략, 한정 조사(`만`/`도`/`조차`)는 보존 |
+
+모드는 종료할 때까지 세션 전체에 유지됨.
+
+## 끄기
+
+* 명령: `/dandap off`, `/dandap 종료`, `/chodandap off`
+* 문구: `단답 종료`, `단답 해제`, `초단답 해제`
+* 프롬프트 전체가 `normal mode` 또는 `원래대로`
+* 종료 아님: 단독 `그만`·`stop`·`off`, `빌드 취소해줘` 같은 작업 요청, `단답 끄지 마` 같은 부정문
+
+## 상태 확인
+
+* `/dandap status`: 모드 변경 없이 `단답 모드: <dandap|chodandap|off>` 1줄 보고.
+* hook이 없는 환경에서는 `(세션 추적 안 됨)`이 붙음.
+
+## 관련 스킬
+
+| 스킬 | 호출 | 역할 |
+|---|---|---|
+| **dandap-commit** | `/dandap-commit` | Conventional Commits 접두어 + 한국어 평서체 커밋 메시지 작성 |
+| **dandap-review** | `/dandap-review` | 한 줄 한 지적(위치·문제·수정안) 한국어 코드 리뷰 |
+| **dandap-help** | `/dandap-help` | 이 카드 |
+
+## 공통 원칙
+
+* 코드, 명령어, 경로, 에러 원문은 그대로 보존.
+* 부정어(`안`, `못`, `아님`, `제외`, `금지`, `실패`)는 생략 금지.
+* 코드·커밋·문서 등 채팅 외 산출물은 평서체(`-다`)로 작성.
+
+## 더 보기
+
+https://github.com/bottleroad/dandap

package/skills/dandap-review/SKILL.md

@@ -0,0 +1,64 @@
+---
+name: dandap-review
+description: >
+  한 줄당 한 지적(위치·문제·수정안) 형식의 한국어 코드 리뷰.
+  /dandap-review로 명시 호출할 때만 동작.
+version: 1.0.0
+disable-model-invocation: true
+---
+
+# dandap-review
+
+코드 리뷰 지적을 한 줄에 하나씩, 위치·문제·수정안 순서로 쓴다. 리뷰 코멘트는 PR에 남는 산출물이므로 평서체(`-다`)로 쓴다.
+
+## 형식
+
+* 단일 파일: `L<줄>: [<등급>] <문제>. <수정안>.`
+* 여러 파일: `<파일>:L<줄>: [<등급>] <문제>. <수정안>.`
+* 범위: `L88-140:`
+
+## 등급
+
+* `[버그]`: 동작이 틀렸거나 장애로 이어진다.
+* `[위험]`: 지금은 동작하지만 취약하다(경쟁 상태, null 미확인, 삼킨 예외 등).
+* `[사소]`: 스타일, 이름, 미세 최적화. 작성자가 무시해도 된다.
+* `[질문]`: 제안이 아닌 실제 질문.
+
+등급이 하나뿐인 리뷰에서는 등급 표기를 생략할 수 있다.
+
+## 지킬 것
+
+* 줄 번호를 정확히 쓴다.
+* 심볼, 함수, 변수 이름은 백틱으로 감싸 원문 그대로 쓴다.
+* "리팩터링을 고려해 보라" 같은 막연한 말 대신 구체적인 수정안을 쓴다.
+* 수정 이유가 문제 설명만으로 자명하지 않으면 이유를 덧붙인다.
+* 부정어(`안`, `못`, `아님`, `제외`, `금지`)는 생략하지 않는다.
+
+## 쓰지 않을 것
+
+* "~인 것 같습니다", "혹시 ~하면 어떨까요" 같은 완곡 표현. 확신이 없으면 `[질문]`을 쓴다.
+* 줄마다 붙는 칭찬. 전체 평가는 맨 위에 한 번만 쓴다.
+* 해당 줄이 무엇을 하는지 다시 설명하는 문장.
+
+## 예시
+
+* Bad: "42번째 줄에서 user 객체가 null인지 확인하지 않고 email에 접근하고 있는 것 같습니다. 사용자를 찾지 못하면 오류가 날 수 있으니 null 체크를 추가하면 좋을 것 같습니다."
+* Good: `L42: [버그] .find() 결과 user가 null일 수 있다. .email 접근 전에 가드를 추가한다.`
+
+* Bad: "이 함수가 하는 일이 많아 보여서 나누면 읽기 좋을 것 같습니다."
+* Good: `L88-140: [사소] 50줄 함수가 4가지 일을 한다. validate/normalize/persist로 분리한다.`
+
+* Bad: "API가 429를 반환하면 어떻게 되나요? 처리해야 할 것 같습니다."
+* Good: `L23: [위험] 429 응답에 재시도가 없다. withBackoff(3)로 감싼다.`
+
+## 완전한 문단으로 쓰는 경우
+
+다음은 한 줄로 줄이지 않고 이유와 근거를 담은 문단으로 쓴다.
+
+* 보안 취약점(CVE 수준): 영향 범위와 참고 자료를 함께 쓴다.
+* 설계 방향에 대한 이견: 근거가 필요하다.
+* 작성자가 처음 접하는 영역이라 이유 설명이 필요한 경우.
+
+## 범위
+
+리뷰 코멘트만 작성한다. 코드 수정, PR 승인·변경 요청, 린터 실행은 하지 않는다. 결과는 PR에 바로 붙여 넣을 수 있는 형태로 출력한다.