From c30e15336bd8ce21808e9e3635213b71be1b2633 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Krzysztof=20Cie=C5=9Blak?= <krzysztof-cieslak@github.com>
Date: Wed, 13 Aug 2025 12:29:31 +0200
Subject: [PATCH] Small docs fixes

---
 docs/commands.md | 6 ------
 docs/secrets.md  | 8 ++++++++
 docs/tools.md    | 9 +++++----
 3 files changed, 13 insertions(+), 10 deletions(-)

diff --git a/docs/commands.md b/docs/commands.md
index 9e51e5042e4..b1cc3442bb9 100644
--- a/docs/commands.md
+++ b/docs/commands.md
@@ -204,12 +204,6 @@ gh aw list --packages --local
 - **Local Storage**: Local packages are stored in `.aw/packages/org/repo/` directory structure
 - **Flexible Installation**: Choose between global (shared across projects) or local (project-specific) installations
 
-**Note**: The `disable`, `enable`, and `status` commands require:
-
-- GitHub CLI (`gh`) to be installed and authenticated
-- The command to be run from within a git repository
-- The workflows to be already updated (`.lock.yml` files must exist)
-
 **Package Installation Requirements:**
 
 - GitHub CLI (`gh`) to be installed and authenticated with access to the target repository
diff --git a/docs/secrets.md b/docs/secrets.md
index 1740caf090f..63cd32bf22b 100644
--- a/docs/secrets.md
+++ b/docs/secrets.md
@@ -17,6 +17,9 @@ permissions:
   contents: read     # GITHUB_TOKEN gets content read access
 ```
 
+## User-Defined Secrets
+You need to define custom secrets in your repository or organization settings to enable usage of your chosen agentic processor. These secrets will be referenced in generated workflows.
+
 ### `ANTHROPIC_API_KEY`
 - **Purpose**: Claude engine access
 - **Required for**: `engine: claude` workflows
@@ -27,6 +30,11 @@ permissions:
 - **Required for**: `engine: codex` workflows
 - **Setup**: Add to repository or organization secrets
 
+### `GEMINI_API_KEY`
+- **Purpose**: Gemini engine access
+- **Required for**: `engine: gemini` workflows
+- **Setup**: Add to repository or organization secrets
+
 ## Related Documentation
 
 - [Commands](commands.md) - CLI commands for workflow management
diff --git a/docs/tools.md b/docs/tools.md
index 20471db5b92..92dca394da8 100644
--- a/docs/tools.md
+++ b/docs/tools.md
@@ -131,10 +131,11 @@ tools:
 - ❌ Claude-specific tools (ignored)
 - ✅ Custom MCP tools (stdio only, see [MCP Guide](mcps.md))
 
-### Other Engines
-- ✅ GitHub tools (varies by engine)
-- ❌ Claude-specific tools
-- Varies: Custom MCP tools (see [MCP Guide](mcps.md))
+### Gemini Engine
+- ✅ GitHub tools (native support)
+- ❌ Claude-specific tools (ignored)
+- ❌ Custom MCP tools (ignored)
+
 
 ## Security Considerations