Communitygithub.com

chonamdoo/주석 작성 규율

구현 중 및 최종 리뷰, 다중 리뷰, 또는 아키텍처 리뷰 전에 주석 품질 기준을 적용합니다. Codex, Claude, OMP에서 Python, Kotlin, React Web, React Native, iOS, Swift, SwiftUI에 동일하게 적용됩니다.

주석 작성 규율란 무엇인가요?

이 스킬은 개발자와 AI 에이전트가 코드 변경 전후에 일관된 주석 품질 기준을 적용하도록 돕습니다. 구현 중에는 주석을 평가하고, 최종 리뷰 단계에서는 주석 품질 통과(pass)를 수행하여 가독성과 유지보수성을 높입니다. Codex, Claude, OMP 등 다양한 AI 코딩 에이전트에서 동작하며, Python, Kotlin, React Web, React Native, iOS, Swift, SwiftUI 등 여러 언어와 프레임워크를 지원합니다. 이 스킬은 SKILL.md에 정의된 체크리스트와 규칙을 통해 주석이 코드의 의도와 동작을 명확히 설명하는지 검증하며, 특히 제품 코드와 프로덕션 환경에서의 일관된 품질 유지에 유용합니다.

지원 대상✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/chonamdoo/agent-flow/tree/main/skills/comment-authoring-discipline

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

주석 작성 규율은(는) 무엇을 하나요?

구현 중 및 최종 리뷰, 다중 리뷰, 또는 아키텍처 리뷰 전에 주석 품질 기준을 적용합니다. Codex, Claude, OMP에서 Python, Kotlin, React Web, React Native, iOS, Swift, SwiftUI에 동일하게 적용됩니다.

Individual skills in this repo

This repo contains 5 individual skills — each has its own dedicated page.

chonamdoo/code-generation-discipline

Common code generation and code modification discipline for agent-flow. Use before and during implementation, TDD red/green/refactor, fix-loop, bug fixes, feature work, and any task where Codex, Claude, OMP, or another agent writes or changes code. Enforces start-before, during-implementation, and after-implementation checks without a scoring rubric.

chonamdoo/flutter-development-guide

Flutter implementation and review checklist. Use only when writing, modifying, or reviewing Flutter widget code, layout constraints, adaptive sizing, navigation and routing, platform channels, platform views, background entry points, list and image performance, async gaps across `BuildContext`, disposal, theme and design tokens, accessibility, localization, offline and error states, or Flutter test and golden coverage. Do not use for Dart language generalities, native Android or iOS internals beyond the engine and channel-registration seam a Dart entry point depends on, or broad rewrites.

chonamdoo/ios-app-shell-error-handling

Use when implementing or reviewing iOS app-wide error handling where SwiftUI views/ViewModels notify common errors and an @main App, WindowGroup AppShell, NavigationStack coordinator, or UIKit AppCoordinator owns root navigation, tab/session flow switching, alerts, sheets, toast hosts, SessionExpired handling, Maintenance handling, and root reset behavior.

chonamdoo/ios-clean-presentation-architecture

Use when creating, modifying, or reviewing an iOS Clean Architecture presentation layer with SwiftUI/UIKit state holders, explicit UiState, UiModel mapping, dependency injection, and state-based presentation code review.

chonamdoo/to-prd

Synthesizes the current conversation and codebase context into a PRD, then writes or publishes it according to the caller's requested output target. Use when the user asks to turn an already-discussed idea, plan, or conversation into a PRD; use `grilling` first if key decisions are still unresolved.

관련 스킬