guidelines: compose guidelines more neatly

Author: ashleyhindle

src/Install/GuidelineComposer.php

@@ -35,8 +35,8 @@ public function config(GuidelineConfig $config): self
     public function compose(): string
     {
         return $this->guidelines()
-            ->map(fn ($content, $key) => "# {$key}\n{$content}\n")
-            ->join("\n\n====\n\n");
+            ->map(fn ($content, $key) => "\n=== {$key} ===\n\n{$content}")
+            ->join("\n\n");
     }
 
     /**

src/Install/GuidelineWriter.php

@@ -56,13 +56,15 @@ public function write(string $guidelines): int
                 $newContent = preg_replace($pattern, $replacement, $content, 1);
                 $replaced = true;
             } else {
-                // No existing guidelines found, append to end
+                // No existing Boost guidelines found, append to end of existing file
                 $frontMatter = '';
                 if ($this->agent->frontmatter() && ! str_contains($content, "\n---\n")) {
                     $frontMatter = "---\nalwaysApply: true\n---\n";
                 }
 
-                $newContent = $frontMatter.rtrim($content)."\n\n\n".$replacement;
+                $existingContent = rtrim($content);
+                $separatingNewlines = empty($existingContent) ? '' : "\n\n===\n\n";
+                $newContent = $frontMatter.$existingContent.$separatingNewlines.$replacement;
             }
 
             if (ftruncate($handle, 0) === false || fseek($handle, 0) === -1) {