📝 하네스 에이전트 진입점 정리

[gaeng2y]

📝 Summary

하네스 4차 작업으로 에이전트별 진입 파일 운영 기준을 정리했습니다.

AGENTS.md를 공통 AI 에이전트 작업 규칙의 SSOT로 유지하고, CLAUDE.md와 GEMINI.md는 AGENTS.md symlink 진입점으로 유지한다는 기준을 하네스/문서 유지보수 문서에 반영했습니다.

🎯 Type of Change

• ✨ New feature (새로운 기능 추가)
• 🐛 Bug fix (버그 수정)
• 🔧 Configuration (설정 변경)
• ♻️ Refactoring (코드 리팩토링)
• 📝 Documentation (문서 수정)
• 🎨 UI/UX (디자인 변경)
• ⚡ Performance (성능 개선)
• 🛡️ Security (보안 강화)
• 🧪 Test (테스트 추가/수정)
• 🔨 Build (빌드 시스템 수정)

🔗 Related Issues

• Closes 하네스 4차 #217
• Related to 하네스 엔지니어링 정리 #189
• Related to 하네스 3차 #205

📋 Changes Made

Added

• AGENTS.md에 에이전트별 진입 파일을 얇은 포인터로 유지한다는 규칙을 추가했습니다.
• Docs/harness-engineering.md에 CLAUDE.md, GEMINI.md의 symlink 진입점 역할을 명시했습니다.
• Docs/documentation-maintenance.md에 도구별 파일에 공통 규칙을 복제하지 않는 기준을 추가했습니다.

Changed

• Docs/exec-plans/tech-debt-tracker.md의 에이전트별 중복 안내 정리 부채를 Closed로 이동했습니다.

Fixed

• 하네스 문서가 에이전트별 진입 파일 구조를 명시하지 않아 향후 공통 규칙이 중복 복제될 수 있던 운영 공백을 보완했습니다.

Removed

• 없음

🔍 Technical Details

문서 전용 변경입니다. CLAUDE.md, GEMINI.md는 기존처럼 AGENTS.md symlink 상태를 유지하고, 공통 규칙의 본문은 AGENTS.md에만 두는 운영 기준을 문서화했습니다.

📸 Screenshots / Videos

Before

문서 전용 변경으로 별도 첨부 없음

After

문서 전용 변경으로 별도 첨부 없음

✅ Testing

Test Plan

• 앱 빌드 성공
• Debug 모드 정상 작동
• Release 모드 정상 작동
• 기존 기능 영향 없음
• Widget Extension 정상 작동 (해당시)

Test Environment

• iOS Version: N/A
• Device: N/A
• Xcode Version: N/A

Test Results

• git diff --check 통과
• make lint 통과
• make arch-check 통과
• 문서 전용 변경이라 앱 빌드와 런타임 QA는 수행하지 않았습니다.

🚨 Breaking Changes

• Yes (아래에 설명)
• No

📌 Additional Notes

• 하네스 4차 #217 이슈 본문은 비어 있어, 이전 하네스 작업(하네스 엔지니어링 정리 #189, 하네스 3차 #205) 이후 남은 tech debt 항목을 기준으로 범위를 잡았습니다.
• CI 확인 전 상태를 명확히 하기 위해 Draft PR로 생성합니다.

👀 Review Checklist

• 코드가 프로젝트의 코딩 컨벤션을 따르고 있나요?
• 새로운 의존성이 필요한가요? 없음
• 문서 업데이트가 필요한가요? 반영 완료
• 데이터베이스 마이그레이션이 필요한가요? 없음
• 환경 설정 변경이 필요한가요? 없음