production-code-standards

Production Code Standards Skill

Overview

This skill encapsulates the CLAUDE Framework standards for production-ready code development. It ensures consistency, quality, security, and maintainability across all code deliverables.

When to Use This Skill

• Creating new features requiring production quality
• Code reviews against production standards
• Refactoring legacy code to modern standards
• Training on development best practices
• Pre-deployment quality validation

Core Principles (Level 1 - Always Loaded)

🎯 Priority Rules (CRITICAL - Non-Negotiable)

Basis Missie - Breaking these = delivery rejected:

• BM-1 (MUST): Never invent, omit, or skip functionality
• BM-2 (MUST): Follow exact instructions from user
• BM-3 (MUST): Ask questions when unclear, never assume

Impact Analysis - Before ANY code change:

• IA-1 (MUST): Analyze impact on existing functionality
• IA-2 (MUST): Check all dependencies that will be affected
• IA-3 (MUST): Search for all files that import/use the code
• IA-4 (MUST): Run existing tests BEFORE changes
• IA-5 (MUST): Backup/document original implementation when overwriting
• IA-6 (MUST NOT): Never overwrite code without impact check
• IA-7 (MUST): Ask permission before overwriting with impact explanation

🔴 Code Quality Standards

Single Responsibility & DRY:

// ✅ GOOD - Single responsibility
class UserAuthenticator {
  authenticate(credentials: Credentials): AuthResult {
    return this.validateAndAuthenticate(credentials);
  }
}

class UserNotifier {
  sendWelcomeEmail(user: User): void {
    this.emailService.send(user.email, 'Welcome!');
  }
}

// ❌ BAD - Multiple responsibilities
class UserManager {
  authenticate() { /* auth logic */ }
  sendEmail() { /* email logic */ }
  updateDatabase() { /* db logic */ }
}

Naming Conventions (MUST):

• Functions: getUserData(), calculateTotal() (verbs)
• Variables: user, totalAmount (nouns)
• Booleans: isValid, hasPermission (is/has prefix)
• Constants: MAX_RETRY_COUNT, API_BASE_URL
• Classes: UserService, OrderController (PascalCase)