diff --git a/.claude/commands/docs/write-comments.md b/.claude/commands/docs/write-comments.md
index 4769d8375..1e4d1d4dc 100644
--- a/.claude/commands/docs/write-comments.md
+++ b/.claude/commands/docs/write-comments.md
@@ -8,7 +8,7 @@ Accepts either:
 
 ## Task
 
-Following the guidelines in `internal/documentation/`:
+Following the guidelines in `internal/documentation/comments/`:
 
 1. **Determine documentation type:**
    - For Config, Input, Output classes → Use `doc-comments-external.md` (user-facing, thorough)
diff --git a/internal/documentation/architectural-notes.md b/internal/documentation/comments/architectural-notes.md
similarity index 100%
rename from internal/documentation/architectural-notes.md
rename to internal/documentation/comments/architectural-notes.md
diff --git a/internal/documentation/doc-comments-external.md b/internal/documentation/comments/doc-comments-external.md
similarity index 100%
rename from internal/documentation/doc-comments-external.md
rename to internal/documentation/comments/doc-comments-external.md
diff --git a/internal/documentation/doc-comments-internal.md b/internal/documentation/comments/doc-comments-internal.md
similarity index 100%
rename from internal/documentation/doc-comments-internal.md
rename to internal/documentation/comments/doc-comments-internal.md
diff --git a/internal/documentation/doc-comments.md b/internal/documentation/comments/doc-comments.md
similarity index 100%
rename from internal/documentation/doc-comments.md
rename to internal/documentation/comments/doc-comments.md