From 22993d5da28d8e0b65ebb137601ebd24d384291e Mon Sep 17 00:00:00 2001
From: Entropix <entropixai@icloud.com>
Date: Sun, 4 Jan 2026 23:56:13 +0800
Subject: [PATCH] Add troubleshooting section to README.md with links for
 fixing installation and build issues. This update aims to assist users in
 resolving common problems encountered during setup.

---
 README.md | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/README.md b/README.md
index 2c5bcfa..f72bc81 100644
--- a/README.md
+++ b/README.md
@@ -162,6 +162,10 @@ For now, the local execution path gives you full control and privacy. As we buil
 - [📦 Publishing Guide](docs/PUBLISHING.md) - How to publish to PyPI
 - [🤝 Contributing](docs/CONTRIBUTING.md) - How to contribute
 
+### Troubleshooting
+- [🔧 Fix Installation Issues](FIX_INSTALL.md) - Resolve `ModuleNotFoundError: No module named 'flakestorm.reports'`
+- [🔨 Fix Build Issues](BUILD_FIX.md) - Resolve `pip install .` vs `pip install -e .` problems
+
 ### Reference
 - [📋 API Specification](docs/API_SPECIFICATION.md) - API reference
 - [🧪 Testing Guide](docs/TESTING_GUIDE.md) - How to run and write tests