Hermes 하네스를 제거하고 AI 작업 규칙 문서를 재구성한다

[opficdev]

문제

현재 저장소의 AI 작업 규칙은 AGENTS.md, AGENT_ROLES.md, AGENT_WORKFLOWS.md, .hermes/skills/devlog-architecture-harness에 분산되어 있습니다.

Codex 역할별 custom agent와 실행 workflow가 구성된 이후에도 Hermes 전용 디렉터리와 메타데이터가 남아 있으며, 다음 문제가 있습니다.

• AGENTS.md가 라우팅 진입점과 세부 규칙을 함께 소유하는 구조
• AGENTS.md와 Hermes architecture harness 사이의 아키텍처 규칙 중복
• AGENT_ROLES.md, AGENT_WORKFLOWS.md가 저장소 최상위에 분산된 구조
• Hermes를 사용하지 않는 현재 실행 환경에서도 .hermes 경로를 필수로 참조하는 구조
• 역할 정의, 실행 workflow, 아키텍처 규칙, 프로젝트 작업 규칙의 소유 파일이 명확히 분리되지 않은 상태

Hermes를 완전히 제거하고 AGENTS.md를 최소한의 라우팅 문서로 재구성해야 합니다.

결정 사항

• .hermes 디렉터리와 Hermes 전용 메타데이터를 완전히 제거합니다.
• AGENTS.md는 저장소 AI 규칙의 진입점과 문서 라우팅만 담당합니다.
• 기존 세부 규칙은 .agents 디렉터리로 이동합니다.
• 역할 정의와 실행 workflow도 .agents 아래로 이동합니다.
• .codex/agents/*.toml은 역할별 실제 모델과 권한 설정을 계속 담당합니다.
• 기존 문서 내용은 가급적 그대로 이동하고 참조 경로만 변경하여 diff를 최소화합니다.
• 문장 정리나 규칙 재작성은 Hermes 제거와 분리합니다.
• Swift 및 iOS 프로젝트 파일은 변경하지 않습니다.

문서 구조

AGENTS.md

.agents/
├── roles.md
├── workflows.md
└── rules/
    ├── general.md
    ├── architecture.md
    └── project-workflows.md

.codex/
└── agents/
    ├── architecture_watcher.toml
    ├── code_reviewer.toml
    ├── documentation_writer.toml
    ├── github_ci_analyst.toml
    └── verification_runner.toml

파일별 책임

• AGENTS.md
  • 모든 작업의 진입점
  • 작업 종류별 필수 문서 경로
  • 문서 간 우선순위
• .agents/rules/general.md
  • 로직 보존과 복잡도 기준
  • 코드 수정 응답 방식
  • Swift 명명 및 작성 규칙
• .agents/roles.md
  • 역할별 책임과 권한
  • 모델 등급과 custom agent 연결
  • 결과 형식과 Task Packet
• .agents/workflows.md
  • 작업 유형별 역할 실행 순서
  • 중단 조건과 완료 조건
• .agents/rules/architecture.md
  • 레이어 맵과 의존 방향
  • DI와 외부 SDK 배치
  • Widget 및 StorePattern 경계
  • 아키텍처 모호성 중단 조건
• .agents/rules/project-workflows.md
  • SwiftLint와 build-only 검증
  • Tuist 및 Xcode project 작업
  • PR, review thread, 커밋, CI
  • Localization과 배포 규칙
• .codex/agents/*.toml
  • 역할별 실제 모델
  • 추론 수준
  • sandbox 권한
  • 역할별 실행 지침

라우팅 기준

작업	필수 문서
모든 작업	.agents/rules/general.md
역할 분리가 필요한 작업	.agents/roles.md
반복 실행 절차가 필요한 작업	.agents/workflows.md
모듈·DI·SDK·Widget·StorePattern 작업	.agents/rules/architecture.md
PR·커밋·CI·검증·Localization·배포 작업	.agents/rules/project-workflows.md

수정 방향

• AGENT_ROLES.md를 .agents/roles.md로 이동합니다.
• AGENT_WORKFLOWS.md를 .agents/workflows.md로 이동합니다.
• AGENTS.md의 일반 규칙을 .agents/rules/general.md로 이동합니다.
• .hermes/skills/devlog-architecture-harness/references/devlog-architecture-flow.md의 규칙을 .agents/rules/architecture.md로 이동합니다.
• .hermes/skills/devlog-architecture-harness/references/devlog-workflow-rules.md를 .agents/rules/project-workflows.md로 이동합니다.
• AGENTS.md에 중복된 아키텍처 및 작업 규칙을 제거하고 라우팅 표만 유지합니다.
• .codex/agents/*.toml의 AGENT_ROLES.md 참조를 .agents/roles.md로 변경합니다.
• .agents/roles.md와 .agents/workflows.md의 상호 참조 경로를 변경합니다.
• README.md와 저장소 내 Markdown의 기존 경로 참조를 변경합니다.
• 참조 이전이 끝난 뒤 .hermes 전체를 제거합니다.

수용 기준

• .hermes 디렉터리가 저장소에 존재하지 않습니다.
• 저장소 파일에서 .hermes와 devlog-architecture-harness 참조가 발견되지 않습니다.
• 저장소 최상위 AI 작업 문서는 AGENTS.md만 유지됩니다.
• AGENTS.md가 세부 규칙을 중복하지 않고 작업 종류별 문서만 라우팅합니다.
• 기존 AGENT_ROLES.md의 역할, 권한, 모델 선택 및 결과 형식이 .agents/roles.md에 보존됩니다.
• 기존 AGENT_WORKFLOWS.md의 역할 실행 순서와 중단 조건이 .agents/workflows.md에 보존됩니다.
• 기존 Hermes architecture harness의 프로젝트별 아키텍처 규칙이 .agents/rules/architecture.md에 보존됩니다.
• 기존 프로젝트 작업 규칙이 .agents/rules/project-workflows.md에 보존됩니다.
• .codex/agents/*.toml이 변경된 역할 문서 경로를 참조합니다.
• 모든 Markdown 참조 경로가 실제 파일과 일치합니다.
• rg -n "\\.hermes|devlog-architecture-harness|AGENT_ROLES\\.md|AGENT_WORKFLOWS\\.md" . 결과에 이전 경로가 남지 않습니다.
• 변경 파일의 git diff --check가 통과합니다.
• Swift 및 iOS 프로젝트 파일이 변경되지 않습니다.
• 앱 또는 Simulator를 실행하지 않습니다.