diff --git a/CLAUDE.md b/CLAUDE.md
index fd7751574..c62f44508 100644
--- a/CLAUDE.md
+++ b/CLAUDE.md
@@ -132,6 +132,14 @@ tea pr create \
   --head branch-name
 ```
 
+### Large content pushes (team pattern)
+When producing many files (wiki pages, content batches, bulk docs):
+1. **Lore librarian** agent (read-only): ingests all source material, answers focused context queries from writers, tracks cross-file consistency
+2. **Multiple writer** agents (parallel, by domain): each gets a task slice, writes directly to disk using the Write tool — one file at a time, write often, no text accumulation
+3. **Reviewer** agents (blocked until writing done): check voice consistency, attribute uniformity, style
+
+Key: writers use Write tool directly (no transcription bottleneck), librarian catches contradictions early, split work by domain not volume.
+
 ### Local services
 - Gitea: `http://git.schweitz.internal` (login: `schweitz`)
 - Qdrant: `http://tower-of-joy:6333/`