---

name: cms-core-contract description: Laws of physics for Andara Ionic CMS - read this before any task

CMS Core Contract v1.0

MANDATORY: Every agent must load and obey this skill before any task.

1) Non-Negotiables (Policy)

The Golden Rule

"Templates are code. Pages are data."

• Canonical templates are immutable code artifacts
• Pages are data records with props/content passed to templates
• Any "new layout idea" → create a new template version, never overwrite

Protected Files (NEVER EDIT)

Copyclient/src/templates/gpt/LandingLayout.tsx    # CANONICAL_LAYOUT_V1
client/src/templates/gpt/ProductLayout.tsx    # CANONICAL_LAYOUT_V1
client/src/templates/gpt/ArticleLayout.tsx    # CANONICAL_LAYOUT_V1
client/src/templates/gpt/UtilityLayout.tsx    # CANONICAL_LAYOUT_V1
client/src/templates/gpt/IONLayout.tsx        # CANONICAL_LAYOUT_V1

Prohibited Actions

• ❌ NEVER edit files containing CANONICAL_LAYOUT_V1 signature
• ❌ NEVER restore old navigation, icons, or prior layout snapshots
• ❌ NEVER overwrite templates - only consume via props
• ❌ NEVER create backup files that clutter the codebase

Allowed Actions

• ✅ Generate page content in client/src/pages/ or client/src/generated/
• ✅ Create NEW components in /generated/ if needed
• ✅ Create new template versions (e.g., LandingLayout-v2.tsx)
• ✅ Edit page files to pass different props to layouts

---

2) System Architecture

Template Hierarchy

Naming Conventions

• Pages: kebab-case.tsx (e.g., water-science-overview.tsx)
• Components: PascalCase.tsx (e.g., ProductBox.tsx)
• Routes: match page filename without extension

Routing Rules

• All routes defined in client/src/App.tsx
• Use lazy loading for all page imports
• Route path = page filename (without .tsx)

---

3) Quality Gates

Before completing ANY task, verify:

• No protected files were modified
• No old layouts/icons were restored
• New components placed in correct directory
• Routes added for any new pages
• Build passes: npm run build
• Guards pass: npm run guard:all

---

Conflict Resolution

If any conflict exists between older behavior and this contract, this contract wins.

When in doubt:

1. Check if file contains CANONICAL_LAYOUT_V1
2. If yes → DO NOT EDIT
3. Create new versioned copy if changes needed