Create comprehensive documentation

[coderabbitai]

Objective

Develop documentation for users and developers.

Tasks

• Create user guide explaining pill modes and features
• Document API endpoints for potential future integration
• Create README with clear setup instructions
• Add comments to critical code sections
• Create contribution guidelines
• Document known limitations and common issues

Why this is important

Good documentation helps users understand how to use SocrAI effectively and enables easier maintenance and contributions.

References

• This issue was created from PR: impro #6