Clarify lock files and trigger files are auto-generated; add do-not-modify headers

.github/workflows/trigger-agent-suggestions.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/agent-suggestions/example.yml and run 'make compile' to regenerate.
 name: Trigger Agent Suggestions
 on:
   schedule:

.github/workflows/trigger-breaking-change-detector.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/breaking-change-detector/example.yml and run 'make compile' to regenerate.
 name: Trigger Breaking Change Detector
 on:
   schedule:

.github/workflows/trigger-bug-exterminator.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/bug-exterminator/example.yml and run 'make compile' to regenerate.
 name: Trigger Bug Exterminator
 on:
   schedule:

.github/workflows/trigger-bug-hunter.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/bug-hunter/example.yml and run 'make compile' to regenerate.
 name: Trigger Bug Hunter
 on:
   schedule:

.github/workflows/trigger-code-duplication-detector.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/code-duplication-detector/example.yml and run 'make compile' to regenerate.
 name: Trigger Code Duplication Detector
 on:
   schedule:

.github/workflows/trigger-code-duplication-fixer.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/code-duplication-fixer/example.yml and run 'make compile' to regenerate.
 name: Trigger Code Duplication Fixer
 on:
   schedule:

.github/workflows/trigger-code-simplifier.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/code-simplifier/example.yml and run 'make compile' to regenerate.
 name: Trigger Code Simplifier
 on:
   schedule:

.github/workflows/trigger-docs-patrol.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/docs-patrol/example.yml and run 'make compile' to regenerate.
 name: Trigger Docs Patrol
 on:
   schedule:

.github/workflows/trigger-docs-pr-review.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/docs-pr-review/example.yml and run 'make compile' to regenerate.
 name: Trigger Docs PR Review
 on:
   issue_comment:

.github/workflows/trigger-downstream-health.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/downstream-health/example.yml and run 'make compile' to regenerate.
 name: Trigger Downstream Health
 on:
   schedule:

.github/workflows/trigger-duplicate-issue-detector.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/duplicate-issue-detector/example.yml and run 'make compile' to regenerate.
 name: Trigger Duplicate Issue Detector
 on:
   issues:

.github/workflows/trigger-issue-triage.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/issue-triage/example.yml and run 'make compile' to regenerate.
 name: Trigger Issue Triage
 on:
   issues:

.github/workflows/trigger-mention-in-issue.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/mention-in-issue/example.yml and run 'make compile' to regenerate.
 name: Trigger Mention in Issue
 on:
   issue_comment:

.github/workflows/trigger-mention-in-pr.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/mention-in-pr/example.yml and run 'make compile' to regenerate.
 name: Trigger Mention in PR
 on:
   issue_comment:

.github/workflows/trigger-newbie-contributor-fixer.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/newbie-contributor-fixer/example.yml and run 'make compile' to regenerate.
 name: Trigger Newbie Contributor Fixer
 on:
   schedule:

.github/workflows/trigger-newbie-contributor-patrol.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/newbie-contributor-patrol/example.yml and run 'make compile' to regenerate.
 name: Trigger Newbie Contributor Patrol
 on:
   schedule:

.github/workflows/trigger-plan.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/plan/example.yml and run 'make compile' to regenerate.
 name: Trigger Plan
 on:
   issue_comment:

.github/workflows/trigger-pr-actions-detective.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/pr-actions-detective/example.yml and run 'make compile' to regenerate.
 name: Trigger PR Actions Detective
 on:
   workflow_run:

.github/workflows/trigger-pr-actions-fixer.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/pr-actions-fixer/example.yml and run 'make compile' to regenerate.
 name: Trigger PR Actions Fixer
 on:
   workflow_dispatch:

.github/workflows/trigger-pr-buildkite-detective.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/pr-buildkite-detective/example.yml and run 'make compile' to regenerate.
 name: Trigger PR Buildkite Detective
 on:
   workflow_run:

.github/workflows/trigger-pr-review.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/pr-review/example.yml and run 'make compile' to regenerate.
 name: Trigger PR Review
 on:
   pull_request:

.github/workflows/trigger-project-summary.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/project-summary/example.yml and run 'make compile' to regenerate.
 name: Trigger Project Summary
 on:
   schedule:

.github/workflows/trigger-release-update.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/release-update/example.yml and run 'make compile' to regenerate.
 name: Trigger Release Update Check
 on:
   schedule:

.github/workflows/trigger-small-problem-fixer.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/small-problem-fixer/example.yml and run 'make compile' to regenerate.
 name: Trigger Small Problem Fixer
 on:
   schedule:

.github/workflows/trigger-stale-issues.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/stale-issues/example.yml and run 'make compile' to regenerate.
 name: Trigger Stale Issues
 on:
   schedule:

.github/workflows/trigger-test-improver.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/test-improver/example.yml and run 'make compile' to regenerate.
 name: Trigger Test Improver
 on:
   schedule:

.github/workflows/trigger-text-auditor.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/text-auditor/example.yml and run 'make compile' to regenerate.
 name: Trigger Text Auditor
 on:
   schedule:

.github/workflows/trigger-text-beautifier.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/text-beautifier/example.yml and run 'make compile' to regenerate.
 name: Trigger Text Beautifier
 on:
   schedule:

.github/workflows/trigger-update-pr-body.yml

@@ -1,3 +1,5 @@
+# This file is auto-generated by scripts/dogfood.sh. Do not edit directly.
+# Edit gh-agent-workflows/update-pr-body/example.yml and run 'make compile' to regenerate.
 name: Trigger Update PR Body
 on:
   pull_request:

gh-agent-workflows/DEVELOPING.md

@@ -142,7 +142,9 @@ Trigger `example.yml` files are copied from `gh-agent-workflows/*/` by `scripts/
 1. Edit workflows in `.github/workflows/gh-aw-*.md`, triggers in `gh-agent-workflows/*/example.yml`, or fragments in `.github/workflows/gh-aw-fragments/`
 2. Run `make compile` (syncs triggers, then compiles)
 3. Verify 0 errors, 0 warnings
-4. Commit all source files, trigger files, and generated `.lock.yml` files
+4. Commit source files (`gh-aw-*.md`, `example.yml`, fragments) and the generated `.lock.yml` and `trigger-*.yml` files
+
+> **Do not edit `.lock.yml` files directly.** They are compiled output generated by `make compile` from the corresponding `.md` workflow source. Any manual edits will be overwritten on the next compile.
 
 ```bash
 make compile          # sync + compile
@@ -198,6 +200,8 @@ Consumer repos call the compiled `.lock.yml` via `uses:` in a plain YAML workflo
 
 Each non-internal workflow has a corresponding `example.yml` in `gh-agent-workflows/<name>/` that defines the actual event triggers and calls the compiled `.lock.yml`. These are plain YAML (not compiled by gh-aw) and are copied to `.github/workflows/trigger-<name>.yml` by `scripts/dogfood.sh` for dogfooding when the workflow is not listed in `EXCLUDED_WORKFLOWS` (see `scripts/dogfood.sh` for the current list).
 
+> **Do not edit `trigger-*.yml` files directly.** They are auto-generated by `scripts/dogfood.sh` (run via `make compile`) and any manual changes will be overwritten. To change a trigger, edit `gh-agent-workflows/<name>/example.yml` (or `dogfood-with.yml` for dogfood-only overrides) and run `make compile`.
+
 Consumer repos copy a workflow's `example.yml` into their `.github/workflows/` directory and customize the `with:` inputs. The `uses:` path already points to the remote compiled workflow.
 
 ### Dogfood overrides

scripts/dogfood.sh

@@ -46,8 +46,11 @@ for f in gh-agent-workflows/*/example.yml; do
     continue
   fi
   target=".github/workflows/trigger-$dir.yml"
-  sed 's|uses: elastic/ai-github-actions/\(.*\)@v0|uses: ./\1|; s|^name: |name: Trigger |' "$f" \
-    > "$target"
+  {
+    echo "# This file is auto-generated by scripts/dogfood.sh. Do not edit directly."
+    echo "# Edit gh-agent-workflows/$dir/example.yml and run 'make compile' to regenerate."
+    sed 's|uses: elastic/ai-github-actions/\(.*\)@v0|uses: ./\1|; s|^name: |name: Trigger |' "$f"
+  } > "$target"
 
   # Inject dogfood-with.yml overrides into the generated trigger.
   overrides="gh-agent-workflows/$dir/dogfood-with.yml"