Skip to content

Setting/#7 - code rabbit yaml 파일 수정 및 docs 파일 추가 (코드, 디자인 컨벤션)#8

Open
dlguszoo wants to merge 2 commits into
developfrom
setting/#7/setting_code_rabbit
Open

Setting/#7 - code rabbit yaml 파일 수정 및 docs 파일 추가 (코드, 디자인 컨벤션)#8
dlguszoo wants to merge 2 commits into
developfrom
setting/#7/setting_code_rabbit

Conversation

@dlguszoo
Copy link
Copy Markdown
Contributor

@dlguszoo dlguszoo commented May 11, 2026

✨ What’s this PR?

📌 관련 이슈 (Related Issue)


🧶 주요 변경 내용 (Summary)

  • code rabbit yaml 파일 수정: tone_instructions, path_instructions
  • CODING_GUIDELINES, DESIGN_SYSTEM_GUIDELINES 마크다운 파일 추가 (docs 폴더 내)

📸 스크린샷 (Optional)


🧪 테스트 / 검증 내역


💬 기타 공유 사항

  • DESIGN_SYSTEM_GUIDELINES 파일은 디자인 시스템 등록 후 채워주시면 됩니다.

🙇🏻‍♀️ 리뷰 가이드 (선택)

Summary by CodeRabbit

  • Documentation

    • Added comprehensive Swift and macOS coding guidelines covering core principles, naming conventions, access control, SwiftUI patterns, and file organization standards.
    • Added design system guidelines documentation placeholder for future content.
  • Chores

    • Updated code review configuration with enhanced review standards and coding guidelines integration.

Review Change Stack

@dlguszoo dlguszoo requested review from doyeonk429 and yeseonglee May 11, 2026 11:00
@dlguszoo dlguszoo self-assigned this May 11, 2026
@dlguszoo dlguszoo added the ⚙ Setting 개발 환경 설정 label May 11, 2026
@dlguszoo dlguszoo linked an issue May 11, 2026 that may be closed by this pull request
3 tasks
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented May 11, 2026

Warning

Ignoring CodeRabbit configuration file changes. For security, only the configuration from the base branch is applied for open source repositories.

Warning

.coderabbit.yaml has a parsing error

The CodeRabbit configuration file in this repository has a parsing error and default settings were used instead. Please fix the error(s) in the configuration file. You can initialize chat with CodeRabbit to get help with the configuration file.

💥 Parsing errors (1)
Validation error: String must contain at most 250 character(s) at "tone_instructions"
⚙️ Configuration instructions
  • Please see the configuration documentation for more information.
  • You can also validate your configuration using the online YAML validator.
  • If your editor has YAML language server enabled, you can add the path at the top of this file to enable auto-completion and validation: # yaml-language-server: $schema=https://coderabbit.ai/integrations/schema.v2.json
📝 Walkthrough

Walkthrough

This PR establishes a code review framework by updating CodeRabbit configuration, adding comprehensive Swift/macOS coding guidelines documentation, and creating a design system guidelines placeholder. Review tone instructions are simplified to focus on improvement causation, and Swift file review checklist is restructured around core practices rather than style minutiae.

Changes

Code Review Framework Setup

Layer / File(s) Summary
Review Tone and Approach
.coderabbit.yaml
Review tone instructions updated to concise, improvement-focused Korean guideline emphasizing problem causation, actionable improvements, and brief recognition of good practices.
Coding Guidelines Documentation
docs/CODING_GUIDELINES.md
Comprehensive Swift/macOS guidelines document added covering core principles (final, weak self, optional handling), naming conventions, access control, SwiftUI view structure and subview organization, component extraction, common patterns, and file organization with import ordering.
Swift File Review Checklist
.coderabbit.yaml
Path-specific review instructions for Swift files restructured from Airbnb style rules into sectional checklist format covering safety, access control, class design, SwiftUI structure, naming, patterns, and file composition. Xcode project exclusion and target/scheme change detection preserved.
Code Guidelines Integration
.coderabbit.yaml
CodeRabbit configuration activated to reference docs/CODING_GUIDELINES.md as the review reflection document, with design system guidelines marked as TODO.
Design System Placeholder
docs/DESIGN_SYSTEM_GUIDELINES.md
Placeholder file created indicating design system guidelines will be written after system introduction.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Poem

🐰 A framework emerges, clear as spring air,
Guidelines written with methodical care,
Swift code will dance to these rules we define,
Reviews now guided by structure so fine,
The rabbit hops forward, one step at a time! ✨

🚥 Pre-merge checks | ✅ 5
✅ Passed checks (5 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly identifies the main changes: updating CodeRabbit YAML configuration and adding documentation files for coding and design conventions, directly matching the changeset.
Linked Issues check ✅ Passed All three coding requirements from issue #7 are met: YAML file modified with path_instructions and tone_instructions updates, CODING_GUIDELINES.md created with comprehensive guidelines, and DESIGN_SYSTEM_GUIDELINES.md created as placeholder.
Out of Scope Changes check ✅ Passed All changes directly address the linked issue requirements; no out-of-scope modifications or unrelated code changes are present in this configuration and documentation update.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch setting/#7/setting_code_rabbit

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

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

Copy link
Copy Markdown

@coderabbitai coderabbitai Bot left a comment

Choose a reason for hiding this comment

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

Actionable comments posted: 2

🧹 Nitpick comments (1)
.coderabbit.yaml (1)

69-69: ⚡ Quick win

메서드 순서 규칙을 가이드 문서와 일치시키는 것이 좋습니다.

public → private로 축약되어 있어, 문서 기준(public → internal → private)과 불일치합니다. 리뷰 기준 혼선을 줄이려면 동일하게 맞추는 편이 좋습니다.

As per coding guidelines, 메서드 순서는 public → internal → private입니다.

🤖 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 @.coderabbit.yaml at line 69, Update the method-order rule text that
currently abbreviates methods as "public → private" to the full sequence "public
→ internal → private" so it matches the coding guidelines; locate the string
value in .coderabbit.yaml that contains "프로퍼티 → init → body → 메서드(public →
private)" and change the parenthetical to "(public → internal → private)".
🤖 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 @.coderabbit.yaml:
- Line 10: The YAML key tone_instructions exceeds the 250-character schema limit
causing validation errors; edit the value of tone_instructions to a shorter
string within 250 characters (or move longer guidance to a separate file or
reference), then re-validate the config; locate the tone_instructions entry in
.coderabbit.yaml and truncate or revise the instruction text to meet the schema
constraint.

In `@docs/CODING_GUIDELINES.md`:
- Around line 290-295: The fenced code block containing the Swift coding order
list is missing a language tag which triggers markdownlint MD040; update that
fenced block (the triple-backtick block with the four-line list: "1. 프로퍼티... 4.
메서드...") to include a language identifier such as text (e.g., change ``` to
```text) so the block is properly annotated and the MD040 warning is resolved.

---

Nitpick comments:
In @.coderabbit.yaml:
- Line 69: Update the method-order rule text that currently abbreviates methods
as "public → private" to the full sequence "public → internal → private" so it
matches the coding guidelines; locate the string value in .coderabbit.yaml that
contains "프로퍼티 → init → body → 메서드(public → private)" and change the
parenthetical to "(public → internal → private)".
🪄 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: defaults

Review profile: CHILL

Plan: Pro Plus

Run ID: 7c428456-0820-48d8-af1f-d1c13feda210

📥 Commits

Reviewing files that changed from the base of the PR and between d9d8484 and ebec09b.

📒 Files selected for processing (3)
  • .coderabbit.yaml
  • docs/CODING_GUIDELINES.md
  • docs/DESIGN_SYSTEM_GUIDELINES.md

Comment thread .coderabbit.yaml
3. 비판보다는 개선 중심의 제안을 우선하세요. "이렇게 하면 안 돼요" 대신 "이렇게 하면 더 좋아요"로 표현하세요.
4. 잘된 부분은 짧고 위트 있게 칭찬하세요.
5. 스타일 지적은 SwiftLint/SwiftFormat으로 자동화할 수 있는 것인지 구분하고, 자동화 가능한 경우 툴 도입을 제안하세요.
tone_instructions: "경험 많은 Apple 플랫폼 개발자로서 리뷰하세요. 문제의 원인과 개선 방법을 함께 제시하고, 비판보다 개선 중심으로 피드백하세요. 잘된 부분은 짧게 칭찬하세요."
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🔴 Critical | ⚡ Quick win

tone_instructions 길이 제한(250자) 초과로 설정 파싱이 실패합니다.

현재 값은 스키마 제한을 넘어서 Validation error가 발생하므로, 설정이 정상 적용되지 않을 수 있습니다.

🔧 Proposed fix
-tone_instructions: "경험 많은 Apple 플랫폼 개발자로서 리뷰하세요. 문제의 원인과 개선 방법을 함께 제시하고, 비판보다 개선 중심으로 피드백하세요. 잘된 부분은 짧게 칭찬하세요."
+tone_instructions: "Apple 플랫폼 시니어 개발자 관점으로, 원인과 개선안을 짧고 명확히 제시하며 개선 중심으로 리뷰하세요."
📝 Committable suggestion

‼️ IMPORTANT
Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

Suggested change
tone_instructions: "경험 많은 Apple 플랫폼 개발자로서 리뷰하세요. 문제의 원인과 개선 방법을 함께 제시하고, 비판보다 개선 중심으로 피드백하세요. 잘된 부분은 짧게 칭찬하세요."
tone_instructions: "Apple 플랫폼 시니어 개발자 관점으로, 원인과 개선안을 짧고 명확히 제시하며 개선 중심으로 리뷰하세요."
🤖 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 @.coderabbit.yaml at line 10, The YAML key tone_instructions exceeds the
250-character schema limit causing validation errors; edit the value of
tone_instructions to a shorter string within 250 characters (or move longer
guidance to a separate file or reference), then re-validate the config; locate
the tone_instructions entry in .coderabbit.yaml and truncate or revise the
instruction text to meet the schema constraint.

Comment thread docs/CODING_GUIDELINES.md
Comment on lines +290 to +295
```
1. 프로퍼티 (stored → computed 순)
2. init
3. body (SwiftUI View의 경우)
4. 메서드 (public → internal → private 순)
```
Copy link
Copy Markdown

Choose a reason for hiding this comment

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

⚠️ Potential issue | 🟡 Minor | ⚡ Quick win

코드 블록 언어 태그를 추가해 markdownlint 경고를 제거하세요.

Line 290의 fenced code block에 language가 없어 MD040 경고가 발생합니다.

🔧 Proposed fix
-```
+```text
 1. 프로퍼티 (stored → computed 순)
 2. init
 3. body (SwiftUI View의 경우)
 4. 메서드 (public → internal → private 순)
</details>

<!-- suggestion_start -->

<details>
<summary>📝 Committable suggestion</summary>

> ‼️ **IMPORTANT**
> Carefully review the code before committing. Ensure that it accurately replaces the highlighted code, contains no missing lines, and has no issues with indentation. Thoroughly test & benchmark the code to ensure it meets the requirements.

```suggestion

🧰 Tools
🪛 markdownlint-cli2 (0.22.1)

[warning] 290-290: 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/CODING_GUIDELINES.md` around lines 290 - 295, The fenced code block
containing the Swift coding order list is missing a language tag which triggers
markdownlint MD040; update that fenced block (the triple-backtick block with the
four-line list: "1. 프로퍼티... 4. 메서드...") to include a language identifier such as
text (e.g., change ``` to ```text) so the block is properly annotated and the
MD040 warning is resolved.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

⚙ Setting 개발 환경 설정

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Setting: code rabbit yaml 파일 세팅

1 participant