How to use prompt-atoms

Read the catalog over HTTPS

Every artifact is served under stable URLs with correct content-types:

curl https://prompt-atoms.com/exports/catalog.json
curl https://prompt-atoms.com/atoms/persona/code-reviewer-strict.json
curl https://prompt-atoms.com/prompts/code-reviewer-strict.json
curl https://prompt-atoms.com/schemas/composition-v1.json

Resolve a composition

A composition lists references to atoms by URI and version. To render the composition as a system prompt, fetch each referenced atom, concatenate their content fields in the order: persona → constraints → format → tool-use → refusals → output schema.

// pseudo-code
const composition = await fetch("/prompts/code-reviewer-strict.json").then(r => r.json());
const refs = composition.references;
const atoms = await Promise.all([
  fetch(uriToUrl(refs.persona.ref)).then(r => r.json()),
  ...refs.constraints.map(r => fetch(uriToUrl(r.ref)).then(r => r.json())),
  fetch(uriToUrl(refs.format_instruction.ref)).then(r => r.json()),
  // ... etc
]);
const systemPrompt = atoms.map(a => a.content).join("\n\n");

Vendor selection

Each atom declares which vendor families it works with via the vendors array (claude, gpt, llama, gemini, mistral, any). Filter atoms to your target vendor before rendering.

Compatibility rules

Rules in /exports/catalog.json (under the rules key) declare predicates over atoms — e.g., "json-object-with-summary requires json-strict as its format instruction". A composition that violates a require-effect rule is malformed.