split data in separate files

docs/troubleshooting/_index.md

@@ -0,0 +1,23 @@
+# Troubleshooting
+
+Common gameplay issues and their solutions.
+
+## Playbooks
+
+- [Income Bouncing](./income-bouncing.md) - "My income is bouncing up and down"
+- [Too Much Sheep](./too-much-sheep.md) - "Game says I have too much Sheep"
+- [Houses Not Upgrading](./houses-not-upgrading.md) - "Why are my houses not upgrading?"
+
+## Quick Diagnostics
+
+### Income Problems
+1. Check upkeep spikes (new high-upkeep buildings)
+2. Check need flicker (food/clothing stocks hitting zero)
+3. Check workforce (red hammer = missing workers)
+4. Open Statistics Screen for production vs consumption
+
+### Production Issues
+1. Verify raw material supply
+2. Check transport distances
+3. Ensure warehouse coverage
+4. Match building ratios to chain requirements

docs/troubleshooting/houses-not-upgrading.md

@@ -0,0 +1,9 @@
+# Playbook: "Why are my houses not upgrading?"
+
+## Diagnostic Steps
+
+1. Ensure at least one need per category is met.
+
+2. Ensure service buildings' area coverage includes houses (roads/range).
+
+3. Ensure storage has the goods (not just "producing", but delivered).

docs/troubleshooting/income-bouncing.md

@@ -0,0 +1,17 @@
+# Playbook: "My income is bouncing up and down"
+
+## Diagnostic Steps
+
+1. **Check upkeep spikes:** Did you place a high-upkeep building (e.g., Bakery)?
+
+2. **Check need flicker:** Are food/clothing stocks dipping to zero intermittently? (storage/transport issue)
+
+3. **Check workforce:** Look for red hammer / missing tier workers after upgrades.
+
+4. **Open Statistics Screen:** Verify production vs consumption bars.
+
+## Fix Priority
+
+1. Tier I Food
+2. Tier I Fashion
+3. Tier II staple chains

docs/troubleshooting/too-much-sheep.md

@@ -0,0 +1,11 @@
+# Playbook: "Game says I have too much Sheep"
+
+## Diagnostic Steps
+
+1. Confirm overproduction in Statistics Screen.
+
+2. Add/scale downstream processor (Felter) if present in your build.
+
+3. Export surplus via trade routes or diplomatic orders.
+
+4. Demolish/disable extra farms to stop upkeep drain.