Coding Guidelines

Overview

Apply these rules to produce predictable, debuggable code that can be safely rewritten by future LLMs. These coding principles are mandatory! Assume all code will be written and maintained by LLMs, not humans. Optimize for model reasoning, regeneration, and debugging — not human aesthetics.

Principles

1. Structure

• Use a consistent, predictable project layout.
• Group code by feature or screen; keep shared utilities minimal.
• Create simple, obvious entry points.
• Identify shared structure before scaffolding multiple files.
• Use framework-native composition patterns for shared elements.
• Treat duplication that needs the same fix in multiple places as a code smell.