AGENTS.md | Static Site SEO & Development Protocol

🎯 Core Philosophy

This site is a performance-first, static asset built with Jekyll and hosted via GitHub Actions/Pages. Every technical or content suggestion must prioritize Search Intent, Crawlability, and Zero Technical Debt.

🔴 SEO & Indexing Hard Rules (Jekyll Specific)

  1. Clean URLs: Strictly enforce trailing slashes (e.g., /page/) in _config.yml. Never suggest .html extensions as they create professional friction and indexing fragmentation.
  2. Front Matter Integrity: Every new .md or .html file MUST include:
    • layout: default
    • title: Keyword-optimized (60 chars max)
    • description: Benefit-driven (155 chars max)
    • last_modified_at: Current date for freshness signals
    • permalink: Explicitly defined to avoid Jekyll’s default folder nesting.
  3. Sitemap & Robots: Any new directory or programmatic collection must be verified against the sitemap.xml template to ensure immediate discovery by Search Console.
  4. Schema Injection: Prioritize JSON-LD injection for WebSite, FAQPage, or SoftwareApplication within the specific page’s Liquid tags to capture Rich Results.
  5. No JS-Dependency for Content: Core informational content must be rendered in static HTML. Avoid “Empty Page” traps where crawlers see a blank screen due to client-side JavaScript execution.

🎨 Visual & UI Guardrails

  • Design Consistency: Maintain a unified color palette (e.g., Brand Purple) across all UI elements, including icons and buttons, to establish Brand Trust.
  • Asset Optimization: All images must be WebP format with explicit width and height attributes to prevent Layout Shift (CLS).
  • Mobile-First: Use Tailwind CSS (or equivalent) to ensure all grid layouts stack logically on mobile devices (390px width baseline).

🛠️ Operational Strategy

  • The 10-Hour Rule: Since the owner is a Solo Entrepreneur with limited time, prioritize Programmatic SEO and High-ROI automations over manual labor.
  • Internal Linking Hubs: Every informational page (Blog/Glossary) must include a contextual Call-to-Action (CTA) pointing to a functional utility or product page.
  • Brutal Honesty: Do not offer platitudes or sugarcoated advice. If a proposed feature or content idea does not directly contribute to the $1,000/month revenue goal or SEO authority, flag it as a distraction.