ai

notes on building with and around models, wherever the specific tech lands. pages are organized by concept; the projects these lessons came from — pub-search (search over atproto publications), phi (a bluesky agent), the slack bot in marvin's examples — appear as evidence within them.

contents

• retrieval/ — query-time mechanics: asymmetric embedding, rank fusion, synthesis between retrieval and prompt
• memory/ — how agents keep state between runs: message archives, deliberate vs background writes, write-time curation
• local-models/ — running models on your own hardware: serving, tool-calling, harness weight
• cluster-the-2d-projection — reading structure off an embedded corpus: umap, hdbscan, work items from geometry

adjacent, filed elsewhere on purpose: protocols/MCP (MCP is a protocol first; it stays with atproto), storage/turbopuffer (vector-store operations are storage operations), and the agent-memory design notes that live in the bot repo's docs beside the code they describe.