rebly-sections 1.1.0 → 1.2.0

package/assets/data/design-tokens.csv

@@ -88,3 +88,6 @@ No,Token Name,Category,Value,CSS Variable,Keywords,Usage,Notes
 87,z-overlay,z-index,30,--z-overlay,z-index overlay backdrop,z-index: var(--z-overlay),Z-index layer scale
 88,z-modal,z-index,40,--z-modal,z-index modal dialog,z-index: var(--z-modal),Z-index layer scale
 89,z-toast,z-index,50,--z-toast,z-index toast notification alert,z-index: var(--z-toast),Z-index layer scale
+90,font-family-sans,typography,"system-ui, -apple-system, 'Segoe UI', Roboto, sans-serif",--font-family-sans,font family sans serif system stack body,font-family: var(--font-family-sans),System sans-serif stack for body text
+91,font-family-serif,typography,"Georgia, 'Times New Roman', serif",--font-family-serif,font family serif classic editorial heading,font-family: var(--font-family-serif),Classic serif stack for editorial headings
+92,font-family-mono,typography,"'SF Mono', 'Fira Code', 'Courier New', monospace",--font-family-mono,font family monospace code technical,font-family: var(--font-family-mono),Monospace stack for code and technical content

package/assets/data/settings-profiles.csv

@@ -119,6 +119,10 @@ hero,title_1,text,Title 1,,False,Appears in 296/2150 hero sections,7
 hero,url_banner2,url,Url Banner2,,False,Appears in 276/2150 hero sections,8
 hero,button_2,text,Button 2,,False,Appears in 261/2150 hero sections,9
 hero,url_button1,url,Url Button1,,False,Appears in 254/2150 hero sections,10
+hero,heading_font,font_picker,Heading Font,,False,Typography control for hero heading,11
+hero,heading_size,select,Heading Size,,False,Small/Medium/Large heading scale,12
+hero,heading_tag,select,Heading Tag,,False,H1/H2/H3 for SEO hierarchy,13
+hero,color_scheme,color_scheme,Color Scheme,,False,Theme-wide color scheme,14
 logo,title,text,Title,,True,Appears in 19/32 logo sections,1
 logo,logo_max_width,image_picker,Logo Max Width,,True,Appears in 7/32 logo sections,2
 logo,logo,image_picker,Logo,,True,Appears in 6/32 logo sections,3

package/assets/data/shopify-best-practices.csv

@@ -51,3 +51,8 @@ No,Rule,Category,Severity,Keywords,Description,Do,Dont,Code Example
 50,Structured data JSON-LD,seo,recommended,structured data schema.org json-ld rich snippets,"Add JSON-LD structured data for products, articles, FAQs","Include <script type=""application/ld+json""> with schema.org markup",Rely solely on meta tags without structured data,
 51,Heading per section,seo,important,heading h2 section title SEO crawl hierarchy,Each section should have a configurable heading element,Use a heading_tag setting (h2/h3/h4) for section headings,Hardcode heading levels — breaks hierarchy across sections,
 52,Image alt from settings,seo,important,image alt text setting SEO accessible,Provide alt text settings or use Shopify image.alt,"Output alt=""{{ section.settings.image.alt | escape }}""",Omit alt attributes on section images,
+53,Typography controls required,schema,high,"font_picker heading typography control",Sections with heading text should include font_picker setting,Include font_picker setting for primary heading,Hardcode font-family in CSS only,
+54,Heading tag configurable,seo,high,"heading tag h1 h2 h3 SEO hierarchy select",Heading level must be configurable via select setting for SEO,Add heading_tag select setting (h1/h2/h3/h4),Hardcode <h1> or <h2> without merchant control,
+55,Color scheme over color picker,os2-architecture,high,"color_scheme color picker theme consistency",Prefer color_scheme setting over individual color pickers for theme consistency,Use type: color_scheme for section colors,Use individual color pickers for every color,
+56,Button styling controls,schema,high,"button style color background CTA",CTA buttons should have configurable style/color settings,Add button_style select and button color settings,Hardcode button background and text colors,
+57,No hardcoded font sizes,css,high,"font size hardcoded clamp responsive typography",Font sizes should use clamp() or CSS vars — never fixed px,Use clamp() or CSS custom properties for font-size,Use fixed px values like font-size: 48px,

package/assets/scripts/core.py

@@ -4,6 +4,7 @@
 
 import csv
 import re
+import sys
 from pathlib import Path
 from math import log
 from collections import defaultdict
@@ -124,7 +125,7 @@ def _load_csv(filepath):
         return list(csv.DictReader(f))
 
 
-def _search_csv(filepath, search_cols, output_cols, query, max_results):
+def _search_csv(filepath, search_cols, output_cols, query, max_results, min_score=0.0):
     """Core search function using BM25"""
     if not filepath.exists():
         return []
@@ -136,11 +137,20 @@ def _search_csv(filepath, search_cols, output_cols, query, max_results):
     bm25.fit(documents)
     ranked = bm25.score(query)
 
+    # Filter by min_score threshold
+    candidates = [(idx, score) for idx, score in ranked[:max_results * 2] if score > 0]
+    if min_score > 0:
+        filtered = [(idx, score) for idx, score in candidates if score >= min_score]
+        if len(candidates) != len(filtered):
+            print(f"[DEBUG] BM25: filtered {len(candidates) - len(filtered)} low-score results (threshold={min_score})", file=sys.stderr)
+        candidates = filtered
+
     results = []
-    for idx, score in ranked[:max_results]:
-        if score > 0:
-            row = data[idx]
-            results.append({col: row.get(col, "") for col in output_cols if col in row})
+    for idx, score in candidates[:max_results]:
+        row = data[idx]
+        entry = {col: row.get(col, "") for col in output_cols if col in row}
+        entry['_score'] = score
+        results.append(entry)
 
     return results
 
@@ -166,7 +176,7 @@ def detect_domain(query):
     return best if scores[best] > 0 else "components"
 
 
-def search(query, domain=None, max_results=MAX_RESULTS):
+def search(query, domain=None, max_results=MAX_RESULTS, min_score=0.0):
     """Main search function with auto-domain detection"""
     if domain is None:
         domain = detect_domain(query)
@@ -177,7 +187,7 @@ def search(query, domain=None, max_results=MAX_RESULTS):
     if not filepath.exists():
         return {"error": f"File not found: {filepath}", "domain": domain}
 
-    results = _search_csv(filepath, config["search_cols"], config["output_cols"], query, max_results)
+    results = _search_csv(filepath, config["search_cols"], config["output_cols"], query, max_results, min_score=min_score)
 
     return {
         "domain": domain,

package/assets/scripts/quality-gate-checks.py

@@ -0,0 +1,55 @@
+#!/usr/bin/env python3
+"""Additional quality gate checks — WARN-level advisory checks for section quality."""
+
+import re
+
+
+def check_has_color_scheme(content, schema_json):
+    """Check if section schema includes color_scheme setting."""
+    if not schema_json:
+        return ("WARN", "No schema to check for color_scheme")
+    settings = schema_json.get("settings", [])
+    has_cs = any(s.get("type") == "color_scheme" for s in settings)
+    if has_cs:
+        return ("PASS", "color_scheme setting present")
+    return ("WARN", "Missing color_scheme setting — recommended for theme consistency")
+
+
+def check_has_font_picker(content, schema_json):
+    """Check if section schema includes at least one font_picker."""
+    if not schema_json:
+        return ("WARN", "No schema to check for font_picker")
+    settings = schema_json.get("settings", [])
+    has_fp = any(s.get("type") == "font_picker" for s in settings)
+    if has_fp:
+        return ("PASS", "font_picker setting present")
+    return ("WARN", "Missing font_picker — sections with headings should include typography control")
+
+
+def check_has_heading_tag(content, schema_json):
+    """Check if section has configurable heading tag for SEO."""
+    if not schema_json:
+        return ("WARN", "No schema to check for heading_tag")
+    settings = schema_json.get("settings", [])
+    has_ht = any(
+        s.get("id") in ("heading_tag", "heading_element", "tag")
+        and s.get("type") == "select"
+        for s in settings
+    )
+    if has_ht:
+        return ("PASS", "Heading tag configurable")
+    return ("WARN", "Missing heading_tag select — heading level should be merchant-configurable")
+
+
+def check_no_hardcoded_colors(content, schema_json):
+    """Check CSS doesn't contain hardcoded hex colors (outside Liquid variables)."""
+    style_match = re.search(r'<style[^>]*>(.*?)</style>', content, re.DOTALL)
+    if not style_match:
+        return ("PASS", "No style block found")
+    css = style_match.group(1)
+    # Strip Liquid variable references ({{ ... }}) before scanning
+    css_no_liquid = re.sub(r'\{\{.*?\}\}', '', css)
+    hex_colors = re.findall(r'#[0-9a-fA-F]{3,8}\b', css_no_liquid)
+    if hex_colors:
+        return ("WARN", f"Hardcoded colors in CSS: {', '.join(hex_colors[:5])} — use CSS variables instead")
+    return ("PASS", "No hardcoded colors in CSS")

package/assets/scripts/quality-gate.py

@@ -6,12 +6,23 @@ Usage: python3 quality-gate.py path/to/section.liquid [--json]
 """
 
 import argparse
+import importlib.util
 import json
 import re
 import sys
 from pathlib import Path
 
-
+# Import advisory checks from helper module (graceful fallback if missing)
+_checks_mod = None
+try:
+    _checks_path = Path(__file__).parent / 'quality-gate-checks.py'
+    _spec = importlib.util.spec_from_file_location('qg_checks', _checks_path)
+    _checks_mod = importlib.util.module_from_spec(_spec)
+    _spec.loader.exec_module(_checks_mod)
+except (FileNotFoundError, AttributeError):
+    pass
+
+# Core checks (PASS/FAIL)
 QUALITY_CHECKS = [
     ("schema_valid_json", "Schema block contains valid JSON"),
     ("has_presets", "Schema has non-empty presets array"),
@@ -26,6 +37,14 @@ QUALITY_CHECKS = [
     ("text_elements_explicit_color", "Text elements have explicit color in CSS"),
 ]
 
+# Advisory checks (PASS/WARN) — imported from quality-gate-checks.py
+ADVISORY_CHECKS = [
+    ("has_color_scheme", "color_scheme setting present"),
+    ("has_font_picker", "font_picker setting present"),
+    ("has_heading_tag", "Heading tag configurable via select"),
+    ("no_hardcoded_colors", "No hardcoded hex colors in CSS"),
+]
+
 
 def extract_schema_json(content):
     """Extract JSON from {% schema %} block"""
@@ -161,10 +180,13 @@ def run_quality_gate(filepath):
         return f"Error: File not found: {filepath}"
 
     content = path.read_text(encoding="utf-8")
+    schema_json = extract_schema_json(content)
     results = []
     passed = 0
     failed = 0
+    warned = 0
 
+    # Core checks (PASS/FAIL)
     for check_id, description in QUALITY_CHECKS:
         check_fn = CHECK_FUNCTIONS[check_id]
         try:
@@ -179,12 +201,44 @@ def run_quality_gate(filepath):
             failed += 1
             results.append(f"✗ {description}: ERROR ({e})")
 
+    # Advisory checks (PASS/WARN) — skip if helper module unavailable
+    if not _checks_mod:
+        advisory_fns = {}
+    else:
+        advisory_fns = {
+            "has_color_scheme": _checks_mod.check_has_color_scheme,
+            "has_font_picker": _checks_mod.check_has_font_picker,
+            "has_heading_tag": _checks_mod.check_has_heading_tag,
+            "no_hardcoded_colors": _checks_mod.check_no_hardcoded_colors,
+        }
+    for check_id, description in ADVISORY_CHECKS:
+        if check_id not in advisory_fns:
+            continue
+        check_fn = advisory_fns[check_id]
+        try:
+            status, message = check_fn(content, schema_json)
+            if status == "PASS":
+                passed += 1
+            else:
+                warned += 1
+            icon = "✓" if status == "PASS" else "⚠"
+            results.append(f"{icon} {message}: {status}")
+        except Exception as e:
+            warned += 1
+            results.append(f"⚠ {description}: ERROR ({e})")
+
+    total = passed + failed + warned
     summary = f"\n## Quality Gate: {path.name}\n"
-    summary += f"**Score:** {passed}/{passed + failed} checks passed\n\n"
+    summary += f"**Score:** {passed}/{total} checks passed"
+    if warned:
+        summary += f" ({warned} warnings)"
+    summary += "\n\n"
     summary += "\n".join(results)
 
     if failed == 0:
         summary += "\n\n**Result: PASS** ✓"
+        if warned:
+            summary += f" (with {warned} advisory warnings)"
     else:
         summary += f"\n\n**Result: FAIL** — {failed} issue(s) found"
 

package/assets/scripts/section-generator-helpers.py

@@ -15,7 +15,7 @@ def search_block_patterns(description):
     try:
         result = search(description, domain="block-patterns", max_results=5)
         if "error" in result or not result.get("results"):
-            return "N/A"
+            return ""
         lines = ["**Relevant Block Patterns:**"]
         for r in result["results"]:
             lines.append(f"- [{r.get('Category', '')} / {r.get('Block Type', '')}] {r.get('Use Case', '')}")
@@ -25,7 +25,7 @@ def search_block_patterns(description):
                 lines.append(f"  Example: `{ex[:200]}`")
         return "\n".join(lines)
     except (FileNotFoundError, KeyError):
-        return "N/A"
+        return ""
 
 
 def search_settings_profile(section_name):
@@ -33,7 +33,7 @@ def search_settings_profile(section_name):
     try:
         result = search(section_name, domain="settings-profiles", max_results=8)
         if "error" in result or not result.get("results"):
-            return "N/A"
+            return ""
         lines = ["**Recommended Settings Profile:**",
                  "| Setting ID | Type | Label | Default | Required |",
                  "|------------|------|-------|---------|----------|"]
@@ -42,7 +42,7 @@ def search_settings_profile(section_name):
                          f"{r.get('Label', '')} | {r.get('Default', '')} | {r.get('Required', '')} |")
         return "\n".join(lines)
     except (FileNotFoundError, KeyError):
-        return "N/A"
+        return ""
 
 
 def search_theme_dna(theme_name):
@@ -50,11 +50,25 @@ def search_theme_dna(theme_name):
     try:
         result = search(theme_name, domain="themes", max_results=1)
         if "error" in result or not result.get("results"):
-            return "N/A"
+            return ""
         r = result["results"][0]
         return (f"**Theme DNA:** {r.get('Theme', '')} — "
                 f"CSS Prefix: {r.get('CSS Variable Prefix', '')} | "
                 f"Naming: {r.get('Section Naming', '')} | "
                 f"Blocks: {r.get('Block Conventions', '')}")
     except (FileNotFoundError, KeyError):
-        return "N/A"
+        return ""
+
+
+def search_design_tokens(description):
+    """Search design-tokens.csv for relevant CSS tokens."""
+    try:
+        result = search(description, domain="tokens", max_results=5, min_score=0.3)
+        if "error" in result or not result.get("results"):
+            return ""
+        lines = ["**Relevant Design Tokens:**"]
+        for r in result["results"]:
+            lines.append(f"- `{r.get('CSS Variable', '')}`: {r.get('Value', '')} — {r.get('Usage', '')}")
+        return "\n".join(lines)
+    except (FileNotFoundError, KeyError):
+        return ""

package/assets/scripts/section-generator.py

@@ -6,6 +6,7 @@ Usage: python3 section-generator.py "name" "description" [--theme-profile path]
 """
 
 import argparse
+import re
 import sys
 import io
 from pathlib import Path
@@ -25,6 +26,7 @@ _hs.loader.exec_module(_hm)
 search_block_patterns = _hm.search_block_patterns
 search_settings_profile = _hm.search_settings_profile
 search_theme_dna = _hm.search_theme_dna
+search_design_tokens = _hm.search_design_tokens
 
 TEMPLATE_DIR = Path(__file__).parent.parent / "templates"
 
@@ -48,8 +50,8 @@ def load_template(name):
     return ""
 
 
-def search_components(description, max_results=2):
-    """Search component library for closest pattern"""
+def search_components(description, max_results=1):
+    """Search component library for closest pattern — 1 full untruncated example"""
     result = search_component(description, max_results=max_results)
     if "error" in result or not result.get("results"):
         return "No matching component patterns found."
@@ -59,14 +61,14 @@ def search_components(description, max_results=2):
         output.append(f"**{r.get('Name', 'Unknown')}** ({r.get('Category', '')}, {r.get('Difficulty', '')})")
         output.append(f"Blocks: {r.get('Blocks Used', '')} | Settings: {r.get('Settings Count', '')}")
         if 'liquid_content' in r:
-            output.append(f"```liquid\n{r['liquid_content'][:3500]}\n```")
+            output.append(f"```liquid\n{r['liquid_content'][:6000]}\n```")
         output.append("")
     return "\n".join(output)
 
 
 def search_schema_settings(description, max_results=5):
     """Search schema-library for relevant setting types"""
-    result = search(description, domain="schema", max_results=max_results)
+    result = search(description, domain="schema", max_results=max_results, min_score=0.3)
     if "error" in result or not result.get("results"):
         return "No matching schema settings found."
 
@@ -81,7 +83,7 @@ def search_schema_settings(description, max_results=5):
 
 def search_best_practices(description, max_results=5):
     """Search best practices for applicable rules"""
-    result = search(description, domain="practices", max_results=max_results)
+    result = search(description, domain="practices", max_results=max_results, min_score=0.3)
     if "error" in result or not result.get("results"):
         return "No matching best practices found."
 
@@ -98,7 +100,7 @@ def search_best_practices(description, max_results=5):
 
 
 def try_ui_ux_bridge(ui_style_keywords):
-    """Optional: query ui-ux-pro-max if available"""
+    """Optional: query ui-ux-pro-max if available. Returns empty string if N/A."""
     try:
         ux_search_path = Path(__file__).parent.parent.parent.parent / ".claude" / "skills" / "ui-ux-pro-max" / "scripts" / "core.py"
         if not ux_search_path.exists():
@@ -111,19 +113,27 @@ def try_ui_ux_bridge(ui_style_keywords):
             spec.loader.exec_module(ux_module)
             result = ux_module.search(ui_style_keywords, domain="style", max_results=2)
             if result.get("results"):
-                lines = ["**UI/UX Style Recommendations (from ui-ux-pro-max):**"]
+                lines = ["<design_recommendations>", "**UI/UX Style Recommendations:**"]
                 for r in result["results"]:
                     lines.append(f"- {r.get('Style Category', '')}: {r.get('Keywords', '')}")
                     lines.append(f"  Effects: {r.get('Effects & Animation', '')}")
+                lines.append("</design_recommendations>")
                 return "\n".join(lines)
     except Exception:
         pass
-    return "N/A — ui-ux-pro-max not available"
+    # Return empty string instead of N/A to avoid wasting prompt tokens
+    return ""
+
+
+def _strip_empty_xml_tags(content):
+    """Remove XML tags whose body is empty or whitespace-only"""
+    return re.sub(r'<([\w-]+)>\s*</\1>', '', content)
 
 
 def assemble_context(name, description, theme_profile, component, schema,
-                     practices, design_recs, block_patterns="N/A",
-                     settings_profile="N/A", theme_dna="N/A"):
+                     practices, design_recs, block_patterns="",
+                     settings_profile="", theme_dna="",
+                     design_tokens="", refinement=""):
     """Merge all context into generation prompt"""
     template = load_template("generation-prompt.md")
     base_template = load_template("section-base.liquid")
@@ -140,44 +150,16 @@ def assemble_context(name, description, theme_profile, component, schema,
         content = content.replace("{{ block_patterns_results }}", block_patterns)
         content = content.replace("{{ settings_profile_results }}", settings_profile)
         content = content.replace("{{ theme_dna_context }}", theme_dna)
+        content = content.replace("{{ design_tokens_results }}", design_tokens)
+        content = content.replace("{{ refinement_context }}", refinement)
         base_block = f"```liquid\n{base_template}\n```" if base_template else "See standard OS2.0 section structure"
         content = content.replace("{{ section_base_content }}", base_block)
+        # Clean up empty XML tags from unused sections
+        content = _strip_empty_xml_tags(content)
         return content
 
-    # Fallback: manual assembly
-    return f"""# Generate Shopify Section: {name}
-
-## Description
-{description}
-
-## Theme Context
-{theme_profile}
-
-## Closest Pattern Template
-{component}
-
-## Relevant Schema Settings
-{schema}
-
-## Applicable Best Practices
-{practices}
-
-## Design Recommendations
-{design_recs}
-
-## Base Template
-```liquid
-{base_template}
-```
-
-## Requirements
-- OS2.0 compliant (presets, @app blocks, block.shopify_attributes)
-- Scoped CSS via #section-{{{{ section.id }}}}
-- Responsive (mobile-first)
-- Accessible (semantic HTML, aria-labels, alt text)
-- Performance (lazy-load non-hero images, no Liquid in CSS/JS)
-- Use {{% render %}} not {{% include %}}
-"""
+    # Fallback: manual assembly (shouldn't reach here with template present)
+    return f"# Generate Shopify Section: {name}\n\n{description}\n\n{component}\n\n{schema}\n\n{practices}"
 
 
 def main():
@@ -189,14 +171,18 @@ def main():
     args = parser.parse_args()
 
     theme = load_theme_profile(args.theme_profile)
+    # Tailored BM25 queries per domain for better relevance
     component = search_components(f"{args.name} {args.description}")
-    schema = search_schema_settings(args.description)
-    practices = search_best_practices(args.description)
+    schema = search_schema_settings(f"shopify section settings {args.description}")
+    practices = search_best_practices(f"shopify section {args.name} best practices")
     design_recs = try_ui_ux_bridge(args.name + " " + args.description)
     blocks = search_block_patterns(f"{args.name} {args.description}")
     profile = search_settings_profile(args.name)
     dna = search_theme_dna(args.name)
+    tokens = search_design_tokens(f"css typography spacing color {args.description}")
 
+    # Build refinement context as dedicated section (not appended to component)
+    refinement = ""
     if args.refine:
         refine_path = Path(args.refine)
         try:
@@ -207,13 +193,18 @@ def main():
             try:
                 from quality_gate import run_quality_gate
                 gate_result = run_quality_gate(args.refine)
-                refine_context = f"\n## Existing Section (for refinement)\n```liquid\n{existing[:3000]}\n```\n\n## Quality Gate Results\n{gate_result}\n\nPlease fix the issues identified above while preserving the section's functionality."
-                component += refine_context
+                refinement = (f"<refinement>\n## Existing Section (for refinement)\n"
+                              f"```liquid\n{existing[:3000]}\n```\n\n"
+                              f"## Quality Gate Results\n{gate_result}\n\n"
+                              f"Please fix the issues identified above while preserving functionality.\n"
+                              f"</refinement>")
             except ImportError:
-                component += f"\n## Existing Section (for refinement)\n```liquid\n{existing[:3000]}\n```"
+                refinement = (f"<refinement>\n## Existing Section (for refinement)\n"
+                              f"```liquid\n{existing[:3000]}\n```\n</refinement>")
 
     context = assemble_context(args.name, args.description, theme, component, schema,
-                               practices, design_recs, blocks, profile, dna)
+                               practices, design_recs, blocks, profile, dna,
+                               design_tokens=tokens, refinement=refinement)
     print(context)
 
 

package/assets/templates/generation-prompt.md

@@ -1,41 +1,96 @@
-# Generate Shopify Section: {{ name }}
+<role>
+You are an expert Shopify OS2.0 theme developer. Generate production-ready section .liquid files that follow Shopify best practices, are fully accessible, responsive, and theme-editor friendly.
+</role>
 
-## Description
-{{ description }}
-
-## Theme Context
-{{ theme_profile_summary }}
-
-## Closest Pattern Template
+<reference_components>
 {{ component_pattern_content }}
+</reference_components>
 
-## Relevant Schema Settings
+<schema_types>
 {{ schema_search_results }}
+</schema_types>
 
-## Recommended Settings Profile
-{{ settings_profile_results }}
-
-## Block Pattern References
+<block_patterns>
 {{ block_patterns_results }}
+</block_patterns>
 
-## Theme DNA
-{{ theme_dna_context }}
+<settings_profile>
+{{ settings_profile_results }}
+</settings_profile>
 
-## Applicable Best Practices
+<design_tokens>
+{{ design_tokens_results }}
+</design_tokens>
+
+<best_practices>
 {{ best_practices_results }}
+</best_practices>
+
+<theme_context>
+{{ theme_profile_summary }}
+</theme_context>
+
+<theme_dna>
+{{ theme_dna_context }}
+</theme_dna>
 
-## Design Recommendations
 {{ ui_ux_recommendations }}
 
-## Base Template
+<task>
+<name>{{ name }}</name>
+<description>{{ description }}</description>
+</task>
+
+<base_template>
 {{ section_base_content }}
+</base_template>
 
-## Requirements
+{{ refinement_context }}
+
+<mandatory_settings>
+CONDITIONAL RULES (apply based on section content):
+- IF section has heading or subheading text settings:
+  -> MUST include font_picker for primary heading
+  -> MUST include heading_tag (type: select, options: h1/h2/h3/h4) for SEO
+- ALWAYS include:
+  -> color_scheme (type: color_scheme) for theme-wide color customization
+  -> padding_top + padding_bottom (type: range, 0-100px, step 4)
+  -> All colors via CSS custom properties, NEVER hardcoded hex
+- IF section has CTA button:
+  -> Button settings: button_label, button_link, button_style
+</mandatory_settings>
+
+<pre_output_checklist>
+Before writing code, verify your plan includes ALL:
+- color_scheme setting in schema
+- font_picker for heading text (if section has headings)
+- heading_tag select (h1/h2/h3/h4) (if section has headings)
+- Padding/margin controls
+- presets array with at least one preset
+- @app block type
+- CSS: color + font-size set directly on h1-h6, p, a selectors (not just parent containers)
+- CSS: scoped via #section-{{ section.id }}
+- Images: loading="lazy" except hero; hero uses fetchpriority="high"
+- All block wrappers include {{ block.shopify_attributes }}
+- No hardcoded hex colors in CSS
+- Uses {% render %} not {% include %}
+</pre_output_checklist>
+
+<requirements>
 - OS2.0 compliant (presets, @app blocks, block.shopify_attributes)
 - Scoped CSS via #section-{{ section.id }}
-- Text element specificity: ALWAYS set `color` and `font-size` directly on text element selectors (h1-h6, p, a), not just parent containers. Shopify themes apply color directly to these elements via global CSS which overrides inheritance. Use `#section-{{ section.id }} .my-heading { color: var(--text-color); font-size: clamp(...); }` not just `.my-wrapper { color: var(--text-color); }`
+- Text element specificity: ALWAYS set color and font-size directly on text element selectors (h1-h6, p, a), not just parent containers
 - Responsive (mobile-first)
 - Accessible (semantic HTML, aria-labels, alt text)
 - Performance (lazy-load non-hero images, no Liquid in CSS/JS)
 - Use {% render %} not {% include %}
 - Include {{ block.shopify_attributes }} on ALL block wrappers
+</requirements>
+
+<output_format>
+Output ONLY the raw .liquid file content.
+Do not wrap in markdown code blocks.
+Do not add explanations before or after.
+Begin with the first line of the liquid file.
+End with the {% endschema %} tag.
+</output_format>

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rebly-sections",
-  "version": "1.1.0",
+  "version": "1.2.0",
   "description": "Shopify section AI coding skill installer for Claude Code and Antigravity Kit",
   "author": "Rebly Sections",
   "homepage": "https://github.com/rebly-sections/sections-ai#readme",