hitl-compliance-gate

   __ _ _   _(_)_ __ __ _ ___
  / _` | | | | | '__/ _` / __|
 | (_| | |_| | | | | (_| \__ \
  \__, |\__,_|_|_|  \__, |___/
     |_|            |___/

 Governance first. Build accordingly.

Quirgs

Quirgs is a platform for building AI products responsibly. The site at quirgs.com ships governance tooling — skills, guides, and operational workflows — to the people writing the code, not the people reading the PDFs.

This repository is the production source for the public site, the skill catalog behind it, and the workers that back human-in-the-loop review.

Quirgs is not a knowledge base. It is not a tutorial site for local LLM deployments. It is not a sysadmin resource. Those descriptions belong to a legacy that no longer exists.

---

The product unit

A quirg (lowercase) is the unit Quirgs ships. Every quirg belongs to one of three formats:

Format	What it is
Skill	Installable Claude Code skill, distributed through the quirgs plugin marketplace. Executes a governance workflow inside an AI environment.
Guide	Structured how-to reference. Teaches a principle, standard, or implementation pattern in depth.
Tool	Reusable SOP, workflow, or automation system. Operational — meant to be run, not just read.

The current production catalog is seven Skills covering the EU AI Act, NIST AI RMF, ISO/IEC 42001, HITL gating, PII exposure, incident response, and AI transparency disclosure. See src/content/skills/.

---

Installing the skills

The Skills are distributed as a Claude Code plugin marketplace. The .claude-plugin/marketplace.json at the repo root lists eight plugins — the seven-skill quirgs-compliance bundle plus one single-skill plugin per Skill — and each plugin's source lives under plugins/ with its full SKILL.md and references/ committed so they survive install.

Inside Claude Code, add the marketplace once, then install:

/plugin marketplace add unqdlphn/quirgs
/plugin install quirgs-compliance@quirgs        # all seven skills
/plugin install eu-ai-act-classifier@quirgs     # or a single skill

The marketplace is added by its repo (unqdlphn/quirgs) but plugins install with the marketplace name suffix (@quirgs, the name field in marketplace.json).

Auto-update note: Third-party marketplaces have auto-update disabled by default. To pull new skill versions after install, run /plugin marketplace update quirgs.

The public Gists carry each SKILL.md for discovery, SEO, and read-only preview — they are not an install path, since a Gist cannot deliver a Skill's references/ directory.

---

Stack

Layer	Choice
Framework	Astro 6 — static output
Adapter	@astrojs/cloudflare → Cloudflare Workers
Content	Astro Content Collections + MDX, edited via Keystatic at /keystatic/
Hosting	Cloudflare (production domain: quirgs.com)
Backend services	Cloudflare Workers — KV + D1
CI	GitHub Actions (sync-gists.yml)
Node	>=22.12.0 (see package.json)

---

Repository layout