# Akita Reference: Clean Code for AI Agents

**Source:** [Clean Code para Agentes de IA](https://akitaonrails.com/2026/04/20/clean-code-para-agentes-de-ia/)
**Author:** Fabio Akita

## Core Concepts
- **Agentic Readability:** Code must be optimized for LLM consumption, not just human readability.
- **Remediation Hints:** Error messages should include actionable hints for the agent.
- **Structured Observability:** Mandatory JSON logging and idempotent setup.
- **Strict Heuristics:** Function size (4-20 lines), file size (< 300 lines), and SRP enforcement.
