Skip to content

문서 역할 재배치와 주석·테스트 규칙 보강 - #11

Merged
gnoes-ios merged 3 commits into
devfrom
docs/rules-structure
Aug 4, 2026
Merged

문서 역할 재배치와 주석·테스트 규칙 보강#11
gnoes-ios merged 3 commits into
devfrom
docs/rules-structure

Conversation

@gnoes-ios

Copy link
Copy Markdown
Contributor

📌 변경 요약

  • 문서 SSOT 역할 분리 및 진입점 축소
  • 주석·테스트 네이밍 규칙 문서화
  • 기존 테스트/주석을 규칙에 맞게 정렬

📌 변경 내용

Docs

  • ARCHITECTURE 전역 지도 축약 및 모듈 README 링크 추가
  • CONVENTIONS에 주석/테스트 네이밍/형식 규칙 정리
  • AGENT_WORKFLOW에 hard gate와 Agent Behavior 정리
  • skills 인덱스 유지 및 중복 규칙 축소
  • AGENTS/CLAUDE 진입점 요약으로 축소

Module README

  • Feature/Domain/Data/CoreNetwork README 시드 추가

Tests

  • 기존 테스트 메서드명 test_<상황>_<기대결과> 한국어 통일

Style

  • 소스 주석 최소화 및 ///////TODO 역할 정렬

@gnoes-ios gnoes-ios added the docs 문서 label Aug 4, 2026
@gnoes-ios gnoes-ios self-assigned this Aug 4, 2026
@coderabbitai

coderabbitai Bot commented Aug 4, 2026

Copy link
Copy Markdown

Review Change Stack

ℹ️ Recent review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 5d82afe6-c0c4-44f4-8bd8-a9950486608f

📥 Commits

Reviewing files that changed from the base of the PR and between 52ca0f7 and 3b85d28.

📒 Files selected for processing (41)
  • AGENTS.md
  • CLAUDE.md
  • CLAUDE.md
  • Projects/App/Sources/DI/Dependencies.swift
  • Projects/Core/Network/README.md
  • Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift
  • Projects/Core/Network/Tests/NetworkErrorMappingTests.swift
  • Projects/Core/Network/Tests/NetworkLogTests.swift
  • Projects/Core/Network/Tests/URLRequestBuildingTests.swift
  • Projects/Data/README.md
  • Projects/Domain/README.md
  • Projects/Feature/README.md
  • Projects/Feature/Sources/AppCoordinator/AppCoordinatorFeature.swift
  • Projects/Feature/Tests/AppCoordinator/AppCoordinatorFeatureTests.swift
  • Projects/Feature/Tests/AppCoordinator/DeepLinkRouterTests.swift
  • Projects/Shared/DesignSystem/Sources/Components/Button/DesignButton.swift
  • Projects/Shared/DesignSystem/Sources/Components/Button/DesignButtonStyle.swift
  • Projects/Shared/DesignSystem/Sources/Components/Social/SocialLoginButton.swift
  • Projects/Shared/DesignSystem/Sources/Foundation/FontRegistration.swift
  • Projects/Shared/DesignSystem/Sources/Preview/DesignSystemGallery.swift
  • Projects/Shared/DesignSystem/Sources/Tokens/Semantic/SemanticColor.swift
  • Projects/Shared/DesignSystem/Tests/Components/DesignButtonMetricsTests.swift
  • Projects/Shared/DesignSystem/Tests/Components/SocialLoginProviderTests.swift
  • Projects/Shared/DesignSystem/Tests/Foundation/FontRegistrationTests.swift
  • Projects/Shared/DesignSystem/Tests/Smoke/SharedDesignSystemSmokeTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/PrimitiveColorTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/SemanticColorTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/SemanticNumberTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/TypographyTests.swift
  • Projects/Shared/Util/Tests/Bundle/AppInfoTests.swift
  • Projects/Shared/Util/Tests/Concurrency/LockedTests.swift
  • Projects/Shared/Util/Tests/Foundation/ArraySharedUtilsTests.swift
  • Projects/Shared/Util/Tests/Foundation/CollectionSharedUtilsTests.swift
  • Projects/Shared/Util/Tests/Foundation/StringSharedUtilsTests.swift
  • Projects/Shared/Util/Tests/Smoke/SharedUtilsSmokeTests.swift
  • Projects/ThirdParty/ThirdPartyCore/Sources/Exports.swift
  • docs/AGENT_WORKFLOW.md
  • docs/ARCHITECTURE.md
  • docs/CONVENTIONS.md
  • docs/skills.md

📝 Walkthrough

Summary by CodeRabbit

  • 문서
    • 프로젝트 구조, 모듈별 책임, 의존성 규칙과 네트워크 동작 기준을 정리했습니다.
    • 에이전트 작업 흐름, 개발 규칙, Git·PR 작성 가이드를 통합하고 관련 문서 연결을 보강했습니다.
  • 개선
    • 주요 코드와 테스트의 주석 및 테스트 이름을 한국어 설명형으로 정비했습니다.
  • 변경 없음
    • 앱 기능, 화면 동작, 네트워크 처리 및 테스트 검증 로직에는 변경이 없습니다.

Walkthrough

이 PR은 에이전트 가이드 문서(AGENTS.md, CLAUDE.md, docs/*)를 재구성하고 각 모듈에 README를 추가한다. 또한 여러 Swift 소스 파일의 주석과 다수 테스트 파일의 메서드명을 영어에서 한국어로 변경한다. 테스트 로직과 실행 동작은 변경되지 않는다.

Changes

에이전트 문서 및 모듈 README 재구성

Layer / File(s) Summary
CLAUDE.md 신규 진입 문서 작성
CLAUDE.md
worktree 준비 상태 검증, 프로젝트 구조, 문서 우선순위, 의존성 금지 규칙, 앱 부트스트랩 흐름, 커밋·PR hard gate, 명령어를 정의하는 새 문서를 추가했다.
AGENTS.md 문서 우선순위 및 규칙 요약 갱신
AGENTS.md
문서 우선순위에 Projects/**/README.md를 추가하고, 구조 섹션 제목을 변경했다. 상세 규칙, 브랜치·커밋·PR 형식을 요약 형태로 재구성했다.
AGENT_WORKFLOW.md 및 CONVENTIONS.md 규칙 갱신
docs/AGENT_WORKFLOW.md, docs/CONVENTIONS.md, docs/skills.md
worktree ready 조건, 커밋 전 린트 실행, PR rebase 및 cleanup 규칙, 주석·테스트명·Git·PR 본문 작성 규칙을 추가·정리했다.
ARCHITECTURE.md 갱신 및 모듈별 README 추가
docs/ARCHITECTURE.md, Projects/Core/Network/README.md, Projects/Data/README.md, Projects/Domain/README.md, Projects/Feature/README.md
섹션 번호와 제목을 변경하고 모듈 README 링크를 추가했다. Core/Network, Data, Domain, Feature 각각의 책임, 의존성 규칙, 진입점, 테스트 포인트를 문서화했다.
Dependencies.swift TODO 주석 갱신
Projects/App/Sources/DI/Dependencies.swift
register 내부 주석을 Domain Client factory 등록 TODO로 변경했다.

주석 및 테스트 메서드명 한국어화

Layer / File(s) Summary
CoreNetwork 테스트명 및 주석 한국어화
Projects/Core/Network/Tests/*
테스트 메서드명과 주석을 영어에서 한국어로 변경했다. 테스트 검증 로직은 유지되었다.
Feature 소스 주석 및 테스트명 한국어화
Projects/Feature/Sources/AppCoordinator/AppCoordinatorFeature.swift, Projects/Feature/Tests/AppCoordinator/*
딥링크 처리 주석과 테스트 메서드명을 한국어로 변경했다. 동작과 검증 로직은 변경되지 않았다.
DesignSystem 소스 주석 한국어화
Projects/Shared/DesignSystem/Sources/Components/*, Projects/Shared/DesignSystem/Sources/Foundation/FontRegistration.swift, Projects/Shared/DesignSystem/Sources/Preview/DesignSystemGallery.swift, Projects/Shared/DesignSystem/Sources/Tokens/Semantic/SemanticColor.swift
버튼, 소셜 로그인, 폰트 등록, Preview, 색상 토큰 관련 주석을 한국어로 변경했다. 실행 로직은 변경되지 않았다.
DesignSystem 테스트명 한국어화
Projects/Shared/DesignSystem/Tests/*
버튼, 소셜, 폰트, Smoke, 색상, 숫자, 타이포그래피 테스트의 메서드명을 한국어로 변경했다. 검증값은 동일하다.
SharedUtil 테스트명 한국어화
Projects/Shared/Util/Tests/*
Bundle, Concurrency, Foundation, Smoke 테스트 파일의 메서드명을 한국어로 변경했다. 테스트 로직은 유지되었다.
ThirdParty Exports 주석 한국어화
Projects/ThirdParty/ThirdPartyCore/Sources/Exports.swift
re-export 진입점 설명 주석을 한국어로 변경했다.

Estimated code review effort: 2 (Simple) | ~15 minutes

Possibly related PRs

  • TeamMozi/mozi-iOS#1: 두 PR 모두 동일한 문서(AGENTS.md, CLAUDE.md, docs/ARCHITECTURE.md, docs/CONVENTIONS.md)를 수정한다. 이 PR은 해당 문서의 내용을 다듬는다.
  • TeamMozi/mozi-iOS#8: 이 PR은 PR #8에서 도입한 워크플로, 컨벤션, 스킬, hard gate 문서를 직접 수정하고 worktree/커밋/PR 규칙을 재배치한다.
  • TeamMozi/mozi-iOS#10: 이 PR은 PR #10에서 도입한 SharedDesignSystem 컴포넌트와 테스트의 주석 및 테스트명을 갱신한다.
🚥 Pre-merge checks | ✅ 4
✅ Passed checks (4 passed)
Check name Status Explanation
Title check ✅ Passed PR 제목은 변경 사항의 주요 내용인 문서 역할 재배치와 주석·테스트 규칙 보강을 명확히 요약합니다.
Description check ✅ Passed PR 설명은 요구되는 템플릿 구조를 따르며 변경 요약, 변경 내용(Docs, Module README, Tests, Style), 기타 참고 사항을 포함합니다.
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.

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

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 5

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CLAUDE.md`:
- Line 1: CLAUDE.md의 첫 제목을 파일 역할에 맞게 변경하세요. 현재 # AGENTS를 # CLAUDE 또는 # Mozi
Agent Entry 중 하나로 교체해 별도 진입 문서임을 명확히 하세요.

In `@docs/AGENT_WORKFLOW.md`:
- Line 72: Update the four Markdown code fences in the workflow documentation at
the referenced sections to use the text language tag on each opening fence,
resolving MD040 while preserving the existing plain-text flowchart contents.

In `@docs/CONVENTIONS.md`:
- Line 6: docs/CONVENTIONS.md의 문서 섹션 제목을 한국어로 변경하세요. `Coding`, `Comments`,
`Tests`, `Schemes`, `Git Format`, `Language` 제목만 각각 `코딩`, `주석`, `테스트`, `스킴`,
`Git 형식`, `언어`로 바꾸고, API 이름·옵션명·식별자 및 기타 내용은 그대로 유지하세요.

In `@Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift`:
- Line 10: 테스트 이름과 주석의 영어 설명어를 한국어로 변경하고 HTTP, URL, Bearer, 상태 코드는 유지하세요.
Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift 10-10의
authorization을 권한으로, 39-39의 refresh와 재refresh를 토큰_갱신으로, 63-63 주석의 generation을
세대로 변경하세요. Projects/Core/Network/Tests/DefaultNetworkClientTests.swift 41-41의
void를 반환값_없는 표현으로, 53-53의 decodingFailed를 디코딩_실패로, 99-99의 refresh를 토큰_갱신으로,
138-138의 refresh_single_flight를 토큰_갱신_단일_실행으로, 169-169의 single-flight refresh를
단일 갱신으로, 188-188의 refresh와 unauthorized를 한국어 상황 및 기대 결과로, 219-219의 unauthorized를
인증_실패로 변경하세요. Projects/Core/Network/Tests/NetworkLogTests.swift 5-5의 query와
fragment를 쿼리와 프래그먼트로, Projects/Core/Network/Tests/URLRequestBuildingTests.swift
26-26의 accessToken과 refresh를 액세스_토큰과 갱신으로 변경하고, 모든 테스트 이름은 test_<상황>_<기대결과> 형식을
유지하세요.

In `@Projects/Shared/Util/Tests/Concurrency/LockedTests.swift`:
- Line 5: 테스트 이름이 동작뿐 아니라 상황과 기대 결과를 함께 나타내도록 수정하세요. LockedTests.swift의
test_withLock에서_상태_변경은 상태 변경 결과를, ArraySharedUtilsTests.swift의 두 테스트는 각각 첫 요소
유지와 순서 유지 결과를, CollectionSharedUtilsTests.swift의 테스트는 기대 청크 배열과의 일치를,
StringSharedUtilsTests.swift의 두 테스트는 각각 isBlank == true와 검색 결과 일치를 이름에 명시하세요.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 5d82afe6-c0c4-44f4-8bd8-a9950486608f

📥 Commits

Reviewing files that changed from the base of the PR and between 52ca0f7 and 3b85d28.

📒 Files selected for processing (41)
  • AGENTS.md
  • CLAUDE.md
  • CLAUDE.md
  • Projects/App/Sources/DI/Dependencies.swift
  • Projects/Core/Network/README.md
  • Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift
  • Projects/Core/Network/Tests/NetworkErrorMappingTests.swift
  • Projects/Core/Network/Tests/NetworkLogTests.swift
  • Projects/Core/Network/Tests/URLRequestBuildingTests.swift
  • Projects/Data/README.md
  • Projects/Domain/README.md
  • Projects/Feature/README.md
  • Projects/Feature/Sources/AppCoordinator/AppCoordinatorFeature.swift
  • Projects/Feature/Tests/AppCoordinator/AppCoordinatorFeatureTests.swift
  • Projects/Feature/Tests/AppCoordinator/DeepLinkRouterTests.swift
  • Projects/Shared/DesignSystem/Sources/Components/Button/DesignButton.swift
  • Projects/Shared/DesignSystem/Sources/Components/Button/DesignButtonStyle.swift
  • Projects/Shared/DesignSystem/Sources/Components/Social/SocialLoginButton.swift
  • Projects/Shared/DesignSystem/Sources/Foundation/FontRegistration.swift
  • Projects/Shared/DesignSystem/Sources/Preview/DesignSystemGallery.swift
  • Projects/Shared/DesignSystem/Sources/Tokens/Semantic/SemanticColor.swift
  • Projects/Shared/DesignSystem/Tests/Components/DesignButtonMetricsTests.swift
  • Projects/Shared/DesignSystem/Tests/Components/SocialLoginProviderTests.swift
  • Projects/Shared/DesignSystem/Tests/Foundation/FontRegistrationTests.swift
  • Projects/Shared/DesignSystem/Tests/Smoke/SharedDesignSystemSmokeTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/PrimitiveColorTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/SemanticColorTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/SemanticNumberTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/TypographyTests.swift
  • Projects/Shared/Util/Tests/Bundle/AppInfoTests.swift
  • Projects/Shared/Util/Tests/Concurrency/LockedTests.swift
  • Projects/Shared/Util/Tests/Foundation/ArraySharedUtilsTests.swift
  • Projects/Shared/Util/Tests/Foundation/CollectionSharedUtilsTests.swift
  • Projects/Shared/Util/Tests/Foundation/StringSharedUtilsTests.swift
  • Projects/Shared/Util/Tests/Smoke/SharedUtilsSmokeTests.swift
  • Projects/ThirdParty/ThirdPartyCore/Sources/Exports.swift
  • docs/AGENT_WORKFLOW.md
  • docs/ARCHITECTURE.md
  • docs/CONVENTIONS.md
  • docs/skills.md

@coderabbitai coderabbitai Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Inline review comments failed to post. This is likely due to GitHub's internal server error or limits when posting large numbers of comments. If you are seeing this consistently it is likely a permissions issue. Please check "Moderation" -> "Code review limits" under your organization settings.

Actionable comments posted: 5

🤖 Prompt for all review comments with AI agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

Inline comments:
In `@CLAUDE.md`:
- Line 1: CLAUDE.md의 첫 제목을 파일 역할에 맞게 변경하세요. 현재 # AGENTS를 # CLAUDE 또는 # Mozi
Agent Entry 중 하나로 교체해 별도 진입 문서임을 명확히 하세요.

In `@docs/AGENT_WORKFLOW.md`:
- Line 72: Update the four Markdown code fences in the workflow documentation at
the referenced sections to use the text language tag on each opening fence,
resolving MD040 while preserving the existing plain-text flowchart contents.

In `@docs/CONVENTIONS.md`:
- Line 6: docs/CONVENTIONS.md의 문서 섹션 제목을 한국어로 변경하세요. `Coding`, `Comments`,
`Tests`, `Schemes`, `Git Format`, `Language` 제목만 각각 `코딩`, `주석`, `테스트`, `스킴`,
`Git 형식`, `언어`로 바꾸고, API 이름·옵션명·식별자 및 기타 내용은 그대로 유지하세요.

In `@Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift`:
- Line 10: 테스트 이름과 주석의 영어 설명어를 한국어로 변경하고 HTTP, URL, Bearer, 상태 코드는 유지하세요.
Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift 10-10의
authorization을 권한으로, 39-39의 refresh와 재refresh를 토큰_갱신으로, 63-63 주석의 generation을
세대로 변경하세요. Projects/Core/Network/Tests/DefaultNetworkClientTests.swift 41-41의
void를 반환값_없는 표현으로, 53-53의 decodingFailed를 디코딩_실패로, 99-99의 refresh를 토큰_갱신으로,
138-138의 refresh_single_flight를 토큰_갱신_단일_실행으로, 169-169의 single-flight refresh를
단일 갱신으로, 188-188의 refresh와 unauthorized를 한국어 상황 및 기대 결과로, 219-219의 unauthorized를
인증_실패로 변경하세요. Projects/Core/Network/Tests/NetworkLogTests.swift 5-5의 query와
fragment를 쿼리와 프래그먼트로, Projects/Core/Network/Tests/URLRequestBuildingTests.swift
26-26의 accessToken과 refresh를 액세스_토큰과 갱신으로 변경하고, 모든 테스트 이름은 test_<상황>_<기대결과> 형식을
유지하세요.

In `@Projects/Shared/Util/Tests/Concurrency/LockedTests.swift`:
- Line 5: 테스트 이름이 동작뿐 아니라 상황과 기대 결과를 함께 나타내도록 수정하세요. LockedTests.swift의
test_withLock에서_상태_변경은 상태 변경 결과를, ArraySharedUtilsTests.swift의 두 테스트는 각각 첫 요소
유지와 순서 유지 결과를, CollectionSharedUtilsTests.swift의 테스트는 기대 청크 배열과의 일치를,
StringSharedUtilsTests.swift의 두 테스트는 각각 isBlank == true와 검색 결과 일치를 이름에 명시하세요.
🪄 Autofix (Beta)

Fix all unresolved CodeRabbit comments on this PR:

  • Push a commit to this branch (recommended)
  • Create a new PR with the fixes

ℹ️ Review info
⚙️ Run configuration

Configuration used: Path: .coderabbit.yaml

Review profile: CHILL

Plan: Pro Plus

Run ID: 5d82afe6-c0c4-44f4-8bd8-a9950486608f

📥 Commits

Reviewing files that changed from the base of the PR and between 52ca0f7 and 3b85d28.

📒 Files selected for processing (41)
  • AGENTS.md
  • CLAUDE.md
  • CLAUDE.md
  • Projects/App/Sources/DI/Dependencies.swift
  • Projects/Core/Network/README.md
  • Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift
  • Projects/Core/Network/Tests/NetworkErrorMappingTests.swift
  • Projects/Core/Network/Tests/NetworkLogTests.swift
  • Projects/Core/Network/Tests/URLRequestBuildingTests.swift
  • Projects/Data/README.md
  • Projects/Domain/README.md
  • Projects/Feature/README.md
  • Projects/Feature/Sources/AppCoordinator/AppCoordinatorFeature.swift
  • Projects/Feature/Tests/AppCoordinator/AppCoordinatorFeatureTests.swift
  • Projects/Feature/Tests/AppCoordinator/DeepLinkRouterTests.swift
  • Projects/Shared/DesignSystem/Sources/Components/Button/DesignButton.swift
  • Projects/Shared/DesignSystem/Sources/Components/Button/DesignButtonStyle.swift
  • Projects/Shared/DesignSystem/Sources/Components/Social/SocialLoginButton.swift
  • Projects/Shared/DesignSystem/Sources/Foundation/FontRegistration.swift
  • Projects/Shared/DesignSystem/Sources/Preview/DesignSystemGallery.swift
  • Projects/Shared/DesignSystem/Sources/Tokens/Semantic/SemanticColor.swift
  • Projects/Shared/DesignSystem/Tests/Components/DesignButtonMetricsTests.swift
  • Projects/Shared/DesignSystem/Tests/Components/SocialLoginProviderTests.swift
  • Projects/Shared/DesignSystem/Tests/Foundation/FontRegistrationTests.swift
  • Projects/Shared/DesignSystem/Tests/Smoke/SharedDesignSystemSmokeTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/PrimitiveColorTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/SemanticColorTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/SemanticNumberTests.swift
  • Projects/Shared/DesignSystem/Tests/Tokens/TypographyTests.swift
  • Projects/Shared/Util/Tests/Bundle/AppInfoTests.swift
  • Projects/Shared/Util/Tests/Concurrency/LockedTests.swift
  • Projects/Shared/Util/Tests/Foundation/ArraySharedUtilsTests.swift
  • Projects/Shared/Util/Tests/Foundation/CollectionSharedUtilsTests.swift
  • Projects/Shared/Util/Tests/Foundation/StringSharedUtilsTests.swift
  • Projects/Shared/Util/Tests/Smoke/SharedUtilsSmokeTests.swift
  • Projects/ThirdParty/ThirdPartyCore/Sources/Exports.swift
  • docs/AGENT_WORKFLOW.md
  • docs/ARCHITECTURE.md
  • docs/CONVENTIONS.md
  • docs/skills.md
🛑 Comments failed to post (5)
CLAUDE.md (1)

1-1: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

CLAUDE.md의 제목을 파일 역할과 일치시키세요.

Line 1은 새 진입 문서인 CLAUDE.md# AGENTS로 표시합니다. 문서 참조 시 두 진입점의 식별이 모호해집니다. # CLAUDE 또는 # Mozi Agent Entry로 변경하세요.

As per PR objectives, CLAUDE.md는 별도 진입 문서입니다.

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@CLAUDE.md` at line 1, CLAUDE.md의 첫 제목을 파일 역할에 맞게 변경하세요. 현재 # AGENTS를 # CLAUDE
또는 # Mozi Agent Entry 중 하나로 교체해 별도 진입 문서임을 명확히 하세요.
docs/AGENT_WORKFLOW.md (1)

72-72: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

Markdown 코드 블록에 언어 태그를 추가하세요.

정적 분석이 Lines 72, 84, 92, 103에서 MD040 경고를 보고합니다. 모두 일반 텍스트 흐름도이므로 각 시작 fence를 ````text`로 변경하세요.

수정 예시
-```
+```text

Also applies to: 84-84, 92-92, 103-103

🧰 Tools
🪛 markdownlint-cli2 (0.23.1)

[warning] 72-72: Fenced code blocks should have a language specified

(MD040, fenced-code-language)

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/AGENT_WORKFLOW.md` at line 72, Update the four Markdown code fences in
the workflow documentation at the referenced sections to use the text language
tag on each opening fence, resolving MD040 while preserving the existing
plain-text flowchart contents.

Source: Linters/SAST tools

docs/CONVENTIONS.md (1)

6-6: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

문서 섹션 제목을 한국어로 통일하세요.

Lines 6, 21, 49, 57, 64, 91은 Coding, Comments, Tests, Schemes, Git Format, Language를 사용합니다. 로컬 문서는 한국어를 기본으로 작성해야 합니다. API 이름, 옵션명, 식별자는 영어로 유지하되 설명용 제목은 코딩, 주석, 테스트, 스킴, Git 형식, 언어로 변경하세요.

As per coding guidelines, 로컬 문서와 에이전트 문서는 한국어를 기본으로 작성해야 합니다.
As per path instructions, docs 문서의 로컬 설명은 한국어를 사용해야 합니다.

Also applies to: 21-21, 49-49, 57-57, 64-64, 91-91

🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@docs/CONVENTIONS.md` at line 6, docs/CONVENTIONS.md의 문서 섹션 제목을 한국어로 변경하세요.
`Coding`, `Comments`, `Tests`, `Schemes`, `Git Format`, `Language` 제목만 각각 `코딩`,
`주석`, `테스트`, `스킴`, `Git 형식`, `언어`로 바꾸고, API 이름·옵션명·식별자 및 기타 내용은 그대로 유지하세요.

Sources: Coding guidelines, Path instructions

Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift (1)

10-10: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

테스트명과 주석의 한국어화를 완료하세요.

일부 설명어가 영어로 남아 있습니다. 표준 기술 표기인 HTTP, URL, Bearer, 상태 코드는 유지하고, 설명어는 한국어로 변경하세요.

  • Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift#L10-L10: authorization권한으로 변경하세요.
  • Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift#L39-L39: refresh, 재refresh토큰_갱신 표현으로 변경하세요.
  • Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift#L63-L63: 주석의 generation세대로 변경하세요.
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L41-L41: void반환값_없는과 같은 한국어 표현으로 변경하세요.
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L53-L53: decodingFailed디코딩_실패로 변경하세요.
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L99-L99: refresh토큰_갱신으로 변경하세요.
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L138-L138: refresh_single_flight토큰_갱신_단일_실행과 같은 표현으로 변경하세요.
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L169-L169: single-flight refresh단일 갱신으로 변경하세요.
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L188-L188: refresh, unauthorized를 한국어 상황과 기대 결과로 변경하세요.
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L219-L219: unauthorized인증_실패와 같은 한국어 표현으로 변경하세요.
  • Projects/Core/Network/Tests/NetworkLogTests.swift#L5-L5: query, fragment쿼리, 프래그먼트로 변경하세요.
  • Projects/Core/Network/Tests/URLRequestBuildingTests.swift#L26-L26: accessToken, refresh액세스_토큰, 갱신으로 변경하세요.

As per coding guidelines, 테스트 이름은 한국어 test_<상황>_<기대결과> 형식을 사용해야 합니다. As per path instructions, 소스 주석은 한국어를 기본으로 작성해야 합니다.

📍 Affects 4 files
  • Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift#L10-L10 (this comment)
  • Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift#L39-L39
  • Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift#L63-L63
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L41-L41
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L53-L53
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L99-L99
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L138-L138
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L169-L169
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L188-L188
  • Projects/Core/Network/Tests/DefaultNetworkClientTests.swift#L219-L219
  • Projects/Core/Network/Tests/NetworkLogTests.swift#L5-L5
  • Projects/Core/Network/Tests/URLRequestBuildingTests.swift#L26-L26
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift` at line
10, 테스트 이름과 주석의 영어 설명어를 한국어로 변경하고 HTTP, URL, Bearer, 상태 코드는 유지하세요.
Projects/Core/Network/Tests/DefaultNetworkClientReviewFixTests.swift 10-10의
authorization을 권한으로, 39-39의 refresh와 재refresh를 토큰_갱신으로, 63-63 주석의 generation을
세대로 변경하세요. Projects/Core/Network/Tests/DefaultNetworkClientTests.swift 41-41의
void를 반환값_없는 표현으로, 53-53의 decodingFailed를 디코딩_실패로, 99-99의 refresh를 토큰_갱신으로,
138-138의 refresh_single_flight를 토큰_갱신_단일_실행으로, 169-169의 single-flight refresh를
단일 갱신으로, 188-188의 refresh와 unauthorized를 한국어 상황 및 기대 결과로, 219-219의 unauthorized를
인증_실패로 변경하세요. Projects/Core/Network/Tests/NetworkLogTests.swift 5-5의 query와
fragment를 쿼리와 프래그먼트로, Projects/Core/Network/Tests/URLRequestBuildingTests.swift
26-26의 accessToken과 refresh를 액세스_토큰과 갱신으로 변경하고, 모든 테스트 이름은 test_<상황>_<기대결과> 형식을
유지하세요.

Sources: Coding guidelines, Path instructions

Projects/Shared/Util/Tests/Concurrency/LockedTests.swift (1)

5-5: 📐 Maintainability & Code Quality | 🟡 Minor | ⚡ Quick win

테스트 이름에 상황과 기대 결과를 모두 포함하세요.

다음 테스트 이름은 동작만 설명하거나 결과가 모호합니다.

  • Projects/Shared/Util/Tests/Concurrency/LockedTests.swift#L5-L5: 상태 변경 결과를 명시하세요.
  • Projects/Shared/Util/Tests/Foundation/ArraySharedUtilsTests.swift#L16-L16: 첫 요소 유지 결과를 명시하세요.
  • Projects/Shared/Util/Tests/Foundation/ArraySharedUtilsTests.swift#L28-L28: 순서 유지 결과를 명시하세요.
  • Projects/Shared/Util/Tests/Foundation/CollectionSharedUtilsTests.swift#L16-L16: 기대 청크 배열과의 일치를 명시하세요.
  • Projects/Shared/Util/Tests/Foundation/StringSharedUtilsTests.swift#L9-L9: isBlank == true 결과를 명시하세요.
  • Projects/Shared/Util/Tests/Foundation/StringSharedUtilsTests.swift#L24-L24: 검색 결과 일치를 명시하세요.
📍 Affects 4 files
  • Projects/Shared/Util/Tests/Concurrency/LockedTests.swift#L5-L5 (this comment)
  • Projects/Shared/Util/Tests/Foundation/ArraySharedUtilsTests.swift#L16-L16
  • Projects/Shared/Util/Tests/Foundation/ArraySharedUtilsTests.swift#L28-L28
  • Projects/Shared/Util/Tests/Foundation/CollectionSharedUtilsTests.swift#L16-L16
  • Projects/Shared/Util/Tests/Foundation/StringSharedUtilsTests.swift#L9-L9
  • Projects/Shared/Util/Tests/Foundation/StringSharedUtilsTests.swift#L24-L24
🤖 Prompt for AI Agents
Verify each finding against current code. Fix only still-valid issues, skip the
rest with a brief reason, keep changes minimal, and validate.

In `@Projects/Shared/Util/Tests/Concurrency/LockedTests.swift` at line 5, 테스트 이름이
동작뿐 아니라 상황과 기대 결과를 함께 나타내도록 수정하세요. LockedTests.swift의 test_withLock에서_상태_변경은 상태
변경 결과를, ArraySharedUtilsTests.swift의 두 테스트는 각각 첫 요소 유지와 순서 유지 결과를,
CollectionSharedUtilsTests.swift의 테스트는 기대 청크 배열과의 일치를,
StringSharedUtilsTests.swift의 두 테스트는 각각 isBlank == true와 검색 결과 일치를 이름에 명시하세요.

Sources: Coding guidelines, Path instructions

@gnoes-ios
gnoes-ios merged commit 47b2911 into dev Aug 4, 2026
3 checks passed
@gnoes-ios
gnoes-ios deleted the docs/rules-structure branch August 4, 2026 09:07
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs 문서

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant