sonmat

> 엄마 손맛은 맛있는데 왜 내가 하면..?
> Your AI is confident. Your AI is wrong. And neither of you noticed.
손맛은 AI와 사용자 양쪽에 **의심하고 검증하는 습관**을 심는 Claude Code·Codex 플러그인입니다.
What this is
A Claude Code and Codex plugin that builds the habit of **doubting and correcting** on both sides.
Your AI delivers answers with confidence but no verification. You accept them because they sound right. Nobody checks. Errors compound silently.
sonmat breaks this cycle:
- **For the AI** — injects a verification discipline into every agent, including subagents. Break it (find where it fails), Cross it (verify independently), Ground it (execute, don't assume).
- **For you** — surfaces the AI's reasoning transparently so you can actually judge instead of just trusting.
That's it. Everything else is implementation.
Install
Claude Code
On first session, sonmat plants a reference block in your ~/.claude/CLAUDE.md automatically. Start talking.
Codex
Start a new thread and open /hooks. Review the SessionStart hook before trusting it. Codex binds trust to the hook hash, so a changed hook waits for review instead of running silently.
The hook engages the discipline through session context without editing AGENTS.md. It also reports the exact path of the optional native-agent installer. Review that script, then run the command it prints to install sonmat_worker, sonmat_witness, and sonmat_scribe under ~/.codex/agents/. The installer is idempotent and refuses to overwrite a locally modified agent unless you pass --force.
Reinstall
스킬이 보이지 않을 때 (터미널에서 직접 실행):
위 방법이 안 되면 수동 클론 후 등록:
자세한 진단 방법은 Troubleshooting 참고.
Platform notes
sonmat works on both Windows and Linux/macOS. The hook layer (run-hook.cmd) is a polyglot script — cmd.exe runs the batch portion, Unix shells run the bash portion.
**Windows (native)**
- Claude Code calls run-hook.cmd via cmd.exe
- The script finds Git for Windows bash (C:\Program Files\Git\bin\bash.exe) or any bash on PATH
- No extra setup needed if Git for Windows is installed
> **Git Bash (MSYS2) 주의**: Git Bash에서 /plugin install 등 슬래시 명령 실행 시 MSYS2가 경로를 자동 변환하여 C:/Program Files/Git/plugin처럼 깨질 수 있다. MSYS_NO_PATHCONV=1 환경변수를 설정하거나, WSL2 사용을 권장한다.
>
>
**Windows (WSL2) — recommended**
- Claude Code runs inside WSL2, so hooks execute as plain bash
- Paths stay Linux-native (~/.claude/...) — no cross-filesystem issues
- Git Bash의 MSYS2 경로 변환 문제가 없음
- settings.json hooks should point to the bash script directly:
**Linux / macOS**
- Works out of the box. No special config.
Other AI CLIs
Claude Code and Codex have native plugin adapters. The discipline and skills remain plain markdown, so other AI CLIs can use them with a manual setup.
Each CLI has its own global instruction mechanism. For project rules, sonmat uses AGENTS.md wherever the harness supports it; Claude Code reads it through a minimal CLAUDE.md adapter.
| CLI | Global instruction file | Project rule file | Where to put sonmat files |
|-----|-------------------------|-------------------|--------------------------|
| Claude Code | CLAUDE.md | AGENTS.md (CLAUDE.md imports it) | Plugin install (see above) |
| Codex | AGENTS.md | AGENTS.md | Native plugin install above |
| Gemini CLI | GEMINI.md | Its native project instruction file | ~/.gemini/sonmat/ |
| Other | Whatever file your CLI reads as its main guide | Its native project instruction file | Copy there |
**Setup (CLIs without a native adapter):**
Paste the following into your first conversation with the AI. It will set up sonmat in its own environment:
Claude Code and Codex handle discipline loading through their plugin adapters. For other CLIs, the AI sets itself up from the instruction above.
Design philosophy