Added the draft handover and skipped builds for documentation-only changes (#1094)

.github/pull_request_template.md

@@ -4,6 +4,9 @@ https://github.com/MindWorkAI/AI-Studio/blob/main/CONTRIBUTING.md
 
 Please also enable "Allow edits by maintainers" for this pull request. An automated check verifies
 this option together with the required statements below.
+
+Open this pull request as a draft while you are still working on it, and mark it ready for review
+once it is done: that is our signal to take over. The automated check waits until then.
 -->
 
 ## Summary

.github/scripts/contribution-gate.sh

@@ -187,8 +187,9 @@ check_one() {
   local failing_since
   failing_since=$(sed -nE 's/^<!-- failing-since: ([0-9TZ:-]+) -->$/\1/p' <<< "$comment_body" | head -n 1)
 
-  # A pull request which a maintainer reopened gets a new grace period.
-  if [ "$EVENT_ACTION" = "reopened" ]; then
+  # A pull request which a maintainer reopened, or which its author marked ready for review again,
+  # gets a new grace period. Otherwise, the period would run on while the pull request is a draft.
+  if [ "$EVENT_ACTION" = "reopened" ] || [ "$EVENT_ACTION" = "ready_for_review" ]; then
     failing_since=""
   fi
 

.github/workflows/build-and-release.yml

@@ -5,12 +5,34 @@ on:
       - main
     tags:
       - "v*.*.*"
+
+    # Changes which touch only these files start neither a build nor the quality gate: none of them is
+    # compiled or shipped, so there is nothing to check. GitHub never applies path filters to tags, so
+    # a release always builds. The list names each file and folder instead of matching all Markdown
+    # files: the changelogs below wwwroot are Markdown as well, and the app embeds them.
+    paths-ignore: &documentation_only
+      - "README.md"
+      - "CONTRIBUTING.md"
+      - "CODE_OF_CONDUCT.md"
+      - "SECURITY.md"
+      - "CITATION.cff"
+      - "**/AGENTS.md"
+      - "**/CLAUDE.md"
+      - ".junie/**"
+      - "documentation/**"
+      - "media/**"
+      - "tests/**/*.md"
+      - ".github/ISSUE_TEMPLATE/**"
+      - ".github/DISCUSSION_TEMPLATE/**"
+      - ".github/pull_request_template.md"
+      - ".github/FUNDING.yml"
   pull_request:
     types:
       - opened
       - labeled
       - synchronize
       - reopened
+    paths-ignore: *documentation_only
 
 concurrency:
   group: ${{ github.workflow }}-${{ github.event_name == 'pull_request' && (github.event.action != 'labeled' || github.event.label.name == 'run-pipeline') && github.event.pull_request.number || github.run_id }}
@@ -746,7 +768,8 @@ jobs:
   # The quality gate. Deliberately without an `if` on build_enabled: a pull request only builds
   # when somebody sets the run-pipeline label, and a gate which is closed exactly while nobody is
   # looking is not a gate. It is cheap for the same reason it is unconditional -- one platform, no
-  # Tauri bundle, no signing, no artifacts.
+  # Tauri bundle, no signing, no artifacts. Only changes which touch nothing but documentation skip
+  # it, together with the whole workflow (see paths-ignore at the top): there is nothing to check.
   #
   verify:
     name: Verify

.github/workflows/contribution-gate.yml

@@ -7,6 +7,7 @@ on:
       - reopened
       - synchronize
       - ready_for_review
+      - converted_to_draft
   schedule:
     - cron: "17 4 * * *"
   workflow_dispatch: