docs: Improve Developer Experience with Updated README and New Architecture Doc

[duffney]

This pull request makes significant updates to the README.md and introduces a new architecture design document for the Wassette project. The changes focus on improving project documentation, refining the messaging to emphasize core features and benefits, and providing a detailed overview of the architecture and design philosophy. Below is a summary of the key changes:

Updates to Project Documentation

• Enhanced README Introduction: The README.md has been rewritten to provide a more concise and engaging introduction to Wassette, highlighting its key features such as secure sandboxes, dynamic loading, and developer-friendly workflows. It replaces the previous detailed problem statement and audience sections with a streamlined overview.
• Quick Start Guide: The installation and setup instructions in the README.md have been restructured to simplify getting started with Wassette. This includes clear examples for configuring MCP-compatible agents like VSCode.
• New Example Component: Added a Python code execution sandbox (eval-py) to the list of example components in the README.md.

New Architecture Design Document

• Comprehensive Architecture Overview: Introduced a new docs/architecture-design.md file that provides an in-depth explanation of Wassette's architecture, including its use of WebAssembly for secure execution, capability-based security policies, and developer-friendly design.
• Target Audience and Problem Analysis: The document identifies key user groups (developers, DevOps engineers, end users, and platform providers) and analyzes current solutions like container-based isolation and direct binary execution, highlighting their limitations.
• Design Philosophy and Goals: Outlines Wassette's focus on strong security boundaries, interoperability, and efficient resource usage through the WebAssembly Component Model. Includes examples of capability-based policies and a detailed development workflow.

[Copilot]

Pull Request Overview

This pull request significantly improves the developer experience by updating the README and introducing a comprehensive architecture design document. The changes streamline the project messaging to focus on core features like secure sandboxes and dynamic loading while providing detailed architectural context.

• Enhanced README with clearer messaging, simplified quick start guide, and better emphasis on key features
• Added comprehensive architecture design document explaining WebAssembly-based security model and development philosophy
• Restructured documentation to better serve both newcomers and developers seeking deeper technical understanding

Reviewed Changes

Copilot reviewed 2 out of 2 changed files in this pull request and generated 3 comments.

File	Description
README.md	Complete rewrite focusing on features and quick start, with streamlined installation and agent setup instructions
docs/architecture-design.md	New comprehensive document detailing system architecture, security model, and design philosophy

[Mossaka]

lgtm!