docs: Add comprehensive user documentation (Priority 1)

Created extensive user-focused documentation to make Python Code
Harmonizer accessible and easy to use:

- docs/USER_GUIDE.md: Comprehensive guide covering installation,
  usage, score interpretation, integration, best practices, and
  troubleshooting (~4,800 words)

- docs/TUTORIAL.md: Hands-on tutorial with 5 progressive lessons,
  real code examples, refactoring exercises, and practice scenarios
  (~5,200 words)

- docs/FAQ.md: 25+ frequently asked questions organized by category
  with clear answers and troubleshooting guidance (~4,200 words)

- Updated README.md with documentation section linking to all new
  guides and previewing upcoming advanced documentation

Total: ~14,200 words of high-quality documentation focused on helping
users understand and effectively use the semantic code debugger.

This completes Priority 1 of the documentation enhancement plan.

Author: claude

README.md

@@ -91,6 +91,33 @@ Analysis Complete.
 
 ---
 
+## Documentation
+
+### Getting Started
+- **[User Guide](docs/USER_GUIDE.md)** - Comprehensive guide to using Python Code Harmonizer
+  - Installation and setup
+  - Understanding disharmony scores
+  - Integration into your workflow
+  - Best practices and troubleshooting
+
+- **[Tutorial](docs/TUTORIAL.md)** - Hands-on learning with real examples
+  - Step-by-step walkthroughs
+  - Common disharmony patterns
+  - Refactoring exercises
+  - Real-world scenarios
+
+- **[FAQ](docs/FAQ.md)** - Frequently Asked Questions
+  - Quick answers to common questions
+  - Interpretation guidance
+  - Troubleshooting tips
+
+### Advanced Topics
+- **[Philosophy](docs/PHILOSOPHY.md)** *(Coming Soon)* - Deep dive into the Anchor Point and ICE Framework
+- **[Architecture](docs/ARCHITECTURE.md)** *(Coming Soon)* - Technical implementation details for developers
+- **[API Reference](docs/API.md)** *(Coming Soon)* - Programmatic usage and integration
+
+---
+
 ## Development & Contribution
 
 This project is now equipped with a full suite of professional development tools to ensure code quality and stability.