Korean Code Comment Guide

Core Rule

코드를 작성하거나 수정할 때, 아래 기준에 해당하는 복잡한 부분에는 별도 요청이 없어도 반드시 한국어 주석을 추가한다. 이 스킬이 트리거된 이상, 주석 작성은 선택이 아닌 기본 행동이다. 사용자가 "주석 달아줘"라고 말하지 않아도, 코드를 건드리는 순간 이 가이드라인이 적용된다.

자명한 코드에는 주석을 달지 않는다. 주석은 "왜" 또는 "어떤 맥락에서"를 설명할 때 가치가 있다.

When to Write Comments

• Complex business logic or sections requiring domain knowledge
• Multi-step algorithms or data transformations
• Workarounds or edge case handling where intent is not obvious from code alone
• Non-intuitive usage of external APIs or libraries
• Unusual patterns used for performance optimization

Do NOT comment obvious code (variable assignments, simple conditionals, standard CRUD, etc.).

Comment Style Rules