From 755ac965be9257094a998017fcc70f6c3057b261 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]"
 <41898282+github-actions[bot]@users.noreply.github.com>
Date: Thu, 4 Jun 2026 10:07:47 +0000
Subject: [PATCH] docs(site): document export-gate-schema hidden build-time
 command

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 site/src/content/docs/setup/cli.mdx | 24 ++++++++++++++++++++++++
 1 file changed, 24 insertions(+)

diff --git a/site/src/content/docs/setup/cli.mdx b/site/src/content/docs/setup/cli.mdx
index cd9675ea..848408a1 100644
--- a/site/src/content/docs/setup/cli.mdx
+++ b/site/src/content/docs/setup/cli.mdx
@@ -274,6 +274,30 @@ Options:
 - `--ado-project <name>` -- Azure DevOps project name override
 - `--dry-run` -- validate inputs without making write calls
 
+## Internal / build-time tools
+
+These commands are hidden from `--help` and are intended for contributors working on the ado-aw compiler itself — not for end users or compiled pipelines.
+
+### `export-gate-schema`
+
+Export the gate spec JSON Schema used by the `scripts/ado-script` TypeScript workspace for type code generation. Outputs JSON to stdout or to a file.
+
+```bash
+ado-aw export-gate-schema [--output <path>]
+```
+
+Options:
+
+- `--output`, `-o <path>` -- write the schema to a file instead of stdout; parent directories are created automatically
+
+Typical use (from the repo root):
+
+```bash
+cargo run -- export-gate-schema --output scripts/ado-script/schema/gate-spec.schema.json
+```
+
+See the [ado-script reference](/ado-aw/reference/ado-script/) for how this command fits into the TypeScript type-codegen workflow.
+
 ## Deprecated commands
 
 ### `configure` (deprecated alias)