From a64bdc6fd448a81ccae18561e05978e39066c676 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 25 Aug 2026 13:44:38 +0000
Subject: [PATCH 1/2] Initial plan


From 9647d740f83272d7af609d91bb5d05f69fb394c4 Mon Sep 17 00:00:00 2001
From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com>
Date: Tue, 25 Aug 2026 13:46:38 +0000
Subject: [PATCH 2/2] Align development prerequisite documentation

Co-authored-by: v1v <2871786+v1v@users.noreply.github.com>
---
 DEVELOPING.md      | 4 +++-
 docs/developing.md | 7 +++++--
 2 files changed, 8 insertions(+), 3 deletions(-)

diff --git a/DEVELOPING.md b/DEVELOPING.md
index a0cbbae8..c592b3d0 100644
--- a/DEVELOPING.md
+++ b/DEVELOPING.md
@@ -1,5 +1,7 @@
 # Development Guide
 
+This page is the source of truth for repository prerequisites. See the [docs-site Developing guide](docs/developing.md) for the equivalent onboarding page.
+
 ## Repository Structure
 
 | Directory | What | Docs |
@@ -16,7 +18,7 @@ Internal-only workflows (e.g., `upgrade-check.md`, `workflow-patrol.md`, `ci.yml
 - [GitHub CLI (`gh`)](https://cli.github.com/) — installed automatically by `make setup` on Linux, but must be pre-installed on macOS
 - `curl` or `wget` — used to download the official gh-aw release compiler binary
 
-Verify with:
+If building the compiler from source, verify Go with:
 
 ```bash
 go version
diff --git a/docs/developing.md b/docs/developing.md
index c326eae1..49850897 100644
--- a/docs/developing.md
+++ b/docs/developing.md
@@ -1,5 +1,7 @@
 # Developing
 
+> This page mirrors the repository [Development Guide](https://github.com/elastic/ai-github-actions/blob/main/DEVELOPING.md), which is the source of truth for prerequisites.
+
 ## Repository structure
 
 | Directory | What | Docs |
@@ -12,10 +14,11 @@ Internal-only workflows (e.g., `upgrade-check.md`, `workflow-patrol.md`, `ci.yml
 
 ## Prerequisites
 
-- [Go](https://go.dev/dl/) — required by `make setup` to build the `gh-aw` compiler
+- [Go](https://go.dev/dl/) — optional; only needed for non-release gh-aw compiler builds
 - [GitHub CLI (`gh`)](https://cli.github.com/) — installed automatically by `make setup` on Linux, but must be pre-installed on macOS
+- `curl` or `wget` — used to download the official gh-aw release compiler binary
 
-Verify with:
+If building the compiler from source, verify Go with:
 
 ```bash
 go version