diff --git a/AGENTS.md b/AGENTS.md
index 259dca8cf..ed94acc14 100644
--- a/AGENTS.md
+++ b/AGENTS.md
@@ -95,6 +95,10 @@ gh workflow run deploy_batch.yml -f environment=production -f version=1.2.3
gh workflow run deploy_development_applications.yml
```
+## 이슈 관리
+
+이슈의 SSOT는 [bottle-note/workspace](https://github.com/bottle-note/workspace) 레포지토리다. 이슈는 이 레포가 아니라 workspace에 등록하고, 작업 시작 전 관련 이슈를 먼저 확인한다. PR 본문에는 `bottle-note/workspace#N` 형식으로 관련 이슈를 링크한다.
+
## Skills (Development Workflow)
Use these skills to follow the structured development lifecycle:
diff --git a/CLAUDE.md b/CLAUDE.md
index af9a9ef0c..596f6b7b8 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -95,6 +95,10 @@ gh workflow run deploy_batch.yml -f environment=production -f version=1.2.3
gh workflow run deploy_development_applications.yml
```
+## 이슈 관리
+
+이슈의 SSOT는 [bottle-note/workspace](https://github.com/bottle-note/workspace) 레포지토리다. 이슈는 이 레포가 아니라 workspace에 등록하고, 작업 시작 전 관련 이슈를 먼저 확인한다. PR 본문에는 `bottle-note/workspace#N` 형식으로 관련 이슈를 링크한다.
+
## Skills (Development Workflow)
Use these skills to follow the structured development lifecycle:
diff --git a/README.md b/README.md
index 69a06bcd6..8f2adefe2 100644
--- a/README.md
+++ b/README.md
@@ -71,6 +71,13 @@
---
+## 이슈 관리
+
+기능 요청, 버그 리포트, 작업 항목 등 모든 이슈는 [bottle-note/workspace](https://github.com/bottle-note/workspace) 레포지토리에서 관리합니다.
+이슈의 SSOT는 workspace이며, PR 작성 시 본문에 `bottle-note/workspace#N` 형식으로 관련 이슈를 링크해 주세요.
+
+---
+
보틀노트는 위스키 애호가들이 모여 서로의 의견을 공유하고
더욱 즐겁고 유익한 시음 경험을 할 수 있도록 도와줍니다.