Skip to content

The-Artificer-of-Ciphers-LLC/skills-from-the-artificer / artifact-gates

artifact-gates

Verified

Make workflow steps enforceable by giving each one a file it must produce. Use when an agent skips steps in a long directive, playbook, or slash command despite them being marked MANDATORY/ABSOLUTE/BLOCKING; when writing or reviewing a multi-step workflow that must not be short-circuited; when a review, design, or verification step is being self-reported rather than proven; or when a merge/label/publish action needs a machine-checked precondition instead of a promise. Triggers on "my agent keeps skipping", "it ignored the directive", "how do I enforce this step", "it said it ran the review but didn't", "self-attestation", "gate this action".

FileKindSize
README.mdmarkdown4.5 KB
SKILL.mdskill md10.5 KB
contracts/full-example.jsonconfig13.0 KB
contracts/minimal.jsonconfig2.6 KB
evals/evals.jsonconfig5.7 KB
hooks/artifact-gate.cjsexecutablescript15.5 KB
test/gate-test.shexecutablescript12.1 KB

contracts/minimal.json

View on GitHub
{
  "_comment": [
    "Starter contract — one family, three gates, the classic design/test/review spine.",
    "Copy to <repo-root>/.artifact-gate.json, adjust the paths to your layout, and start a run by",
    "writing .workflow/<branch-slug>/00-run.json. Nothing is enforced until that file exists.",
    "",
    "Adapt the `message` fields to name YOUR skills and YOUR required sections — they are the only",
    "text an agent sees at the moment it is blocked, so they carry the whole instruction."
  ],

  "families": [
    {
      "name": "workflow",
      "scope": "branch",
      "dir": ".workflow/{slug}",
      "arm": "00-run.json",
      "gates": [
        {
          "on": "edit",
          "paths": ["src/**", "lib/**"],
          "requires": "10-design.md",
          "message": "Design produced no artifact, so implementation is blocked.\n\nRequired sections, each non-empty:\n  ## Behavior table   — one row per input class AND per reachable path; the row set is the deliverable\n  ## Negative space   — what legitimately resembles your trigger condition and must NOT fire\n  ## Rejected         — alternatives considered and why not\n  ## Known limits     — what this deliberately does not fix\n\nA path you do not list here is a path you will not implement and will not test."
        },
        {
          "on": "edit",
          "paths": ["test/**", "tests/**", "**/*.test.*", "**/*.spec.*"],
          "requires": "20-test-matrix.md",
          "message": "The test matrix precedes the tests — that ordering is the entire point of this gate.\n\n  | # | Input class | Category | Expected | Test name | Covered? |\n\nCategories: happy / boundary (limit-1, limit, limit+1) / negative / hostile / independence.\nOne row per INPUT CLASS, not per test you intend to write.\n\nDerive the rows from the design's behavior table and negative space, then extend. Writing tests for the code you just wrote finds none of the classes that actually reach CI."
        },
        {
          "on": "bash",
          "match": "(^|[\\s;|&])git(\\s+-[^\\s]+)*\\s+push(\\s|$)",
          "requires": "30-review.json",
          "message": "Review produced no artifact, so the push is blocked.\n\nShape:\n  {\"engines\":[{\"name\":\"code-review\",\"isolated\":false,\n               \"findings\":[{\"severity\":\"blocker|major|minor\",\"summary\":\"...\",\n                            \"disposition\":\"fixed <sha>|not-a-defect: <proof>\"}]}]}\n\nAt least one engine should run in a context that did not author the change. Every finding needs a disposition, and `not-a-defect` needs the proof rather than the assertion."
        }
      ]
    }
  ]
}
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 323kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall