anime_downloader/.agent/workflows/coding-rules.md

description

description
anime_downloader 플러그인 코딩 규칙

코딩 규칙

타입 힌트

• 모든 새 코드에 타입 힌트 필수 적용
• 함수 파라미터와 반환값에 타입 지정
• 클래스 변수에도 타입 지정

코드 스타일

• 한국어 주석 사용
• 로거 메시지는 영어/한국어 혼용 가능
• 에러 메시지는 간결하게

커맨드 실행 규칙

• rm, mv, cp 등 파일을 변조하거나 삭제할 수 있는 파괴적인 명령은 반드시 사용자 승인 필요 (SafeToAutoRun: false)
• cat, grep, sed, ps, lsof, curl (단순 조회용) 등 부수 효과가 없는 조회성 명령은 자동 실행 허용 (SafeToAutoRun: true)

FlaskFarm 관련

• flaskfarm 코어 소스 수정 최소화 (외부 프로젝트)
• 플러그인 내에서 해결 가능한 것은 플러그인에서 처리