Node.js Project Architecture for AI-Friendly Development

Architecture standards that keep files small enough for AI agents to read/edit without blowing the context window.

Core Rules

• Single file max 400 lines, index.html max 200 lines, server.js entry max 100 lines
• All tunable values in config.json, loaded at runtime, editable via admin dashboard
• Backend: routes/ by domain, services/ for shared logic, db.js for database
• Frontend: HTML skeleton only, JS/CSS in separate files
• Every project gets admin.html + routes/admin.js for config hot-reload

Project Type Selection

Determine project type, then read the corresponding reference: