From df42ac979412c3dcf0528ef43b236ee5ef254fd7 Mon Sep 17 00:00:00 2001
From: Claude <noreply@anthropic.com>
Date: Fri, 16 Jan 2026 23:41:10 +0000
Subject: [PATCH] Consolidate doc/platform/ into doc/platforms/

Merged the separate platform and platforms documentation directories
into a single doc/platforms/ folder. Moved hooks.md and learnings.md
files for both Claude and Gemini platforms, updated the README with
the new structure, and fixed references in architecture.md and
CHANGELOG.md.
---
 CHANGELOG.md                                    |  2 +-
 doc/architecture.md                             |  2 +-
 doc/{platform => platforms}/README.md           | 17 ++++++++++-------
 doc/{platform => platforms}/claude/hooks.md     |  0
 doc/{platform => platforms}/claude/learnings.md |  0
 doc/{platform => platforms}/gemini/hooks.md     |  0
 doc/{platform => platforms}/gemini/learnings.md |  0
 7 files changed, 12 insertions(+), 9 deletions(-)
 rename doc/{platform => platforms}/README.md (73%)
 rename doc/{platform => platforms}/claude/hooks.md (100%)
 rename doc/{platform => platforms}/claude/learnings.md (100%)
 rename doc/{platform => platforms}/gemini/hooks.md (100%)
 rename doc/{platform => platforms}/gemini/learnings.md (100%)

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