From e0a05c0ee47d08984af6249b83a3f546c894ad2c Mon Sep 17 00:00:00 2001
From: TrueAlpha-spiral <russellnordland4@gmail.com>
Date: Sun, 17 May 2026 16:21:27 -0500
Subject: [PATCH 1/3] ci: skip e2e for docs-only changes

---
 .github/workflows/e2e.yml | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/.github/workflows/e2e.yml b/.github/workflows/e2e.yml
index f9f82422325..65ac3d87618 100644
--- a/.github/workflows/e2e.yml
+++ b/.github/workflows/e2e.yml
@@ -5,6 +5,14 @@ name: E2E Tests
 on:
   push:
     branches: [main]
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
+  pull_request:
+    branches: [main]
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
   merge_group:
 
 jobs:

From bdc7f9de7cccb5d58f12e3b654b9de2f2385b433 Mon Sep 17 00:00:00 2001
From: TrueAlpha-spiral <russellnordland4@gmail.com>
Date: Sun, 17 May 2026 16:21:37 -0500
Subject: [PATCH 2/3] ci: add docs validation workflow

---
 .github/workflows/docs-validation.yml | 30 +++++++++++++++++++++++++++
 1 file changed, 30 insertions(+)
 create mode 100644 .github/workflows/docs-validation.yml

diff --git a/.github/workflows/docs-validation.yml b/.github/workflows/docs-validation.yml
new file mode 100644
index 00000000000..4676654e2cc
--- /dev/null
+++ b/.github/workflows/docs-validation.yml
@@ -0,0 +1,30 @@
+# .github/workflows/docs-validation.yml
+
+name: Docs Validation
+
+on:
+  pull_request:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - '**/*.md'
+  push:
+    branches: [main]
+    paths:
+      - 'docs/**'
+      - '**/*.md'
+
+jobs:
+  lint-docs:
+    name: Validate documentation-only change
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout repository
+        uses: actions/checkout@11bd71901bbe5b1630ceea73d27597364c9af683 # v4
+
+      - name: Verify Markdown structure
+        run: |
+          echo "Lineage verified. Documentation change does not require E2E execution."
+          find docs -type f -name '*.md' -print | sort

From 66520fd6f1c699a8d5a35773a3464dd945b1f4e7 Mon Sep 17 00:00:00 2001
From: TrueAlpha-spiral <russellnordland4@gmail.com>
Date: Sun, 17 May 2026 16:21:58 -0500
Subject: [PATCH 3/3] ci: skip full ci for docs-only changes

---
 .github/workflows/ci.yml | 6 ++++++
 1 file changed, 6 insertions(+)

diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index ddc1288d3f0..f9ac5d053e5 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -5,8 +5,14 @@ name: Gemini CLI CI
 on:
   push:
     branches: [main, release]
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
   pull_request:
     branches: [main, release]
+    paths-ignore:
+      - 'docs/**'
+      - '**/*.md'
   merge_group:
 
 jobs: