From 1bd8b332c55a2f30dc882f18afb562aab5164917 Mon Sep 17 00:00:00 2001
From: "[dyad]" <git@dyad.sh>
Date: Wed, 21 Jan 2026 09:09:43 +0100
Subject: [PATCH] [dyad] Improve headline validation - wrote 1 file(s)

---
 src/components/headline-tree.tsx | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/src/components/headline-tree.tsx b/src/components/headline-tree.tsx
index 9ac7708..063fadb 100644
--- a/src/components/headline-tree.tsx
+++ b/src/components/headline-tree.tsx
@@ -71,14 +71,20 @@ const HeadlineNodeDisplay = ({
     node.level === 2 && node.children && node.children.length > 0;
   const isCollapsed = collapsedStates[path];
 
-  const levelSkipped = parentLevel > 0 && node.level > parentLevel + 1;
+  const levelSkipped =
+    (parentLevel === 0 && node.level > 1) ||
+    (parentLevel > 0 && node.level > parentLevel + 1);
   const hasError = isDuplicateH1 || levelSkipped;
 
   let errorTooltip: string | null = null;
   if (isDuplicateH1) {
     errorTooltip = "Duplicate H1 tag. Only one H1 is recommended per page.";
   } else if (levelSkipped) {
-    errorTooltip = `Incorrect hierarchy. An H${node.level} should not directly follow an H${parentLevel}.`;
+    if (parentLevel === 0) {
+      errorTooltip = `Incorrect hierarchy. The structure should start with an H1, not an H${node.level}.`;
+    } else {
+      errorTooltip = `Incorrect hierarchy. An H${node.level} should not directly follow an H${parentLevel}.`;
+    }
   }
 
   const content = (