---

name: layout-guard-v1 description: Protect canonical templates from modification - enforce immutability

Layout Guard Skill v1.0

Purpose: Prevent any modification to canonical layout templates.

1) Non-Negotiables (Policy)

Protected Files List

These files must NEVER be edited by any agent:

Copyconst PROTECTED_FILES = [
  'client/src/templates/gpt/LandingLayout.tsx',
  'client/src/templates/gpt/ProductLayout.tsx',
  'client/src/templates/gpt/ArticleLayout.tsx',
  'client/src/templates/gpt/UtilityLayout.tsx',
  'client/src/templates/gpt/IONLayout.tsx',
  'client/src/templates/gpt/index.ts',
];

const PROTECTED_SIGNATURES = [
  'CANONICAL_LAYOUT_V1',
];

Detection Rules

A file is protected if:

1. It's in the PROTECTED_FILES list, OR
2. It contains any PROTECTED_SIGNATURES string

---

2) Inputs & Outputs

Inputs (When to Run)

Run this skill:

• Before ANY file edit operation
• Before committing changes
• As part of CI/CD pipeline (npm run guard:layouts)

Output Contract

Copy{
  "status": "PASS" | "FAIL",
  "protectedFilesChecked": number,
  "violations": [
    {
      "file": "string",
      "reason": "string"
    }
  ]
}

---

3) Quality Gates

Pre-Edit Check

Before editing ANY file:

Copy# Check if file is protected
grep -l "CANONICAL_LAYOUT_V1" <target-file>

If match found → ABORT EDIT

Post-Change Validation

After any changes:

Copynpm run guard:layouts

Must return exit code 0.

CI/CD Integration

This guard runs automatically via:

Copy"prebuild": "npm run guard:all"

---

Enforcement Scripts

Primary Guard Script

Location: scripts/guard-layouts.ts

Run manually:

Copynpm run guard:layouts

What It Checks

1. Protected files have not been modified (git diff)
2. CANONICAL_LAYOUT_V1 signature is intact
3. No new edits pending for protected files

---

Recovery Procedures

If Protected File Was Modified

1. Immediately revert: git checkout -- <protected-file>
2. Review changes: Extract any valid logic
3. Create new version: LayoutName-v2.tsx if changes needed
4. Never merge: Block any PR modifying protected files

If Layout Needs Update

1. Create LandingLayout-v2.tsx (new version)
2. Add CANONICAL_LAYOUT_V2 signature
3. Add to protected files list
4. Migrate pages gradually