jig-ui 0.1.0

package/rules.index.json

@@ -0,0 +1,637 @@
+[
+  {
+    "id": "A-01",
+    "bucket": "hybrid",
+    "severity": "warning",
+    "detector": "violet-band-hue",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-02",
+    "bucket": "mechanical",
+    "severity": "error",
+    "detector": "gradient-text",
+    "fix": "solid-text-color",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-04",
+    "bucket": "mechanical",
+    "severity": "error",
+    "detector": "backdrop-blur",
+    "since": "0.1.0"
+  },
+  {
+    "id": "C-18",
+    "bucket": "mechanical",
+    "severity": "warning",
+    "detector": "pure-black-white",
+    "fix": "token-background",
+    "since": "0.1.0"
+  },
+  {
+    "id": "C-19",
+    "bucket": "mechanical",
+    "severity": "error",
+    "detector": "contrast-floor",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-29",
+    "bucket": "mechanical",
+    "severity": "error",
+    "detector": "focus-removed",
+    "fix": "add-focus-visible",
+    "since": "0.1.0"
+  },
+  {
+    "id": "H-47",
+    "bucket": "mechanical",
+    "severity": "error",
+    "detector": "hardcoded-value",
+    "fix": "token-substitute",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-03",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-58",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-59",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-60",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-67",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-05",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-06",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-07",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-08",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-09",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "A-10",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-11",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-12",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-13",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-14",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-15",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-16",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-17",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-75",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-76",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-77",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "B-78",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "C-66",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "C-20",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "C-21",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "C-22",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "C-49",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "C-50",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "C-68",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-23",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-24",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-69",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-96",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-70",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-71",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-72",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-25",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-26",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "D-27",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-28",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-30",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-31",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-32",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-33",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-34",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-35",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-51",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-52",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-61",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-62",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-63",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-64",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-65",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-73",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-74",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-91",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-92",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-93",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-94",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "E-95",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-36",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-37",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-38",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-39",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-40",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-41",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-97",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-98",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-99",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-100",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-101",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-102",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-103",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "F-104",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "G-42",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "G-43",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "G-44",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "H-45",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "H-46",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "H-48",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-53",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-55",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-79",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-54",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-80",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-81",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-82",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-83",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-84",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-85",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-86",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-87",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-88",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-89",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-57",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-56",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  },
+  {
+    "id": "I-90",
+    "bucket": "judgment",
+    "severity": "note",
+    "since": "0.1.0"
+  }
+]

package/templates/SKILL.md.tmpl

@@ -0,0 +1,53 @@
+Jig is a design system consumed by coding agents. Rules are numbered and stable;
+cite the number when you follow or deliberately break one.
+
+## Before generating or reviewing any UI
+
+1. Load `{{rules_path}}/00-anti-patterns.md` and `{{rules_path}}/01-modes.md`.
+2. Determine the mode from `{{config_file}}`, or infer it using the procedure in
+   `{{rules_path}}/01-modes.md` and state the inference in one line before building.
+3. Load the relevant section of `{{rules_path}}/03-patterns.md` for the component you are building.
+4. Load `{{rules_path}}/05-copy.md` whenever you write a label, button, heading, error or empty state.
+5. Consume tokens by semantic name only. Never write a raw colour or pixel value
+   at a call site.
+6. Run the self-check at the end of `{{rules_path}}/00-anti-patterns.md` before finishing
+   (a future `check` command will automate this).
+7. Cite any rule you deliberately break, with the reason, in one line.
+
+Load `{{rules_path}}/04-principles.md` only when two rules conflict.
+
+## Commands
+
+{{available_commands}}
+
+Commands marked `available` run via the CLI at `{{scripts_path}}`. Commands
+marked `planned` are listed for context only — running one errors out, since
+it is not yet registered.
+
+## Reading command output
+
+Consume the full output of any Jig command. Never pipe it through `head`, `tail`,
+`grep`, or `jq` — findings are ordered by severity, not by position, and
+truncating drops the ones that matter.
+
+If a command's output is already in this session's history and no files have
+changed since, do not re-run it.
+
+## Asking the user
+
+{{ask_instruction}}
+
+## Attestation
+
+Before you finish a task that generated or modified UI, emit this line:
+
+```text
+JIG_CHECK: version=<version> mode=<mode> self_check=<ran|skipped>
+```
+
+<!-- `mechanical=<pass|fail>:<n>/<total>` and `judgment=<ran|skipped>` fields
+     belong here once the `check` command lands and can actually produce
+     them — do not add them back before that. -->
+
+A skipped self-check must say `skipped` and give the reason. Do not report
+`ran` for a check you did not perform.

package/templates/command-metadata.json

@@ -0,0 +1,27 @@
+{
+  "install": {
+    "description": "Install Jig rules and the agent skill file into a repository.",
+    "argumentHint": "--agent <name> [--scope project|global]",
+    "status": "available"
+  },
+  "update": {
+    "description": "Update the vendored rules to a newer version, showing a diff and skipping files you have edited.",
+    "argumentHint": "",
+    "status": "available"
+  },
+  "init": {
+    "description": "Set up Jig in this project: detect the CSS system, derive or interview for brand values, validate them against the token contract, and write tokens plus jig.config.json.",
+    "argumentHint": "",
+    "status": "planned"
+  },
+  "check": {
+    "description": "Check changed files or a named target against the rule set. Reports violations by rule id.",
+    "argumentHint": "[target]",
+    "status": "planned"
+  },
+  "explain": {
+    "description": "Print a rule's full text, its correction, and the version it was introduced in.",
+    "argumentHint": "<rule-id>",
+    "status": "planned"
+  }
+}