Code Conventions

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

❌ 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)

# 1. Standard library
import os
import sys

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

# 3. Local application
from myapp import utils

Avoid

❌ 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

❌ 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

Completion

레퍼런스 Skill이므로 독립적 완료 조건 없음. 다른 Skill(code-reviewer, refactor-cleaner)이 참조하여 사용.

Troubleshooting

Project uses conventions different from this skill: Project-level CLAUDE.md or .editorconfig takes precedence. This skill provides defaults when no project convention exists. Naming conflict between languages: Each language section is independent. Python uses snake_case, TypeScript uses camelCase — don't mix across language boundaries. Linter rules conflict with these conventions: Linter config is authoritative. Update this skill’s guidance in project CLAUDE.md if persistent conflicts arise.