chore: cleanup repo and improve docs

[Macnelson9]

This PR closes #103

📋 Summary
Major repository reorganization and documentation overhaul to improve developer experience and maintainability. Reduced root directory clutter by 80% and added comprehensive onboarding documentation.

🎯 Type of Change
Bug fix
New feature
Breaking change
Documentation update
Repository organization
📝 Changes Made
Repository Organization
Root Directory Cleanup (35+ files → 7 essential files)

Archived 23 historical files to .archive/
Organized documentation into docs/ with clear categories
Moved GitHub templates to .github/
Moved test files to tests/
New Directory Structure:

├── .archive/ # 23 historical files preserved
├── .github/ # GitHub templates organized
├── docs/
│ ├── gas/ # Gas optimization docs
│ ├── security/ # Security documentation
│ └── quick-reference/ # Quick guides
└── tests/ # Test files
New Documentation Created
CONTRIBUTING.md (3,500 words)

Code of conduct and workflow
Coding standards (Rust/TypeScript)
Git workflow and commit guidelines
PR process and code review checklist
DEVELOPMENT.md (4,000 words)

Complete setup guide (< 30 min onboarding)
Project structure walkthrough
5 common task tutorials
Debugging techniques
Troubleshooting (7+ common issues)
ARCHITECTURE.md (3,500 words)

System architecture with diagrams
Module design documentation
Data flow diagrams
Oracle integration architecture
Security and scalability considerations
CHANGELOG.md

Version history tracking
Keep a Changelog format
docs/README.md

Documentation index and navigation
Quick links by role and topic
.github/PULL_REQUEST_TEMPLATE.md

Standardized PR template
Comprehensive checklist
Updated Files
README.md: Updated project structure and documentation links
.archive/README.md: Archive explanation and retention policy
📊 Impact
Metric Before After Improvement
Root MD files 35+ 7 80% reduction
Documentation categories 0 4 Organized structure
Onboarding docs 0 6 Comprehensive guides
Archived files 0 23 History preserved
✅ Acceptance Criteria
Root directory contains only essential docs
All documentation properly categorized
No broken links after reorganization
README updated with new structure
Archive directory clearly labeled
New developer can set up in < 30 minutes
All common tasks documented
Code examples included
Architecture diagrams provided
🎯 Benefits
Developer Experience:

Clear onboarding path for new contributors
Easy-to-find documentation
Comprehensive troubleshooting guides
Standardized workflows
Repository Quality:

Professional structure
Reduced clutter
Better maintainability
Scalable organization
🔗 Related Issues
Closes #8 - Repository Cleanup and Organization

📚 Documentation Structure
Root Level (Essential Docs):

README.md - Project overview
CONTRIBUTING.md - How to contribute
DEVELOPMENT.md - Development setup
ARCHITECTURE.md - System design
API_SPEC.md - API reference
CHANGELOG.md - Version history
Organized Categories:

docs/gas/ - Gas optimization
docs/security/ - Security docs
docs/quick-reference/ - Quick guides
.archive/ - Historical files
✔️ Checklist
All files properly organized
Documentation follows project style
All internal links verified
No broken references
Archive properly labeled
README updated
CHANGELOG created
PR template standardized
💬 Reviewer Notes
Please verify:

Documentation links work correctly
New structure is intuitive
No important files accidentally archived
Onboarding flow makes sense