diff --git a/CHANGELOG.md b/CHANGELOG.md
index 79ba35e8..2fb45116 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -12,7 +12,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
   - `wrapper.py`: Normalizes input/output between Claude Code and Gemini CLI
   - `claude_hook.sh` and `gemini_hook.sh`: Platform-specific shell wrappers
   - `policy_check.py`: Cross-platform policy evaluation hook
-- Platform documentation in `doc/platform/` and `doc/platforms/` with hook references and learnings
+- Platform documentation in `doc/platforms/` with hook references and learnings
 - Claude Code platform documentation (`doc/platforms/claude/`)
 - `update.job` for maintaining standard jobs (#41)
 - `make_new_job.sh` script and templates directory for job scaffolding (#37)
diff --git a/doc/architecture.md b/doc/architecture.md
index 33ac9733..6ddf971c 100644
--- a/doc/architecture.md
+++ b/doc/architecture.md
@@ -1116,7 +1116,7 @@ def my_hook(input: HookInput) -> HookOutput:
 # Called via: claude_hook.sh mymodule or gemini_hook.sh mymodule
 ```
 
-See `doc/platform/` for detailed platform-specific hook documentation.
+See `doc/platforms/` for detailed platform-specific hook documentation.
 
 ### Policy Schema
 
diff --git a/doc/platform/README.md b/doc/platforms/README.md
similarity index 73%
rename from doc/platform/README.md
rename to doc/platforms/README.md
index 6ae8b4c5..a8a52a05 100644
--- a/doc/platform/README.md
+++ b/doc/platforms/README.md
@@ -24,14 +24,18 @@ When you discover something about how a platform behaves that isn't obvious from
 ## Directory Structure
 
 ```
-doc/platform/
-├── README.md           # This file
+doc/platforms/
+├── README.md               # This file
 ├── claude/
-│   ├── hooks.md        # Claude Code hooks system documentation
-│   └── learnings.md    # Discovered behaviors and quirks
+│   ├── cli_configuration.md  # Claude Code CLI configuration
+│   ├── hooks.md              # Claude Code hooks system (input/output schemas)
+│   ├── hooks_system.md       # Command-level hook support
+│   └── learnings.md          # Discovered behaviors and quirks
 └── gemini/
-    ├── hooks.md        # Gemini CLI hooks system documentation
-    └── learnings.md    # Discovered behaviors and quirks
+    ├── cli_configuration.md  # Gemini CLI configuration
+    ├── hooks.md              # Gemini CLI hooks system (input/output schemas)
+    ├── hooks_system.md       # Command-level hook limitations
+    └── learnings.md          # Discovered behaviors and quirks
 ```
 
 ## Platform Comparison Summary
@@ -51,4 +55,3 @@ doc/platform/
 
 - `src/deepwork/core/adapters.py` - Platform adapter implementations
 - `src/deepwork/hooks/` - Hook wrapper scripts
-- `doc/platforms/` - External platform documentation (configuration, commands)
diff --git a/doc/platform/claude/hooks.md b/doc/platforms/claude/hooks.md
similarity index 100%
rename from doc/platform/claude/hooks.md
rename to doc/platforms/claude/hooks.md
diff --git a/doc/platform/claude/learnings.md b/doc/platforms/claude/learnings.md
similarity index 100%
rename from doc/platform/claude/learnings.md
rename to doc/platforms/claude/learnings.md
diff --git a/doc/platform/gemini/hooks.md b/doc/platforms/gemini/hooks.md
similarity index 100%
rename from doc/platform/gemini/hooks.md
rename to doc/platforms/gemini/hooks.md
diff --git a/doc/platform/gemini/learnings.md b/doc/platforms/gemini/learnings.md
similarity index 100%
rename from doc/platform/gemini/learnings.md
rename to doc/platforms/gemini/learnings.md