Mirror Korean docs under notes

Author: choi-hyk

AGENTS.md

@@ -2,7 +2,7 @@
 
 This repository is B4Bot, the agent-based project management bot for Blueprint4Agent.
 
-Korean version: `AGENTS.ko.md`
+Korean translation: `notes/ko/AGENTS.md`
 
 ## Repository Scope
 
@@ -20,13 +20,15 @@ Default policy:
 ## Required Read Order
 
 1. `AGENTS.md` or `AGENTS.ko.md`
-2. `README.md` or `README.ko.md`
+   - Korean translation: `notes/ko/AGENTS.md`
+2. `README.md`
+   - Korean translation: `notes/ko/README.md`
 3. `docs/configuration.md`
-   - Korean translation: `notes/ko/configuration.md`
+   - Korean translation: `notes/ko/docs/configuration.md`
 4. `docs/issue-generation-policy.md`
-   - Korean translation: `notes/ko/issue-generation-policy.md`
+   - Korean translation: `notes/ko/docs/issue-generation-policy.md`
 5. `docs/priority-policy.md`
-   - Korean translation: `notes/ko/priority-policy.md`
+   - Korean translation: `notes/ko/docs/priority-policy.md`
 6. Provider-specific docs when editing provider adapters
 
 ## Architecture
@@ -38,7 +40,7 @@ Default policy:
 - `src/providers/`: AI provider adapters
 - `src/review/`: issue generation planning and normalization
 - `docs/`: English user-facing operating policies
-- `notes/ko/`: Korean translations for user-facing operating policies
+- `notes/ko/`: Korean translations that mirror the root repository structure
 - `templates/`: target repository setup examples
 
 ## Development Rules
@@ -47,9 +49,9 @@ Default policy:
 - Keep provider implementations behind the `AiProvider` interface.
 - Do not store provider API keys in this repository.
 - Use target repository secrets such as `B4BOT_PROVIDER_API_KEY`.
-- Keep `AGENTS.md` and `AGENTS.ko.md` synchronized.
-- Keep `README.md` and `README.ko.md` synchronized.
-- Keep Korean translations under `notes/ko/` synchronized with English docs under `docs/`.
+- Keep `AGENTS.md` and `notes/ko/AGENTS.md` synchronized.
+- Keep `README.md` and `notes/ko/README.md` synchronized.
+- Keep Korean translations under `notes/ko/docs/` synchronized with English docs under `docs/`.
 
 ## Verification
 

README.md

@@ -75,7 +75,13 @@ The MVP includes:
 ## Documentation
 
 - English operating docs are maintained under `docs/`.
-- Korean translations are maintained under `notes/ko/`.
+- Korean translations mirror the repository structure under `notes/ko/`.
+
+Examples:
+
+- `AGENTS.md` -> `notes/ko/AGENTS.md`
+- `README.md` -> `notes/ko/README.md`
+- `docs/configuration.md` -> `notes/ko/docs/configuration.md`
 
 ## Development
 

AGENTS.ko.md notes/ko/AGENTS.mdAGENTS.ko.md renamed to notes/ko/AGENTS.md

@@ -19,14 +19,16 @@ B4Bot은 대상 저장소를 검토하고 scope별 프로젝트 관리 이슈를
 
 ## 필수 문서 읽기 순서
 
-1. `AGENTS.md` 또는 `AGENTS.ko.md`
-2. `README.md` 또는 `README.ko.md`
+1. `AGENTS.md`
+   - 한국어 번역: `notes/ko/AGENTS.md`
+2. `README.md`
+   - 한국어 번역: `notes/ko/README.md`
 3. `docs/configuration.md`
-   - 한국어 번역: `notes/ko/configuration.md`
+   - 한국어 번역: `notes/ko/docs/configuration.md`
 4. `docs/issue-generation-policy.md`
-   - 한국어 번역: `notes/ko/issue-generation-policy.md`
+   - 한국어 번역: `notes/ko/docs/issue-generation-policy.md`
 5. `docs/priority-policy.md`
-   - 한국어 번역: `notes/ko/priority-policy.md`
+   - 한국어 번역: `notes/ko/docs/priority-policy.md`
 6. provider adapter를 수정할 경우 provider 관련 문서
 
 ## 구조
@@ -38,7 +40,7 @@ B4Bot은 대상 저장소를 검토하고 scope별 프로젝트 관리 이슈를
 - `src/providers/`: AI provider adapter
 - `src/review/`: issue 생성 계획과 정규화
 - `docs/`: 영어 사용자 대상 운영 정책
-- `notes/ko/`: 사용자 대상 운영 정책의 한국어 번역
+- `notes/ko/`: 루트 저장소 구조를 따라가는 한국어 번역
 - `templates/`: 대상 저장소 설정 예시
 
 ## 개발 규칙
@@ -47,9 +49,9 @@ B4Bot은 대상 저장소를 검토하고 scope별 프로젝트 관리 이슈를
 - provider 구현은 `AiProvider` 인터페이스 뒤에 둔다.
 - provider API key를 이 저장소에 저장하지 않는다.
 - `B4BOT_PROVIDER_API_KEY` 같은 대상 저장소 secret을 사용한다.
-- `AGENTS.md`와 `AGENTS.ko.md`를 동기화한다.
-- `README.md`와 `README.ko.md`를 동기화한다.
-- `docs/`의 영어 문서와 `notes/ko/`의 한국어 번역을 동기화한다.
+- `AGENTS.md`와 `notes/ko/AGENTS.md`를 동기화한다.
+- `README.md`와 `notes/ko/README.md`를 동기화한다.
+- `docs/`의 영어 문서와 `notes/ko/docs/`의 한국어 번역을 동기화한다.
 
 ## 검증
 

README.ko.md notes/ko/README.mdREADME.ko.md renamed to notes/ko/README.md

@@ -75,7 +75,13 @@ MVP에는 다음 provider가 포함된다.
 ## 문서
 
 - 영어 운영 문서는 `docs/`에서 관리한다.
-- 한국어 번역은 `notes/ko/`에서 관리한다.
+- 한국어 번역은 `notes/ko/` 아래에서 저장소 구조를 따라 관리한다.
+
+예시:
+
+- `AGENTS.md` -> `notes/ko/AGENTS.md`
+- `README.md` -> `notes/ko/README.md`
+- `docs/configuration.md` -> `notes/ko/docs/configuration.md`
 
 ## 개발