Skip to content

mex-memory/mex / skills/mex-statechart

mex-statechart

Verified

Explain complicated existing behavior using checked state diagrams. Use when asked for a state diagram, to diagram the previous explanation, show a bug or recovery path, compare a proposed fix or existing TLA+ spec, or derive a model from an agreed chart. Generates native Mermaid and a readable terminal fallback; optionally view and explicitly save in MEX Hub.

references/example.json

View on GitHub
{
  "schemaVersion": 1,
  "title": "A bounded job",
  "summary": "A job starts and completes; checker results describe only this small model.",
  "scope": "One job; no retries or external services.",
  "subject": "Job lifecycle",
  "reader": "Developer",
  "classification": "proposed",
  "createdAt": "2026-10-26T00:00:00.000Z",
  "states": [
    {
      "id": "ready",
      "label": "Ready",
      "evidence": []
    },
    {
      "id": "running",
      "label": "Working",
      "evidence": []
    },
    {
      "id": "done",
      "label": "Complete",
      "evidence": []
    }
  ],
  "transitions": [
    {
      "id": "start",
      "from": "ready",
      "to": "running",
      "event": "Start work",
      "condition": "A request is ready",
      "evidence": [],
      "rules": [
        "Safe"
      ]
    },
    {
      "id": "finish",
      "from": "running",
      "to": "done",
      "event": "Finish work",
      "condition": "Work has completed",
      "evidence": [],
      "rules": [
        "Safe"
      ]
    }
  ],
  "initial": [
    "ready"
  ],
  "rules": [
    {
      "id": "Safe",
      "label": "Job state stays in its declared domain",
      "kind": "invariant",
      "provenance": "Explicit fixture rule for a finite qualification model.",
      "evidence": []
    }
  ],
  "evidence": [],
  "mapping": [],
  "files": [
    {
      "name": "Job.tla",
      "content": "---- MODULE Job ----\nEXTENDS Naturals\nVARIABLE pc\nInit == pc = 0\nStart == /\\ pc = 0 /\\ pc' = 1\nFinish == /\\ pc = 1 /\\ pc' = 2\nStay == /\\ pc = 2 /\\ UNCHANGED pc\nNext == Start \\/ Finish \\/ Stay\nSpec == Init /\\ [][Next]_pc\nSafe == pc \\in 0..2\nNoDone == pc < 2\nNeverDone == pc # 2\nEventuallyDone == <>(pc = 2)\n====\n"
    },
    {
      "name": "Job.cfg",
      "content": "SPECIFICATION Spec\nINVARIANT Safe\n"
    },
    {
      "name": "Projection.json",
      "content": "{\"states\":[{\"state\":\"ready\",\"values\":{\"pc\":0}},{\"state\":\"running\",\"values\":{\"pc\":1}},{\"state\":\"done\",\"values\":{\"pc\":2}}],\"actions\":{\"Start\":\"start\",\"Finish\":\"finish\"}}"
    }
  ],
  "diagram": {
    "validity": "unverified",
    "mermaid": "stateDiagram-v2\n  state \"Ready\" as ready\n  state \"Working\" as running\n  state \"Complete\" as done\n  [*] --> ready\n  ready --> running : Start work\n  running --> done : Finish work\n"
  },
  "check": {
    "outcome": "incomplete",
    "bounds": "pc in 0..2; one worker; 60 seconds; 512 MiB heap. Internal stuttering is omitted from the overview.",
    "results": [
      {
        "rule": "Safe",
        "outcome": "incomplete",
        "detail": "Awaiting real TLC execution."
      }
    ],
    "modelStates": null,
    "modelTransitions": null
  },
  "traces": [],
  "reproduction": {
    "outcome": "not-applicable",
    "detail": "Design fixture without an implementation; TLC is model evidence only.",
    "evidence": []
  },
  "omissions": [
    "External services, concurrency, retry and internal stuttering."
  ],
  "toolchain": {
    "upstream": "backnotprop/pstack@fad8d01588a1b1ae803f87c8a1e0de79e28cffec",
    "tlc": "1.7.4",
    "java": "Explicit local runtime",
    "renderer": "Mermaid 11.12.0",
    "regeneration": "Use mex-statechart to regenerate a new preview with the recorded model and config."
  }
}
slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack."Stars: 197kUpdated Claude CodeCodexVerifiedInstall
ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report.Stars: 194kUpdated Claude CodeCodexVerifiedInstall
ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt.Stars: 194kUpdated Claude CodeCodexVerifiedInstall