From d5940856be60c3f08906d95d2480c99e6cc584f7 Mon Sep 17 00:00:00 2001
From: Eric Rakestraw <eric@rakestraw.us>
Date: Thu, 8 Oct 2026 16:23:26 +0000
Subject: [PATCH] Add native ReleaseKit bootstrap

---
 .gitignore                     |  4 +++-
 docs/release.md                | 12 ++++++++++++
 docs/roadmap/implementation.md |  3 ++-
 scripts/releasekit.sh          | 18 ++++++++++++++++++
 4 files changed, 35 insertions(+), 2 deletions(-)
 create mode 100755 scripts/releasekit.sh

diff --git a/.gitignore b/.gitignore
index 3dea460..f332b17 100644
--- a/.gitignore
+++ b/.gitignore
@@ -22,6 +22,9 @@
 go.work
 go.work.sum
 
+# Local ReleaseKit executable
+.releasekit/
+
 # env file
 .env
 
@@ -67,4 +70,3 @@ Icon
 Network Trash Folder
 Temporary Items
 .apdisk
-
diff --git a/docs/release.md b/docs/release.md
index 192c529..79af397 100644
--- a/docs/release.md
+++ b/docs/release.md
@@ -62,6 +62,18 @@ origin. No repeated release-specific diff review is required.
 
 ## Validate And Publish
 
+For an optional local diagnostic of a committed candidate, run:
+
+```sh
+./scripts/releasekit.sh check vMAJOR.MINOR.PATCH
+```
+
+The candidate must be committed on `main`, use a stable version, and include
+its version-matched release note. See the upstream
+[candidate check contract](https://gitea.maximumdirect.net/eric/ReleaseKit/src/tag/v0.2.0/docs/consumers/check.md)
+for its requirements. This diagnostic is optional and is not required before
+publication.
+
 Run the following with the chosen unused version (replace the placeholder):
 
 ```sh
diff --git a/docs/roadmap/implementation.md b/docs/roadmap/implementation.md
index 0cc1469..cbb96c4 100644
--- a/docs/roadmap/implementation.md
+++ b/docs/roadmap/implementation.md
@@ -7,7 +7,8 @@ owns the implementation steps; the roadmap owns purpose and selected policy.
 Status: Stage 1's tool selection and dependency preparation are complete in
 `3ca01ae`. The agreed series-based Go minimum supersedes the original patch-based
 requirement. Stage 2's example checker and shared validation profile are
-complete. Resume adoption at Stage 3 after this revision.
+complete in `0d163f8`. Stage 3's native tool bootstrap is complete. Resume
+adoption at Stage 4 after this revision.
 
 ## Baseline And Working Rules
 
diff --git a/scripts/releasekit.sh b/scripts/releasekit.sh
new file mode 100755
index 0000000..cf69258
--- /dev/null
+++ b/scripts/releasekit.sh
@@ -0,0 +1,18 @@
+#!/bin/sh
+set -eu
+
+cd "$(dirname "$0")/.."
+
+export GOTOOLCHAIN=local
+export GOWORK=off
+export GOFLAGS=-mod=readonly
+
+GOOS=$(go env GOHOSTOS)
+GOARCH=$(go env GOHOSTARCH)
+export GOOS GOARCH
+
+mkdir -p .releasekit/bin
+go build -mod=readonly -o .releasekit/bin/releasekit \
+	"gitea.maximumdirect.net/eric/ReleaseKit/cmd/releasekit"
+
+exec ./.releasekit/bin/releasekit "$@"