Universal code quality guidelines applicable to any language or framework.
Context: If .ai-factory/ARCHITECTURE.md exists, follow its folder structure, dependency rules, and module boundaries alongside these guidelines.
| Naming | Descriptive, consistent, reveals intent | | Functions | Small, single purpose, no side effects | | Errors | Specific types, never swallow, log context | | Tests | AAA pattern, test behavior, descriptive names | | Reviews | Be specific, suggest solutions, be kind |
Pautas de calidad del código y mejores prácticas para escribir código limpio y mantenible. Cubre estándares de nomenclatura, estructura, manejo de errores, pruebas y revisión de código. Úselo al escribir código, revisar, refactorizar o preguntar "cómo debería nombrar esto", "mejores prácticas para", "código limpio". Fuente: lee-to/ai-factory.