Improve project documentation

[kernelshard]

Documentation Improvements

Description

Add comprehensive documentation to make the project easy to use and contribute to.

Tasks

• Update README.md with clear structure
• Add badges (tests, coverage, license)
• Add usage examples with screenshots
• Create CONTRIBUTING.md
• Create ARCHITECTURE.md
• Add installation instructions
• Document all CLI commands

Files to Create/Update

• README.md
• CONTRIBUTING.md
• ARCHITECTURE.md
• docs/ folder (optional)

Acceptance Criteria

• README has clear quick start
• All commands documented with examples
• Contributing guidelines added
• Architecture explained