slug: clean-code
title: "Clean Code — Naming, Functions, and Readability That Scales"
version: 1.0.0
description: "Write code that humans can read — naming, function design, and refactoring habits."
category: fundamentals
tags: [clean-code, readability, refactoring, naming, functions]
difficulty: beginner

xp:
  read: 10
  walkthrough: 30
  exercise: 20
  quiz: 15
  quiz-perfect-bonus: 10
  game: 20
  game-perfect-bonus: 10

time:
  quick: 5
  read: 15
  guided: 40

prerequisites: []
related: [solid-principles, code-review]

triggers:
  - "How do I write clean code?"
  - "What makes code readable?"
  - "How should I name variables and functions?"
  - "When should I refactor?"

visuals:
  diagrams: [diagram-flow]
  quiz-types: [quiz-fill-blank, quiz-timed-choice]
  game-types: [bug-hunt, speed-round]
  playground: javascript

sources:
  - url: "https://martinfowler.com/books/refactoring.html"
    label: "Refactoring by Martin Fowler"
    type: docs
  - url: "https://www.oreilly.com/library/view/clean-code-a/9780136083238/"
    label: "Clean Code by Robert Martin"
    type: docs