Skip to content

docs: 에이전트 영문 미러 12개를 정본과 동기화 - #11

Merged
amnotyoung merged 1 commit into
mainfrom
docs/sync-agent-mirrors
Aug 1, 2026
Merged

docs: 에이전트 영문 미러 12개를 정본과 동기화#11
amnotyoung merged 1 commit into
mainfrom
docs/sync-agent-mirrors

Conversation

@amnotyoung

Copy link
Copy Markdown
Owner

무엇

PR #10에서 붙인 mirror-sync 감사가 찾아낸 드리프트를 해소합니다.

정본 agents/*.md는 플러그인 패키징(2db9167, 7/22)에서 "기준 문서 경로 (플러그인)" 절을 얻었는데, 영문 미러는 246ec25(7/3)이 마지막이라 그 절이 없었습니다. 이 절은 단순 설명이 아니라 에이전트가 상대경로로 reference/…를 못 찾는다는 핵심 제약과 그 대응(위임 프롬프트의 절대경로 사용, 못 받으면 추측 말고 요청)을 담고 있어서, 미러만 보고 작업하면 그대로 실패합니다.

한 일

  • 12개 미러 전부## Reference document paths (plugin) 절 추가. 정본과 같은 자리(첫 절)이고, 12개 정본의 해당 절 본문이 서로 완전히 동일(해시 일치)해 한 번 번역해 넣었습니다. 용어는 미러의 기존 표기를 따랐습니다 — Evaluation Lead (orchestrator), evaluation officer.
  • 미러 머리말의 옛 경로 교정: 12개 전부 `.claude/agents/…`를 가리키고 있었습니다 → `agents/…`.

검증

  • 절 수 대조: 12쌍 모두 일치 (예: relevance 10절/10절, effectiveness 13절/13절)
  • scripts/check-mirror-sync.sh --audit통과 (직전까지 12건 실패)
  • PR 모드 → 통과 (미러만 바꾸는 변경은 규칙상 허용)

🤖 Generated with Claude Code

mirror-sync 감사가 찾아낸 드리프트를 해소한다. 정본 agents/*.md는 플러그인
패키징(2db9167, 7/22)에서 "기준 문서 경로 (플러그인)" 절을 얻었는데, 영문
미러는 246ec25(7/3)이 마지막이라 그 절이 없었다. 미러만 보고 작업하면
에이전트가 상대경로로 reference/를 찾다 실패한다는 핵심 제약을 놓친다.

- 12개 미러 전부에 "Reference document paths (plugin)" 절 추가 — 정본과
  같은 자리(첫 절)이고, 12개 정본의 해당 절 본문이 서로 동일해 한 번
  번역해 넣었다. 용어는 미러의 기존 표기를 따랐다(Evaluation Lead
  (orchestrator), evaluation officer)
- 미러 머리말이 가리키던 옛 경로 `.claude/agents/…`를 현재 `agents/…`로
  교정 (12개 전부 옛 경로였다)

절 수가 12쌍 모두 일치하고, scripts/check-mirror-sync.sh --audit이 통과한다.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
@amnotyoung
amnotyoung merged commit b9abe36 into main Aug 1, 2026
1 check passed
@amnotyoung
amnotyoung deleted the docs/sync-agent-mirrors branch August 1, 2026 23:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant