clean-code-principles

name	clean-code-principles
description	Clean code principles for writing maintainable, readable code. Use when refactoring, code reviews, or writing new code to improve code quality.
license	Apache 2.0

Clean Code Principles

When to Use This Skill

• Writing new production code
• Refactoring existing code
• Code reviews

Core Concepts

Meaningful Names

Good:

function calculateMonthlyInterest(principal: number): number { ... }
const maximumRetryAttempts = 3;

Bad:

function calc(d: number): number { ... }
const max = 3;

Small Functions

Functions should do ONE thing well:

async function processOrder(order: Order) {
  validateOrder(order);
  const total = calculateTotal(order);
  const paymentResult = await chargePayment(order, total);
  await updateInventory(order);
  await sendConfirmation(order, total);
  return { orderId: order.id, total, paymentResult };
}

Single Responsibility

class UserService { getUser(id) { ... } }
class UserRepository { save(user) { ... } }
class EmailService { sendEmail(user) { ... } }

References

• Clean Code - Robert C. Martin