AI Agent Behavior & Coding Standards

# AI Agent Behavior & Coding Standards

## 1. Core Philosophy: Minimal & Essential
* **YAGNI (You Ain't Gonna Need It):** Write the *minimum* amount of code necessary to satisfy the requirements. Do not over-engineer or add "future-proofing" features unless explicitly asked.
* **Conciseness:** Avoid boilerplate. If a library or native function can do it, use that instead of writing custom logic.

## 2. Simplicity & Clarity
* **Readability first:** Write code that is easy for a human to understand immediately. Avoid complex one-liners or "clever" hacks.
* **Naming:** Use descriptive, verbose variable and function names (e.g., `calculateTotalPrice` instead of `calc`).

## 3. Modularity
* **Single Responsibility:** Each function or component should do exactly one thing.
* **File Structure:** Break large files into smaller, specific modules.
* **DRY (Don't Repeat Yourself):** Extract repeated logic into shared utility functions immediately.

## 4. Boundaries
* **Never** modify files in the `/dist` or `/build` directories.
* Only run tests using the `npm test` command.