에이전트 문서 구조 재편과 CI 빌드·중복 실행 정비

[gnoes-ios]

📌 변경 요약

• 에이전트 문서를 진입(AGENTS.md)·구조(ARCHITECTURE.md)·규칙(docs/CONVENTIONS.md)·모듈 README 네 곳으로 정리
• 저장소 안 실행 절차 문서와 Codex 스킬 삭제, 작업 문서는 로컬 문서 저장소를 가리키는 docs/agent 심링크로 이전
• CI 를 실제 시뮬레이터 빌드와 패키지 캐시로 전환하고 PR 중복 실행 취소 추가

📌 변경 내용

Docs

• AGENTS.md 를 「어디를 보나 / 절대 규칙 / 먼저 물을 것 / 자주 쓰는 명령」 네 구획으로 재작성
• CLAUDE.md 를 AGENTS.md 심링크로 교체
• docs/CONVENTIONS.md 를 코딩 / 커밋 / 브랜치와 PR / 관련 네 구획으로 재배치
• docs/CONVENTIONS.md 에서 SwiftLint 와 겹치는 규칙 2건, PR 템플릿 사본 1건 제거
• docs/AGENT_WORKFLOW.md, docs/skills.md 삭제

Skills

• .codex/skills/mozi-commit, mozi-feature-split, mozi-pr, mozi-worktree-cleanup 삭제

CI

• PR 중복 실행 취소(concurrency) 추가, main/dev push 실행은 유지
• 빌드·테스트 destination 을 generic/platform=iOS Simulator 에서 러너의 실제 iPhone 시뮬레이터로 변경
• Swift 패키지 캐시(.derivedData/SourcePackages) 추가
• -derivedDataPath .derivedData 적용

Config

• .gitignore 무시 경로를 docs/superpowers 에서 docs/agent 로 변경
• .swiftlint.yml 제외 목록에서 임시 빌드 경로 11개 삭제

📌 기타 참고 사항

• docs/agent 는 로컬 문서 저장소를 가리키는 심링크로, 저장소에는 올라가지 않음
• 로컬 빌드는 Xcode 기본 DerivedData 경로 사용, 저장소 안 .derivedData 는 CI 전용
• destination 변경으로 시뮬레이터용 아키텍처를 하나만 빌드 (로컬 무변경 재빌드 31초 → 7초, 2026-09-02 실측)

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Team

Run ID: ec1af107-17e0-4993-b838-f29de5a90bb9

📥 Commits

Reviewing files that changed from the base of the PR and between b7cbcf2 and a251f73.

📒 Files selected for processing (17)

• .codex/skills/mozi-commit/SKILL.md
• .codex/skills/mozi-commit/agents/openai.yaml
• .codex/skills/mozi-feature-split/SKILL.md
• .codex/skills/mozi-feature-split/agents/openai.yaml
• .codex/skills/mozi-pr/SKILL.md
• .codex/skills/mozi-pr/agents/openai.yaml
• .codex/skills/mozi-worktree-cleanup/SKILL.md
• .codex/skills/mozi-worktree-cleanup/agents/openai.yaml
• .github/workflows/ci.yml
• .gitignore
• .swiftlint.yml
• AGENTS.md
• CLAUDE.md
• CLAUDE.md
• docs/AGENT_WORKFLOW.md
• docs/CONVENTIONS.md
• docs/skills.md

💤 Files with no reviewable changes (11)

• .codex/skills/mozi-commit/agents/openai.yaml
• .codex/skills/mozi-feature-split/agents/openai.yaml
• .codex/skills/mozi-worktree-cleanup/agents/openai.yaml
• .codex/skills/mozi-pr/agents/openai.yaml
• .codex/skills/mozi-commit/SKILL.md
• .swiftlint.yml
• docs/skills.md
• .codex/skills/mozi-worktree-cleanup/SKILL.md
• .codex/skills/mozi-pr/SKILL.md
• docs/AGENT_WORKFLOW.md
• .codex/skills/mozi-feature-split/SKILL.md

Included review availability: Your plan provides up to 1 included review per hour; 0 remain after this review.

---

📝 Summary

Summary by CodeRabbit

• 개선 사항

  • CI가 실행 환경에서 사용 가능한 iPhone Simulator를 자동 선택합니다.
  • PR 작업의 중복 실행을 줄이고, 빌드·테스트 캐시를 활용합니다.
  • 프로젝트 안내 문서와 아키텍처·코딩·테스트 규칙 문서를 간결하게 재정비했습니다.
  • 문서 및 에이전트 관련 경로의 관리 기준을 업데이트했습니다.

• 변경 사항

  • 커밋, 기능 분할, PR, 워크트리 정리 관련 자동화 스킬과 안내 문서를 제거했습니다.
  • 일부 개발 환경 전용 SwiftLint 제외 경로를 삭제했습니다.

Walkthrough

CI가 동적 Simulator와 캐시된 derived data를 사용하도록 변경되었습니다. 에이전트 지침과 개발 규칙 문서가 재구성되었습니다. 기존 Mozi 스킬 정의와 관련 문서가 삭제되었습니다.

Changes

CI 실행 환경

Layer / File(s)	Summary
동적 CI 실행 파이프라인 .github/workflows/ci.yml	PR 실행의 동시성을 제어합니다. 사용 가능한 iPhone Simulator를 동적으로 선택합니다. Swift Package 캐시와 .derivedData를 사용해 빌드 및 Feature reducer 테스트를 실행합니다.

에이전트 운영 문서 및 스킬

Layer / File(s)	Summary
에이전트 지침 재구성 AGENTS.md	질문별 문서 참조표, 절대 규칙, 사전 확인 항목을 추가하고 기존 Git/PR 및 스킬 명령 요약을 제거했습니다.
개발 규칙 문서 개편 docs/CONVENTIONS.md	코딩, 테스트, Scheme, 언어, 금지 규칙, 커밋, 브랜치 및 PR 규칙을 재구성했습니다. 관련 문서 링크를 추가했습니다.
스킬 및 에이전트 경로 정리 .codex/skills/mozi-commit/*, .codex/skills/mozi-feature-split/*, .codex/skills/mozi-pr/*, .codex/skills/mozi-worktree-cleanup/*, docs/skills.md, .gitignore, .swiftlint.yml, CLAUDE.md, docs/AGENT_WORKFLOW.md	기존 Mozi 스킬 정의, 에이전트 메타데이터, 스킬 목록, 워크플로 문서 및 CLAUDE.md를 삭제했습니다. 에이전트 관련 무시 경로를 변경하고 SwiftLint 제외 경로를 정리했습니다.

Estimated code review effort: 3 (Moderate) | ~20 minutes

Merge Risk: ⚪ Minimal · up to a251f

문서 구조와 CI 실행 설정을 정비하는 변경이며, CLAUDE.md 심링크도 AGENTS.md를 정확히 가리킵니다. 구체적인 병합 차단 위험이 없어 일반 확인 후 병합 가능합니다.

Sequence Diagram(s)

sequenceDiagram
  participant GitHubActions
  participant simctl
  participant xcodebuild
  GitHubActions->>simctl: 사용 가능한 iPhone Simulator UUID 조회
  simctl-->>GitHubActions: Simulator destination 반환
  GitHubActions->>xcodebuild: 동적 destination과 .derivedData로 빌드
  GitHubActions->>xcodebuild: 동적 destination과 .derivedData로 Feature reducer 테스트

Loading

Suggested labels: chore

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	제목은 에이전트 문서 구조 재편과 CI 빌드·중복 실행 정비라는 주요 변경 사항을 간결하고 구체적으로 요약합니다.
Description check	✅ Passed	설명은 템플릿의 변경 요약, 변경 내용, 기타 참고 사항을 모두 포함합니다. 문서·스킬 삭제, CI 변경, 설정 정리와 관련된 세부 내용도 충분히 설명합니다.
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}