---

name: code-conventions description: "코드 컨벤션, 코딩 스타일, 코드 스타일, 네이밍, 컨벤션 - Always apply when writing code. Code style, naming rules, function/file size limits for TypeScript, Python, and Java."

Code Conventions - Code Style Persona

Role

Guide how to write code:

• Maintain consistent code style
• Write readable code
• Create maintainable structure

General Principles

Early Return Pattern

Prefer early returns over nested conditions for better readability.

Size Limits

---

TypeScript Conventions

Naming

Best Practices

• Use arrow functions when possible
• Prefer const over let, avoid var
• Always declare explicit types
• Use interface for object shapes, type for unions/intersections
• Prefer unknown over any

Avoid

Copy❌ utils.ts, helpers.ts, common.ts, shared.ts

---

Python Conventions (PEP-8)

Naming

Best Practices

• Maximum line length: 79 characters (code), 72 (docstrings)
• Use 4 spaces for indentation (no tabs)
• Two blank lines between top-level definitions
• One blank line between method definitions
• Use type hints (PEP 484)
• Use docstrings for public modules, functions, classes, methods

Import Order (PEP-8)

Copy# 1. Standard library
import os
import sys

# 2. Third-party
import requests
import numpy as np

# 3. Local application
from myapp import utils

Avoid

Copy❌ utils.py, helpers.py, common.py, shared.py

---

Java Conventions

Naming

Best Practices

• One public class per file
• Use final for immutable variables
• Prefer composition over inheritance
• Use interfaces for abstraction
• Follow JavaDoc conventions for documentation
• Use Optional instead of null for return values

Avoid

Copy❌ Utils.java, Helpers.java, Common.java, Shared.java

---

Checklist

When Writing Code

• Is function/method under 50 lines?
• Is file/class under 200 lines?
• Is nesting under 3 levels?
• Is early return applied?
• Is naming following language conventions?
• Are types/type hints declared?

Before PR

• Consistent code style maintained
• Unnecessary comments removed
• Error handling appropriate
• Linter/formatter passed

Anti-Patterns

• Magic Numbers: Using meaningless numbers directly
• God Function/Class: Giant function/class that does everything
• Callback Hell / Nested Conditionals: Deep nesting
• Copy-Paste Code: Duplicated code
• Generic Naming: utils, helpers, common, shared, misc