chore: checkpoint before render engine vendoring

Signed-off-by: Sienna Meridian Satterwhite <sienna@r3t.io>

crates/xtask/README.md

@@ -0,0 +1,94 @@
+# xtask - Build Automation for Aspen
+
+This crate provides build automation tasks for the Aspen workspace using the [cargo-xtask pattern](https://github.com/matklad/cargo-xtask).
+
+## Usage
+
+All commands are run from the workspace root:
+
+```bash
+# Build for iOS Simulator (release mode)
+cargo xtask ios-build
+
+# Build for iOS Simulator (debug mode)
+cargo xtask ios-build --debug
+
+# Deploy to iOS Simulator
+cargo xtask ios-deploy
+
+# Deploy to a specific device
+cargo xtask ios-deploy --device "iPad Air (5th generation)"
+
+# Build, deploy, and stream logs (most common)
+cargo xtask ios-run
+
+# Build, deploy, and stream logs (debug mode)
+cargo xtask ios-run --debug
+
+# Build, deploy, and stream logs (specific device)
+cargo xtask ios-run --device "iPhone 15 Pro"
+```
+
+## Available Commands
+
+- **`ios-build`**: Builds the app for iOS Simulator (aarch64-apple-ios-sim)
+  - `--debug`: Build in debug mode (default is release)
+
+- **`ios-deploy`**: Deploys the app to iOS Simulator
+  - `--device`: Device name (default: "iPad Pro 12.9-inch M2")
+
+- **`ios-run`**: Builds, deploys, and streams logs (all-in-one)
+  - `--debug`: Build in debug mode
+  - `--device`: Device name (default: "iPad Pro 12.9-inch M2")
+
+## How It Works
+
+The xtask pattern creates a new binary target in your workspace that contains build automation code. This is better than shell scripts because:
+
+1. **Cross-platform**: Pure Rust, works everywhere Rust works
+2. **Type-safe**: Configuration and arguments are type-checked
+3. **Maintainable**: Can use the same error handling and libraries as your main code
+4. **Fast**: Compiled Rust is much faster than shell scripts
+5. **Integrated**: Can share code with your workspace
+
+## Adding New Tasks
+
+To add a new task:
+
+1. Add a new variant to the `Commands` enum in `src/main.rs`
+2. Implement the corresponding function
+3. Add the function call in the `match` statement in `main()`
+
+Example:
+
+```rust
+#[derive(Subcommand)]
+enum Commands {
+    // ... existing commands
+
+    /// Run tests on iOS Simulator
+    IosTest {
+        /// Device name
+        #[arg(long, default_value = "iPad Pro 12.9-inch M2")]
+        device: String,
+    },
+}
+
+fn ios_test(device_name: &str) -> Result<()> {
+    // Implementation here
+    Ok(())
+}
+
+fn main() -> Result<()> {
+    let cli = Cli::parse();
+    match cli.command {
+        // ... existing matches
+        Commands::IosTest { device } => ios_test(&device),
+    }
+}
+```
+
+## Dependencies
+
+- `anyhow`: Error handling
+- `clap`: Command-line argument parsing