sunjin12 · sunjin12 · Apr 19, 2026 · Apr 19, 2026
diff --git a/README.en.md b/README.en.md
@@ -0,0 +1,144 @@
+# Ossmate
+
+[🇰🇷 한국어](README.md) · **🇬🇧 English**
+
+[![CI](https://img.shields.io/github/actions/workflow/status/sunjin12/ossmate/ci.yml?branch=main&style=for-the-badge)](https://github.com/sunjin12/ossmate/actions)
+[![PyPI](https://img.shields.io/pypi/v/ossmate?style=for-the-badge)](https://pypi.org/project/ossmate/)
+[![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-7C3AED?style=for-the-badge)](https://github.com/sunjin12/ossmate)
+[![Python](https://img.shields.io/badge/python-3.11+-blue?style=for-the-badge)](https://www.python.org)
+[![License: MIT](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](LICENSE)
+
+> Your Claude-powered co-maintainer for open source.
+
+Ossmate automates the repetitive parts of OSS maintenance — PR triage, issue classification, release notes, dependency audits, stale-issue sweeps, and contributor onboarding — through a Claude Code plugin and a standalone CLI.
+
+It exists for two reasons:
+
+1. **A practical tool** for solo maintainers drowning in their issue queue.
+2. **A reference implementation** showing how to combine *every* Claude Code extension surface — Skills, Subagents, Hooks, MCP, Plugins, Agent SDK, Cron, Status line, Output styles, Memory, Settings, Keybindings — into a single coherent product.
+
+---
+
+## Built surfaces
+
+| Surface | Where | Status |
+|---|---|---|
+| Skills (slash commands) | [.claude/commands/](.claude/commands/) | `[x]` Phase 5 (8/8) |
+| Subagents | [.claude/agents/](.claude/agents/) | `[x]` Phase 5 (6 — haiku/sonnet/opus matched) |
+| Hooks | [.claude/hooks/](.claude/hooks/) | `[x]` Phase 3 (5 events, 21 tests) |
+| MCP server | [mcp/ossmate_mcp/](mcp/ossmate_mcp/) | `[x]` Phase 4 (11 tools, 3 templates) |
+| Plugin packaging | [.claude-plugin/](.claude-plugin/) | `[x]` Phase 6 (manifest + self-marketplace) |
+| Claude Agent SDK CLI | [cli/ossmate/](cli/ossmate/) | `[x]` Phase 7 (Typer + 8 subcommands, dry-run mode) |
+| Status line | [.claude/statusline.sh](.claude/statusline.sh) | `[x]` Phase 1 |
+| Output styles | [.claude/output-styles/](.claude/output-styles/) | `[x]` Phase 1 |
+| Scheduled triggers | [scheduled/](scheduled/) | `[x]` Phase 8 (3 cron jobs, off-minute spread) |
+| Memory templates | [.claude/CLAUDE.md](.claude/CLAUDE.md) | `[x]` Phase 0 |
+| Settings & permissions | [.claude/settings.json](.claude/settings.json) | `[x]` Phase 0 |
+| Keybindings | [.claude/keybindings.json.example](.claude/keybindings.json.example) | `[x]` Phase 1 |
+| CI / Release | [.github/workflows/](.github/workflows/) | `[x]` Phase 9 (3-OS × 3-Python matrix, OIDC PyPI publish) |
+
+---
+
+## Quickstart
+
+> Three ways to use Ossmate. Pick the one that matches your environment.
+
+### A. Claude Code Plugin (recommended)
+
+```bash
+claude plugin marketplace add https://raw.githubusercontent.com/sunjin12/ossmate/main/.claude-plugin/marketplace.json
+claude plugin install ossmate@ossmate
+```
+
+Then inside any repo:
+
+```
+/triage-pr 1234
+/release-notes v1.4.0
+/stale-sweep --days 60
+```
+
+> Plugins are namespaced under their plugin name, so `/ossmate:triage-pr 1234` works too — use the namespaced form when another installed plugin defines a same-named command.
+
+### B. Standalone CLI
+
+```bash
+pipx install ossmate
+ossmate triage-pr 1234
+ossmate release-notes v1.4.0
+ossmate triage-pr 1234 --dry-run    # print the rendered prompt + ClaudeAgentOptions
+```
+
+The CLI loads the same `.claude/commands/*.md` skill bodies the plugin uses — write a skill once, get a slash command and a CLI subcommand for free.
+
+### C. From source (development)
+
+```bash
+git clone https://github.com/sunjin12/ossmate.git
+cd ossmate
+bash scripts/dev_link.sh        # editable install of mcp + cli, runs --check
+# Windows:
+# powershell -ExecutionPolicy Bypass -File scripts/dev_link.ps1
+pytest -q                       # 160 hermetic tests, ~5s
+```
+
+---
+
+## Architecture
+
+```mermaid
+flowchart LR
+    User([Maintainer])
+    User -->|slash commands| CC[Claude Code]
+    User -->|terminal / CI| CLI[ossmate CLI]
+    CC --> Skills[Skills]
+    CC --> Hooks[Hooks]
+    Skills --> Subagents
+    Subagents --> MCP[ossmate MCP server]
+    CLI --> SDK[Claude Agent SDK]
+    SDK --> MCP
+    MCP --> GH[(GitHub API)]
+    MCP --> Repo[(Local repo)]
+    MCP --> Adv[(OSV advisories)]
+```
+
+The same MCP server backs both the plugin and the standalone CLI — write tools once, use them everywhere.
+
+---
+
+## Why each surface?
+
+Ossmate uses every harness extension because the OSS-maintainer domain genuinely needs each one. This isn't a contrived demo — read [docs/architecture.md](docs/architecture.md) for the per-surface justification.
+
+---
+
+## Self-dogfooding
+
+The CHANGELOG of this repo is generated by Ossmate itself, scheduled triggers run nightly digests on this very repo, and the PreToolUse hook protects `main` from accidental force-pushes. See [CHANGELOG.md](CHANGELOG.md).
+
+---
+
+## Releasing
+
+Two PyPI projects (`ossmate-mcp` and `ossmate`) ship together — version, tag, push, GitHub Actions does the rest:
+
+```bash
+python scripts/bump_version.py 0.2.0   # bumps both pyprojects + plugin.json + marketplace.json
+python scripts/bump_version.py --check # invariant: all 5 markers agree
+git commit -am "chore(release): v0.2.0"
+git tag v0.2.0 && git push --tags      # blocked by PreToolUse hook unless explicitly approved
+```
+
+The release workflow refuses to publish if the tag's version disagrees with `pyproject.toml`. PyPI uploads use OIDC trusted publishing — no API tokens stored in repo secrets.
+
+---
+
+## Development status
+
+Currently building in phases — see [memory/project_phases.md](https://github.com/sunjin12/ossmate/blob/main/memory/project_phases.md) for the plan. Each phase is tagged (`phase-0`, `phase-1`, …) so you can browse the project's evolution.
+
+---
+
+## License
+
+MIT — see [LICENSE](LICENSE).
diff --git a/README.md b/README.md
@@ -1,88 +1,90 @@
 # Ossmate
 
+**🇰🇷 한국어** · [🇬🇧 English](README.en.md)
+
 [![CI](https://img.shields.io/github/actions/workflow/status/sunjin12/ossmate/ci.yml?branch=main&style=for-the-badge)](https://github.com/sunjin12/ossmate/actions)
 [![PyPI](https://img.shields.io/pypi/v/ossmate?style=for-the-badge)](https://pypi.org/project/ossmate/)
 [![Claude Code Plugin](https://img.shields.io/badge/Claude%20Code-Plugin-7C3AED?style=for-the-badge)](https://github.com/sunjin12/ossmate)
 [![Python](https://img.shields.io/badge/python-3.11+-blue?style=for-the-badge)](https://www.python.org)
 [![License: MIT](https://img.shields.io/badge/license-MIT-green?style=for-the-badge)](LICENSE)
 
-> Your Claude-powered co-maintainer for open source.
+> Claude 기반 오픈소스 메인테이너 보조 도구.
 
-Ossmate automates the repetitive parts of OSS maintenance — PR triage, issue classification, release notes, dependency audits, stale-issue sweeps, and contributor onboarding — through a Claude Code plugin and a standalone CLI.
+Ossmate는 OSS 메인테이너의 반복 업무 — PR 트리아지, 이슈 분류, 릴리스 노트 작성, 의존성 감사, stale 이슈 정리, 컨트리뷰터 온보딩 — 을 Claude Code 플러그인과 독립 CLI로 자동화합니다.
 
-It exists for two reasons:
+두 가지 목적으로 만들어졌습니다:
 
-1. **A practical tool** for solo maintainers drowning in their issue queue.
-2. **A reference implementation** showing how to combine *every* Claude Code extension surface — Skills, Subagents, Hooks, MCP, Plugins, Agent SDK, Cron, Status line, Output styles, Memory, Settings, Keybindings — into a single coherent product.
+1. **실용 도구** — 이슈 큐에 빠져 죽는 솔로 메인테이너를 위한 진짜 도구.
+2. **레퍼런스 구현체** — Claude Code의 *모든* 확장 표면(Skills, Subagents, Hooks, MCP, Plugins, Agent SDK, Cron, Status line, Output styles, Memory, Settings, Keybindings)을 하나의 일관된 제품으로 결합한 사례.
 
 ---
 
-## Built surfaces
+## 구축된 표면
 
-| Surface | Where | Status |
+| 표면 | 위치 | 상태 |
 |---|---|---|
-| Skills (slash commands) | [.claude/commands/](.claude/commands/) | `[x]` Phase 5 (8/8) |
-| Subagents | [.claude/agents/](.claude/agents/) | `[x]` Phase 5 (6 — haiku/sonnet/opus matched) |
-| Hooks | [.claude/hooks/](.claude/hooks/) | `[x]` Phase 3 (5 events, 21 tests) |
-| MCP server | [mcp/ossmate_mcp/](mcp/ossmate_mcp/) | `[x]` Phase 4 (11 tools, 3 templates) |
-| Plugin packaging | [.claude-plugin/](.claude-plugin/) | `[x]` Phase 6 (manifest + self-marketplace) |
-| Claude Agent SDK CLI | [cli/ossmate/](cli/ossmate/) | `[x]` Phase 7 (Typer + 8 subcommands, dry-run mode) |
+| Skills (슬래시 명령) | [.claude/commands/](.claude/commands/) | `[x]` Phase 5 (8/8) |
+| Subagents | [.claude/agents/](.claude/agents/) | `[x]` Phase 5 (6개 — haiku/sonnet/opus 매칭) |
+| Hooks | [.claude/hooks/](.claude/hooks/) | `[x]` Phase 3 (5개 이벤트, 21개 테스트) |
+| MCP 서버 | [mcp/ossmate_mcp/](mcp/ossmate_mcp/) | `[x]` Phase 4 (11개 도구, 3개 템플릿) |
+| 플러그인 패키징 | [.claude-plugin/](.claude-plugin/) | `[x]` Phase 6 (manifest + 자체 마켓플레이스) |
+| Claude Agent SDK CLI | [cli/ossmate/](cli/ossmate/) | `[x]` Phase 7 (Typer + 8개 서브커맨드, dry-run 모드) |
 | Status line | [.claude/statusline.sh](.claude/statusline.sh) | `[x]` Phase 1 |
 | Output styles | [.claude/output-styles/](.claude/output-styles/) | `[x]` Phase 1 |
-| Scheduled triggers | [scheduled/](scheduled/) | `[x]` Phase 8 (3 cron jobs, off-minute spread) |
+| Scheduled triggers | [scheduled/](scheduled/) | `[x]` Phase 8 (3개 cron 잡, off-minute 분산) |
 | Memory templates | [.claude/CLAUDE.md](.claude/CLAUDE.md) | `[x]` Phase 0 |
 | Settings & permissions | [.claude/settings.json](.claude/settings.json) | `[x]` Phase 0 |
 | Keybindings | [.claude/keybindings.json.example](.claude/keybindings.json.example) | `[x]` Phase 1 |
-| CI / Release | [.github/workflows/](.github/workflows/) | `[x]` Phase 9 (3-OS × 3-Python matrix, OIDC PyPI publish) |
+| CI / Release | [.github/workflows/](.github/workflows/) | `[x]` Phase 9 (3-OS × 3-Python 매트릭스, OIDC PyPI 발행) |
 
 ---
 
-## Quickstart
+## 빠른 시작
 
-> Three ways to use Ossmate. Pick the one that matches your environment.
+> 세 가지 사용 방법이 있습니다. 본인 환경에 맞는 것을 고르세요.
 
-### A. Claude Code Plugin (recommended)
+### A. Claude Code 플러그인 (권장)
 
 ```bash
 claude plugin marketplace add https://raw.githubusercontent.com/sunjin12/ossmate/main/.claude-plugin/marketplace.json
 claude plugin install ossmate@ossmate
 ```
 
-Then inside any repo:
+설치 후 어느 repo에서나:
 
 ```
 /triage-pr 1234
 /release-notes v1.4.0
 /stale-sweep --days 60
 ```
 
-> Plugins are namespaced under their plugin name, so `/ossmate:triage-pr 1234` works too — use the namespaced form when another installed plugin defines a same-named command.
+> 플러그인은 자체 네임스페이스를 가지므로 `/ossmate:triage-pr 1234` 형식도 작동합니다 — 다른 플러그인과 명령 이름이 충돌할 때 네임스페이스 형식을 쓰세요.
 
-### B. Standalone CLI
+### B. 독립 CLI
 
 ```bash
 pipx install ossmate
 ossmate triage-pr 1234
 ossmate release-notes v1.4.0
-ossmate triage-pr 1234 --dry-run    # print the rendered prompt + ClaudeAgentOptions
+ossmate triage-pr 1234 --dry-run    # 렌더링된 prompt + ClaudeAgentOptions 출력
 ```
 
-The CLI loads the same `.claude/commands/*.md` skill bodies the plugin uses — write a skill once, get a slash command and a CLI subcommand for free.
+CLI는 플러그인이 사용하는 동일한 `.claude/commands/*.md` 스킬 본문을 로드합니다 — 스킬을 한 번 작성하면 슬래시 명령과 CLI 서브커맨드가 자동으로 함께 생깁니다.
 
-### C. From source (development)
+### C. 소스에서 (개발용)
 
 ```bash
 git clone https://github.com/sunjin12/ossmate.git
 cd ossmate
-bash scripts/dev_link.sh        # editable install of mcp + cli, runs --check
+bash scripts/dev_link.sh        # mcp + cli editable 설치, --check 자동 실행
 # Windows:
 # powershell -ExecutionPolicy Bypass -File scripts/dev_link.ps1
-pytest -q                       # 160 hermetic tests, ~5s
+pytest -q                       # 161개 hermetic 테스트, ~5초
 ```
 
 ---
 
-## Architecture
+## 아키텍처
 
 ```mermaid
 flowchart LR
@@ -100,43 +102,45 @@ flowchart LR
     MCP --> Adv[(OSV advisories)]
 ```
 
-The same MCP server backs both the plugin and the standalone CLI — write tools once, use them everywhere.
+같은 MCP 서버가 플러그인과 독립 CLI 양쪽을 모두 지원합니다 — 도구를 한 번 작성하면 어디서나 사용 가능.
 
 ---
 
-## Why each surface?
+## 왜 모든 표면을 사용했나?
 
-Ossmate uses every harness extension because the OSS-maintainer domain genuinely needs each one. This isn't a contrived demo — read [docs/architecture.md](docs/architecture.md) for the per-surface justification.
+Ossmate가 모든 하네스 확장을 사용하는 이유는 OSS 메인테이너 도메인이 각각을 *진짜로* 필요로 하기 때문입니다. 단순 데모가 아닙니다 — 표면별 정당화는 [docs/architecture.md](docs/architecture.md)를 참조하세요.
 
 ---
 
 ## Self-dogfooding
 
-The CHANGELOG of this repo is generated by Ossmate itself, scheduled triggers run nightly digests on this very repo, and the PreToolUse hook protects `main` from accidental force-pushes. See [CHANGELOG.md](CHANGELOG.md).
+이 저장소의 CHANGELOG는 Ossmate 자신이 생성하고, 스케줄된 트리거가 매일 이 repo에 다이제스트를 돌리며, PreToolUse 훅이 실수로 `main`에 force-push 하는 것을 막습니다. [CHANGELOG.md](CHANGELOG.md)를 참조하세요.
 
 ---
 
-## Releasing
+## 릴리스 방법
 
-Two PyPI projects (`ossmate-mcp` and `ossmate`) ship together — version, tag, push, GitHub Actions does the rest:
+두 PyPI 프로젝트(`ossmate-mcp`, `ossmate`)는 함께 출시됩니다 — 버전 올리고, 태그 달고, push만 하면 GitHub Actions가 나머지를 처리합니다:
 
 ```bash
-python scripts/bump_version.py 0.2.0   # bumps both pyprojects + plugin.json + marketplace.json
-python scripts/bump_version.py --check # invariant: all 5 markers agree
+python scripts/bump_version.py 0.2.0   # 두 pyproject + plugin.json + marketplace.json 동시 갱신
+python scripts/bump_version.py --check # invariant: 5곳 모두 일치 확인
 git commit -am "chore(release): v0.2.0"
-git tag v0.2.0 && git push --tags      # blocked by PreToolUse hook unless explicitly approved
+git tag v0.2.0 && git push --tags      # PreToolUse 훅이 명시적 승인 없이는 차단
 ```
 
-The release workflow refuses to publish if the tag's version disagrees with `pyproject.toml`. PyPI uploads use OIDC trusted publishing — no API tokens stored in repo secrets.
+릴리스 워크플로우는 태그 버전과 `pyproject.toml` 버전이 다르면 발행을 거부합니다. PyPI 업로드는 OIDC 신뢰 발행 방식 — 저장소 시크릿에 API 토큰이 없습니다.
 
 ---
 
-## Development status
+## 개발 현황
+
+단계별로 빌드되었습니다 — 계획은 [memory/project_phases.md](https://github.com/sunjin12/ossmate/blob/main/memory/project_phases.md)에 있습니다. 각 단계는 태그(`phase-0`, `phase-1`, …)로 마킹되어 있어 프로젝트의 진화 과정을 따라가볼 수 있습니다.
 
-Currently building in phases — see [memory/project_phases.md](https://github.com/sunjin12/ossmate/blob/main/memory/project_phases.md) for the plan. Each phase is tagged (`phase-0`, `phase-1`, …) so you can browse the project's evolution.
+**v0.1.0 (2026-04-19)** — 첫 공개 릴리스. 모든 12개 표면 작동, PyPI 발행 완료.
 
 ---
 
-## License
+## 라이선스
 
-MIT — see [LICENSE](LICENSE).
+MIT — [LICENSE](LICENSE) 참조.