Atom registries

Browse registries.

Atom registries define the vocabulary for a nudgeDSL domain. Download one, import it into the playground, or use it with nudge analyze --registry. Contribute your own on GitHub.

Create your own

Define your domain's vocabulary.

An atom registry is a JSON file following this schema. Start with 5–10 atoms. Use the playground to validate and generate prompts from it.

atoms.json — minimal example
{
  "domain": "my-project",
  "version": "0.1.0",
  "description": "Project-specific atoms.",
  "extends": [],
  "atoms": [
    {
      "atom": "MARK",
      "fn": "UpdateStatus",
      "description": "Transition an item status.",
      "args": [
        { "name": "id", "type": "string" },
        { "name": "status", "type": "string",
          "enum": ["done","pending","error"] }
      ],
      "rollback": null
    }
  ]
}
arg types and constraints
// Supported arg types
"type": "string"    // any string
"type": "integer"   // whole number
"type": "float"     // decimal number
"type": "boolean"   // true or false
"type": "null"      // explicit null

// Constraints (optional)
"enum": ["a","b","c"]   // allowed values
"min": 0                // minimum (int/float)
"max": 100              // maximum (int/float)
"required": false       // default: true

// Rollback (for compensating parallel)
"rollback": "UNDO_ATOM" // must exist and
                        // have same arg types
Test in playground Read registry spec Contribute a registry
Quick validate

Test a registry file here.

Paste your JSON or drag and drop a file. The validator checks the schema, rollback signatures, and warns about common mistakes.

paste registry JSON
validation result
// Paste a registry JSON and click validate