Vault Path
Resolve the Data Relay vault path before any file operations:
jq -r '.["data-relay"].path' ~/.claude/domains.json | sed "s|~|$HOME|"
Use the resolved absolute path (<vault>) for all file operations below. Do NOT pass ~ to Glob, Read, or Write — they require absolute paths.
Instructions
Save a code snippet to <vault>/local/snippets/.
The snippet: $ARGUMENTS
- Read
<vault>/tags.md to check available subject tags.
- Read
<vault>/meta/templates/snippet.md for the file format spec.
- Write the snippet as a code file in the target language, using the format defined in the template. All metadata (description, source, date, tags) and commentary (explanation, references, notes) go in line comments.
- Use a lowercase, hyphenated filename with the appropriate language extension (e.g.,
bounded-retry-with-backoff.rs, bitemporal-exclusion.sql).
Relevant languages
- Professional: TypeScript (primary), Python, SQL
- Primary interests: TypeScript, Python, Lua, OCaml
- Actively learning: Rust, Gleam
- Adjacent: Erlang/Elixir (via BEAM ecosystem)
Snippets in these languages are in scope. Snippets in other languages can still qualify if the principle transfers to March's work or learning.
Selection criteria
A snippet is worth saving when it meets most of these:
- It demonstrates a principle, not just a technique. The code is a vehicle for an idea. If you can't articulate the why in the header comments, it's probably not worth saving.
- It transfers. The insight applies beyond the specific language or codebase. A snippet that only works in one context is a Stack Overflow answer, not a knowledge artifact.
- It connects to active work or learning. Typestates connect to marchhouse, bitemporal constraints connect to Numeric's data platform,
use expressions connect to learning Gleam. Brilliant but irrelevant code doesn't clear the bar.
- There's a surprise in it. Something non-obvious — a twist, a constraint that forces an elegant solution, an insight that reframes how you think about a problem. If the code does exactly what you'd expect, it's not teaching anything.
- It's re-readable. Future-you can open the file in six months and follow it without reconstructing the original conversation.
Be cautious about saving things that are merely clever. Cleverness without a transferable principle is trivia.
Quality bar
- The snippet should be self-contained — understandable without reading the full codebase it came from.
- Explain the why, not just the what. A snippet without context is just syntax.
- Use
[[wikilinks]] in comments to reference related notes or codex entries in the vault.
- To introduce a new subject tag not in
tags.md, ask March for approval first.
1---2name: relay-snippet3description: Save a useful, cool, interesting, or novel code snippet to the Data Relay. Use this when a piece of code encountered or written during a session is worth preserving — elegant patterns, clever solutions, reusable utilities, or instructive examples. When you spot a snippet-worthy moment during work, propose it to March first — if he agrees, invoke this skill to save it.4---56## Vault Path78Resolve the Data Relay vault path before any file operations:910```bash11jq -r '.["data-relay"].path' ~/.claude/domains.json | sed "s|~|$HOME|"12```1314Use the resolved absolute path (`<vault>`) for all file operations below. Do NOT pass `~` to Glob, Read, or Write — they require absolute paths.1516## Instructions1718Save a code snippet to `<vault>/local/snippets/`.1920The snippet: $ARGUMENTS21221. Read `<vault>/tags.md` to check available subject tags.232. Read `<vault>/meta/templates/snippet.md` for the file format spec.243. Write the snippet as a **code file in the target language**, using the format defined in the template. All metadata (description, source, date, tags) and commentary (explanation, references, notes) go in **line comments**.254. Use a lowercase, hyphenated filename with the appropriate language extension (e.g., `bounded-retry-with-backoff.rs`, `bitemporal-exclusion.sql`).2627## Relevant languages2829- **Professional:** TypeScript (primary), Python, SQL30- **Primary interests:** TypeScript, Python, Lua, OCaml31- **Actively learning:** Rust, Gleam32- **Adjacent:** Erlang/Elixir (via BEAM ecosystem)3334Snippets in these languages are in scope. Snippets in other languages can still qualify if the principle transfers to March's work or learning.3536## Selection criteria3738A snippet is worth saving when it meets most of these:3940- **It demonstrates a principle, not just a technique.** The code is a vehicle for an idea. If you can't articulate the *why* in the header comments, it's probably not worth saving.41- **It transfers.** The insight applies beyond the specific language or codebase. A snippet that only works in one context is a Stack Overflow answer, not a knowledge artifact.42- **It connects to active work or learning.** Typestates connect to marchhouse, bitemporal constraints connect to Numeric's data platform, `use` expressions connect to learning Gleam. Brilliant but irrelevant code doesn't clear the bar.43- **There's a surprise in it.** Something non-obvious — a twist, a constraint that forces an elegant solution, an insight that reframes how you think about a problem. If the code does exactly what you'd expect, it's not teaching anything.44- **It's re-readable.** Future-you can open the file in six months and follow it without reconstructing the original conversation.4546Be cautious about saving things that are merely *clever*. Cleverness without a transferable principle is trivia.4748## Quality bar4950- The snippet should be **self-contained** — understandable without reading the full codebase it came from.51- **Explain the why**, not just the what. A snippet without context is just syntax.52- **Use `[[wikilinks]]`** in comments to reference related notes or codex entries in the vault.53- To introduce a new subject tag not in `tags.md`, ask March for approval first.
diegosouzapw