docs: add comprehensive developer guides and architecture documentation

[metakai1]

Summary

This PR contributes a comprehensive documentation suite to help developers understand and contribute to zOS. The documentation was generated using Claude Code and covers the full depth of the zOS architecture.

What's Included

Architecture & Integration

• Architecture Overview - Complete Redux-Saga-Normalizr pattern documentation with data flow diagrams, module organization, and design decisions
• Blockchain Integration Guide - Web3 patterns for wallet connections, transactions, smart contracts, and creator economy features
• Matrix Integration Guide - Real-time communication patterns, event handling, room management, and encryption

The Hitchhiker's Guide to zOS
A Douglas Adams-inspired educational series for developers learning the codebase:

• Chapter introductions and core concepts
• Visual diagrams for Redux-Saga flows and normalization patterns
• Hands-on workshops for practical learning
• Pattern library and quick reference materials

New Recruits Onboarding

• Contribution Guide - Step-by-step path from first PR to feature development
• Development Workflow - Environment setup, debugging strategies, testing approaches
• Documentation Index - Suggested learning paths and quick links
• Agent Implementation Guide - Patterns for building on zOS

Developer Reference

• Component documentation with TypeScript interfaces and examples
• Custom hooks guide for Matrix media, Web3 wallets, and optimization patterns

File Structure

docs/guides/
├── architecture-overview.md
├── blockchain-integration.md
├── integration-guide.md
├── developer-reference/
│   ├── components.md
│   └── hooks.md
├── hitchhiker/
│   ├── 00-introduction.md
│   ├── chapters/
│   ├── diagrams/
│   ├── patterns/
│   ├── reference/
│   └── workshops/
└── new-recruits/
    ├── agent-implementation-guide.md
    ├── contribution-guide.md
    ├── development-workflow.md
    └── documentation-index.md

Why This Matters

zOS is a sophisticated codebase with advanced patterns that can be challenging for new contributors. This documentation:

• Lowers the barrier to entry for new developers
• Explains the "why" behind architectural decisions
• Provides practical, hands-on learning materials
• Makes the codebase more accessible without dumbing it down

Test Plan

• All markdown files render correctly
• Internal links use relative paths
• Code examples are syntactically correct

🤖 Generated with Claude Code

[vercel]

@metakai1 is attempting to deploy a commit to the ZERO CORE Team on Vercel.

A member of the Team first needs to authorize it.