Add frontmatter requirements to docs and release notes

Introduces rules requiring frontmatter with description, keywords, and a social share image for all documentation and release notes. Updates examples and formatting standards to reflect this new requirement.

Author: hannesrudolph

.roo/rules-docs/2_docusaurus_conventions.xml

@@ -32,4 +32,22 @@
       <description>Do not include version numbers or phrases like "as of version X.Y" in general documentation. Version information belongs only in `docs/update-notes`.</description>
     </rule>
   </versioning>
+  <frontmatter>
+    <rule name="metadata">
+      <description>All pages must include frontmatter with description, keywords, and a social share image. The title will be automatically generated from the first H1 heading.</description>
+      <example>
+        <![CDATA[
+---
+description: A concise summary of the page content.
+keywords:
+  - relevant
+  - keywords
+  - for
+  - search
+image: /img/social-share.jpg
+---
+        ]]>
+      </example>
+    </rule>
+  </frontmatter>
 </docusaurus_conventions>

.roo/rules-release-notes-writer/2_formatting_standards.xml

@@ -19,6 +19,21 @@
   </file_naming_conventions>
 
   <file_structure>
+    <element name="frontmatter">
+      <description>All release notes must include frontmatter with a description, keywords, and a social share image. The title is generated automatically from the first H1 heading.</description>
+      <example>
+        <![CDATA[
+---
+description: A concise summary of the release.
+keywords:
+  - roo code x.y.z
+  - new features
+  - bug fixes
+image: /img/social-share.jpg
+---
+        ]]>
+      </example>
+    </element>
     <element name="title">
       <format># Roo Code X.Y.Z Release Notes (YYYY-MM-DD)</format>
       <requirements>

.roo/rules-release-notes-writer/5_complete_example.xml

@@ -138,6 +138,14 @@ Use update_todo_list to track your progress through these steps.
 <write_to_file>
 <path>docs/update-notes/v3.20.3.mdx</path>
 <content>
+---
+description: This release improves reliability and fixes large file handling.
+keywords:
+  - roo code 3.20.3
+  - reliability
+  - large file handling
+image: /img/social-share.jpg
+---
 # Roo Code 3.20.3 Release Notes (2025-01-13)
 
 This release improves reliability and fixes large file handling.
@@ -149,24 +157,4 @@ This release improves reliability and fixes large file handling.
 
 ## Provider Updates
 
-* **OpenAI**: Added support for new GPT-4 models (thanks provider-dev!) ([#1236](link))
-</content>
-<line_count>11</line_count>
-</write_to_file>
-      ]]></tool_use>
-      <note>Acknowledgments include PR author and issue reporter where applicable.</note>
-    </step>
-  </workflow>
-
-  <key_improvements>
-    <improvement>
-      <description>Subtask-based processing organizes the workflow and isolates errors.</description>
-    </improvement>
-    <improvement>
-      <description>Workflow extracts linked issues to acknowledge all contributors.</description>
-    </improvement>
-    <improvement>
-      <description>Subtasks write findings to a temp file, ensuring no data loss.</description>
-    </improvement>
-  </key_improvements>
-</complete_example>
+* **OpenAI**: Added support for new GPT-4 models (thanks provider-dev!) ([#1236](link))