BenjaminBriggs · dave-89 · Apr 6, 2026
diff --git a/cogitator/SKILL.md → SKILL.md b/cogitator/SKILL.md → SKILL.md
@@ -36,13 +36,14 @@ global/
 
 factions/
 └── <faction-slug>/
-    ├── <faction-slug>.md        — Army rules, faction ability, detachment list, datasheet index
-    ├── datasheets/
-    │   └── <unit-name>.md       — Full datasheet per unit
-    └── detachments/
-        └── <detachment-name>.md — Detachment ability, stratagems, enhancements
+    ├── <faction-slug>.md        — Army rules, faction ability, detachment list, datasheet summary
+    ├── datasheets.md            — Full datasheets for the faction in a single file
+    └── detachments.md           — Full detachments for the faction in a single file
 ```
 
+> Note: datasheets and detachments are stored in two aggregated faction files, not individual unit or detachment files.
+> Use the index to find the right entry, then read that single faction file.
+
 ## Faction directory
 
 | Faction | Slug | Datasheets | Detachments |
@@ -97,7 +98,7 @@ grep -i "gladius" factions/index.md
 grep -i "battleline" factions/index.md | grep -i "space-marines"
 ```
 
-The index is ~1,700 lines — always grep it, never read it in full.
+The index is ~1,700 lines — always grep it, never read it in full. For datasheets, the index will point you to the faction’s single `factions/<faction-slug>/datasheets.md` file.
 
 ### Finding an army rule or faction ability
 
@@ -118,7 +119,7 @@ Read `global/universal-stratagems.md`.
 
 ## Datasheet format
 
-Each datasheet markdown file contains (in order):
+Each datasheet entry in the faction file contains (in order):
 
 1. **Unit name** (H1)
 2. **Role** (Battleline, Dedicated Transport, etc.)
@@ -137,7 +138,7 @@ Each datasheet markdown file contains (in order):
 
 ## Detachment format
 
-Each detachment file contains:
+Each detachment entry in the faction file contains:
 
 1. **Detachment name** (H1)
 2. **Detachment ability** — the core passive/active rule
@@ -158,7 +159,7 @@ the unit can take it and any conditions (e.g. "for every 5 models").
 Read `factions/<faction-slug>/<faction-slug>.md` — detachment list is near the top.
 
 ### "What does detachment ability X do?"
-Read the specific detachment file.
+Read the specific detachment entry in `factions/<faction-slug>/detachments.md`.
 
 ### "Who can lead unit X?"
 Read the datasheet's Leader/Led By section.

diff --git a/cogitator/factions/adepta-sororitas/datasheets.md b/cogitator/factions/adepta-sororitas/datasheets.md
diff --git a/cogitator/factions/adepta-sororitas/datasheets/aestred-thurga-and-agathae-dolan.md b/cogitator/factions/adepta-sororitas/datasheets/aestred-thurga-and-agathae-dolan.md
diff --git a/cogitator/factions/adepta-sororitas/datasheets/arco-flagellants.md b/cogitator/factions/adepta-sororitas/datasheets/arco-flagellants.md
diff --git a/cogitator/factions/adepta-sororitas/datasheets/battle-sanctum.md b/cogitator/factions/adepta-sororitas/datasheets/battle-sanctum.md