docs: add benchmark results summary to README

Add comprehensive Benchmarks section with:
- Link to benchmarks/README.md for details
- System specifications
- Compile time: +3.7s (30% overhead)
- Binary size: 0.88x compression ratio
- Memory: minimal overhead with lazy decompression
- Performance: comparable latency/throughput
- Clear recommendations on when to use BakedFileSystem

Provides users with objective performance data to make
informed decisions about using BakedFileSystem.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>

Author: schovi

README.md

@@ -116,6 +116,73 @@ unless file = Assets.get?("missing/file")
 end
 ```
 
+## Benchmarks
+
+Comprehensive benchmarking suite comparing BakedFileSystem against traditional File I/O. See [benchmarks/README.md](benchmarks/README.md) for detailed methodology and instructions.
+
+### System Specifications
+
+- **OS:** Darwin 25.0.0 (arm64) - Apple M4 Pro
+- **Crystal:** 1.17.1
+- **Test Date:** 2025-11-02
+
+### Compile Time
+
+Embedding ~1.2 MB of assets adds **3.7 seconds** to compilation time (30% overhead):
+
+| Configuration   | Mean Compile Time |
+|-----------------|-------------------|
+| Baseline        | 12.27s            |
+| BakedFileSystem | 15.98s            |
+
+### Binary Size
+
+Automatic gzip compression achieves **0.88x ratio** (assets compressed to 88% of original size):
+
+| Metric      | Baseline | BakedFileSystem | Overhead  |
+|-------------|----------|-----------------|-----------|
+| Binary Size | 1.69 MB  | 2.72 MB         | +1.03 MB  |
+| Assets      | -        | 1.17 MB (raw)   | -         |
+
+### Memory Usage
+
+Minimal startup overhead with lazy decompression:
+
+| Stage             | Baseline | BakedFileSystem | Overhead |
+|-------------------|----------|-----------------|----------|
+| Startup           | 5.02 MB  | 5.08 MB         | +0.06 MB |
+| After Small File  | 5.97 MB  | 5.20 MB         | -0.77 MB |
+| After Medium File | 6.12 MB  | 5.77 MB         | -0.36 MB |
+| After Large File  | 6.14 MB  | 10.38 MB        | +4.23 MB |
+
+### Performance
+
+Comparable latency and throughput (1000 requests, 10 concurrent clients):
+
+| File Size | Baseline Latency | BakedFileSystem Latency | Throughput Baseline | Throughput Baked |
+|-----------|------------------|-------------------------|---------------------|------------------|
+| Small (1KB)   | 0.17 ms      | 0.17 ms                 | 56,034 req/s        | 55,790 req/s     |
+| Medium (100KB) | 0.17 ms     | 0.17 ms                 | 56,588 req/s        | 55,457 req/s     |
+| Large (1MB)   | 0.17 ms      | 0.17 ms                 | 56,575 req/s        | 54,922 req/s     |
+
+### Summary
+
+**Use BakedFileSystem when:**
+- Deploying small to medium static assets (< 10 MB)
+- Single-binary deployment is preferred
+- Assets don't change frequently
+
+**Benefits:**
+- ✅ Single binary with embedded assets
+- ✅ Automatic gzip compression (12% size reduction)
+- ✅ Minimal memory overhead
+- ✅ Comparable performance to file I/O
+
+**Trade-offs:**
+- ⚠️ +3.7s compilation time
+- ⚠️ +1 MB binary size per 1 MB of assets
+- ⚠️ Assets fixed at compile time
+
 ## Development
 
 TODO: Write development instructions here