rust-sop
Installation
SKILL.md
Rust SOP — joelclaw Standard Operating Procedures
Idiomatic Rust patterns and conventions for all Rust code in joelclaw. Primary consumer: clawnode (embedded PDS + mesh daemon). Written for agent workers — include this skill when delegating Rust work to codex.
Project Conventions
Stack
| Layer | Crate | Notes |
|---|---|---|
| Runtime | tokio |
Multi-thread by default, current_thread for tests |
| HTTP | axum |
XRPC endpoints, health checks |
| Database | libsql |
Local-first, native vector search (F32_BLOB, DiskANN) |
| Serialization | serde + serde_json |
All AT Proto records are JSON |
| Error handling | thiserror (libraries), anyhow (binaries) |
Never unwrap() in production |
| CLI | clap (derive) |
Single binary: daemon + CLI subcommands |
| Logging | tracing + tracing-subscriber |
Structured, not println |
| Testing | built-in + tokio::test |
Property tests with proptest where useful |
| AT Proto types | atrium crates |
Code-generated from lexicons |