diff --git a/.agents/rules/blog-system.md b/.agents/rules/blog-system.md index c7e16dd..1e87418 100644 --- a/.agents/rules/blog-system.md +++ b/.agents/rules/blog-system.md @@ -1,13 +1,29 @@ # Technical Blog System Rules & Architecture Directives -## 1. Pedagogical Explanations (Interactive Learning) +## 1. Core Invariant: User Content Sovereignty (Highest Priority) +1. **User Edits Are Absolute Ground Truth:** + - The user's edits, custom writing, post titles, navigation labels, terminology, and naming choices are the absolute highest level of truth in this codebase. + - They strictly take precedence over any background content description, sample design mockup (`sample-designs/*`), skill instructions, or default boilerplate. +2. **Strict Prohibition on Unsolicited Rewriting or Renaming:** + - You must **NEVER** revert, alter, overwrite, or substitute user-authored text, titles, navigation labels, tags, or naming conventions unless the user directly and explicitly requests that specific modification. + - Do not reintroduce removed text or names from prior mockups or commits. +3. **Mandatory Clarification Gate:** + - If you notice a potential inconsistency, typo, or naming ambiguity in user-authored content, you must **NOT** unilaterally modify it. + - You must ask the user for specific clarification before altering any user-authored writing or naming. +4. **Sample Designs Are Layout References Only:** + - Files in `sample-designs/` serve solely as visual, CSS, and structural layout references. + - Never extract or re-inject titles, domain names, service labels, or technical copy from `sample-designs/` into active templates or site data without explicit instruction. + +--- + +## 2. Pedagogical Explanations (Interactive Learning) 1. **Explain the Code:** Whenever creating or refactoring code (Eleventy configuration, Nunjucks templates, CSS modules, build scripts), provide a clear, educational breakdown. 2. **Break Down Key Concepts:** Explain *why* a particular Eleventy filter, Nunjucks tag, or CSS variable structure was used so the user learns the foundational concepts. 3. **No Magic:** Avoid opaque or overly clever abstractions; prioritize readable, idiomatic code with commentary explaining tricky points. --- -## 2. CSS Architecture & Isolation +## 3. CSS Architecture & Isolation 1. **Zero Monolithic Inlines:** Do not inject raw `