diff --git a/README.md b/README.md
index e4f2f01..a2f66e8 100644
--- a/README.md
+++ b/README.md
@@ -35,6 +35,7 @@ Slack 기반 AI 어시스턴트 **로빙(Robeing)** 프로젝트의 모든 문
 
 ### 트러블슈팅
 - [troubleshooting](./docs/troubleshooting/) - 문제 해결 가이드 모음
+  - [GitHub → Gitea 마이그레이션](./docs/troubleshooting/20250714_migration_from_github.md)
 
 ### 외부 참조
 - [Slack API 문서](https://api.slack.com/web)
diff --git a/docs/20250714_migration_from_github.md b/docs/troubleshooting/20250714_migration_from_github.md
similarity index 100%
rename from docs/20250714_migration_from_github.md
rename to docs/troubleshooting/20250714_migration_from_github.md