ci: 정본↔docs/en 미러 동기화 검사 추가

[amnotyoung]

왜

docs/en/CLAUDE.md가 플러그인 패키징(7/22) 이후 한 달 가까이 옛 판에 머물렀습니다. 정본만 고치고 미러를 두고 가는 걸 막는 장치가 없었기 때문입니다. 이 저장소의 첫 CI입니다.

무엇

scripts/check-mirror-sync.sh — 의존성 없는 bash 검사기(두 모드)

모드	하는 일
PR 모드(기본)	base와의 변경분에서 정본이 바뀌었는데 docs/en 미러가 안 바뀌면 실패
감사 모드(--audit)	저장소 전체에서 미러가 정본보다 낡은 쌍을 보고

• 대상: CLAUDE.md · AGENTS.md · agents/** · reference/** (미러 규칙 = docs/en/<같은 경로>)
• README.md ↔ README.ko.md는 한쪽만 고치는 일이 정상이라 경고만 합니다(실패 아님)
• 한글 파일명이 \354…로 이스케이프되면 경로 비교가 깨지므로 core.quotepath=false를 강제합니다
• 번역의 정확성은 검사하지 않습니다 — "같이 갱신했는가"만 봅니다

.github/workflows/mirror-sync.yml — PR에서 실행. 한쪽만 바꾸는 것이 의도된 PR은 mirror-sync-exempt 라벨로 건너뜁니다.

규칙과 실행법은 CLAUDE.md·docs/en/CLAUDE.md·CONTRIBUTING.md에 적었습니다. CONTRIBUTING의 미러 설명이 옛 .claude/ 레이아웃을 가리키던 것도 함께 고쳤습니다.

검증 (네 경우 실측)

경우	기대	결과
정본 변경 없음	통과	exit 0
CLAUDE.md만 변경	실패	exit 1 + 어떤 미러가 빠졌는지 명시
정본 + 미러 함께 변경	통과	exit 0
README 한쪽만 변경	경고 후 통과	exit 0 + warning

이 PR 자체에도 검사기를 돌려 통과하는 것을 확인했습니다(CLAUDE.md → docs/en/CLAUDE.md 같이 갱신됨).

⚠️ 감사 모드가 찾아낸 기존 드리프트 12건

이 PR은 막지 않습니다(PR 모드는 변경분만 보므로). 다만 --audit을 돌리면 에이전트 영문 미러 12개 전부가 낡은 것으로 나옵니다:

• 정본 agents/*.md는 플러그인 패키징(2db9167, 7/22)에서 "기준 문서 경로 (플러그인)" 절이 추가됐습니다 — 에이전트가 상대경로로 reference/…를 못 찾으니 위임 프롬프트의 절대경로를 쓰라는 지침입니다.
• 영문 미러 docs/en/agents/*.md는 246ec25(7/3)이 마지막이라 그 절이 없습니다.

12개 파일에 같은 절을 번역해 넣는 별도 작업이 필요합니다. 원하시면 이어서 처리하겠습니다.

곁들여

동반 설치 안내의 게이트웨이 도구 수를 29종 → 30종으로 고쳤습니다(oda-intelligence가 corpus overview 도구를 추가해 표면이 30종이 되었습니다).

🤖 Generated with Claude Code