AI Website Build Guide
For AI Agents: This directory is a Self-Referential Manual. It is written by AI, for AI. When you are asked to “Create a new page,” “Add a feature,” or “Fix a style,” CONSULT THESE GUIDES FIRST.
Documentation Map
Core Protocol
- TODOAI Protocol: MANDATORY FIRST STEP. How AI agents must locate tasks, find relevant guides, and plan before execution.
Frontend
How to write user-facing code and make it look good.
Style-Guidelines
- Color-Palette: SINGLE SOURCE OF TRUTH for all colors
- Design-Principles: Philosophy, keywords, anti-patterns
- Register-Dashboards: Dashboard UI + Privacy rules
- Brand-Assets: Logos, variants, usage guidelines
Code Guides
- Markdown-Pages: Frontmatter, content structure, bilingual formatting
- TSX-Components: React components, SCSS, responsive design
- Bilingual-System: English/Italian translation with
<Translate /> - Index Routing & PDFs: MANDATORY reading before adding complex TSX indices or linking PDFs
Backend
How data flows.
- Registers-SQL: Database schemas (Financial, Candidate registers)
- Python-Services: Automation scripts
- Project-Structure: Monorepo layout overview
- Architecture & Deployment: Master guide on CL-sync, Cloudflare, and Quartz structure.
Documentation (LaTeX) / Link Submodule
Official Documents and Contracts.
- LaTeX-Style-Guide: MANDATORY aesthetics (No Caps, Macros, Layout) for AI Agents.
- Bureaucracy-Codes: MANDATORY codes (LL-LL-NNN) for official docs
- Consult LaTeX Folder: See
LaTeX_CL/System/for more guides
This guide is a living document. If you (the AI) discover a new pattern or rule, update these files.