Document architecture changes

[centaurialpha]

📋 What to do

Document all changes made in this epic.

✅ Tasks

• Update README with changes
• Document new APIs
• Create migration guide
• Update docstrings

📂 Files

• README.md
• docs/ (if exists)