diff --git a/.github/aw/cli-commands.md b/.github/aw/cli-commands.md
index 840933e1332..d2be43fca8d 100644
--- a/.github/aw/cli-commands.md
+++ b/.github/aw/cli-commands.md
@@ -140,6 +140,21 @@ gh aw checks <run-id>
 
 ---
 
+### `gh aw experiments`
+
+Inspect experiment state tracked in `experiments/*` branches. Default behavior matches `experiments list`; use `experiments analyze` for per-workflow statistics. All subcommands accept `--repo/-r` and `--json/-j`.
+
+```bash
+gh aw experiments                             # List experiment workflow branches
+gh aw experiments list --json                 # List all experiments as JSON
+gh aw experiments analyze <workflow>          # Analyze one experiment workflow
+gh aw experiments analyze <workflow> --repo owner/repo  # Analyze in another repository
+```
+
+**MCP equivalent**: Not available — run from a local terminal.
+
+---
+
 ### `gh aw fix`
 
 Apply automatic codemods to fix deprecated fields in workflow files.
@@ -269,6 +284,7 @@ gh aw mcp list                                   # List workflows with MCP serve
 | `gh aw audit` | `audit` |
 | `gh aw audit <id1> <id2>` | `audit-diff` |
 | `gh aw checks` | `checks` |
+| `gh aw experiments` | *(local only)* |
 | `gh aw mcp inspect` | `mcp-inspect` |
 | `gh aw add` | `add` |
 | `gh aw update` | `update` |
diff --git a/.github/aw/messages.md b/.github/aw/messages.md
index d288e67804f..bb38a9372ef 100644
--- a/.github/aw/messages.md
+++ b/.github/aw/messages.md
@@ -51,6 +51,15 @@ Emoji by domain: 🔍 search · 📐 architecture · 🔬 analysis/security · 
 | `staged-title` | `{operation}` | `🎭 Preview: {operation}` |
 | `staged-description` | `{operation}` | `The following {operation} would occur if staged mode was disabled:` |
 
+### Body headers (prepended to every AI-generated message body)
+
+| Key | Variables | Default |
+|-----|-----------|---------|
+| `disclosure-header` | `{workflow_name}`, `{run_url}` | *(off)* — set `true` for built-in AI-authorship disclosure text, or provide a custom string |
+| `body-header` | `{workflow_name}`, `{run_url}` | *(off)* — custom header text prepended to every body |
+
+Insertion order, top to bottom: threat-detection caution alert → `disclosure-header` → `body-header` → agent-generated content. Applies to issues, comments, pull requests, and discussions.
+
 ### Boolean options
 
 | Key | Default | Description |