ai-rulez 5.10.0 → 5.11.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +30 -520
- package/package.json +9 -52
package/README.md
CHANGED
|
@@ -2,550 +2,60 @@
|
|
|
2
2
|
<img src="https://raw.githubusercontent.com/Goldziher/ai-rulez/main/docs/assets/ai-rulez-banner.png" alt="AI-Rulez" width="820" />
|
|
3
3
|
</p>
|
|
4
4
|
|
|
5
|
-
|
|
6
|
-
<strong>The standards-compliant lifecycle tool for agentic governance</strong>
|
|
7
|
-
</p>
|
|
8
|
-
|
|
9
|
-
<p align="center">
|
|
10
|
-
<a href="https://www.npmjs.com/package/ai-rulez"><img src="https://img.shields.io/npm/v/ai-rulez?color=blue" alt="npm version"></a>
|
|
11
|
-
<a href="https://pypi.org/project/ai-rulez/"><img src="https://img.shields.io/pypi/v/ai-rulez?color=blue" alt="PyPI version"></a>
|
|
12
|
-
<a href="https://github.com/Goldziher/homebrew-tap"><img src="https://img.shields.io/github/v/release/Goldziher/ai-rulez?label=homebrew&color=blue" alt="Homebrew version"></a>
|
|
13
|
-
<a href="https://pkg.go.dev/github.com/Goldziher/ai-rulez/v5"><img src="https://img.shields.io/github/v/release/Goldziher/ai-rulez?label=go&color=blue" alt="Go version"></a>
|
|
14
|
-
<a href="https://github.com/Goldziher/ai-rulez/blob/main/LICENSE"><img src="https://img.shields.io/github/license/Goldziher/ai-rulez?color=blue" alt="License"></a>
|
|
15
|
-
<a href="https://goldziher.github.io/ai-rulez/"><img src="https://img.shields.io/badge/docs-ai--rulez-blue" alt="Documentation"></a>
|
|
16
|
-
</p>
|
|
17
|
-
|
|
18
|
-
<p align="center">
|
|
19
|
-
<a href="https://goldziher.github.io/ai-rulez/"><strong>Documentation</strong></a> ·
|
|
20
|
-
<a href="https://goldziher.github.io/ai-rulez/quick-start/"><strong>Quick Start</strong></a> ·
|
|
21
|
-
<a href="https://goldziher.github.io/ai-rulez/examples/"><strong>Examples</strong></a>
|
|
22
|
-
</p>
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
---
|
|
26
|
-
|
|
27
|
-
## What it is
|
|
28
|
-
|
|
29
|
-
ai-rulez is a standards-compliant lifecycle tool for agent knowledge and capabilities. You keep rules, context, skills,
|
|
30
|
-
agents, commands, hooks, permissions and MCP servers in one source of truth, `.ai-rulez/`, and ai-rulez takes them
|
|
31
|
-
through the whole lifecycle:
|
|
32
|
-
|
|
33
|
-
```text
|
|
34
|
-
author -> generate -> bundle -> lint / validate -> govern -> publish
|
|
35
|
-
```
|
|
36
|
-
|
|
37
|
-
Most tools in this space stop at "turn my rules into markdown." ai-rulez treats agent knowledge like software you
|
|
38
|
-
ship: versioned, linted, locked, signed and audited, with an organization policy layer that enforces a floor no
|
|
39
|
-
repository can loosen.
|
|
40
|
-
|
|
41
|
-
- **One source, 52 targets.** Author once in `.ai-rulez/`; generate native files for every harness your team uses instead of hand-copying rules across tools.
|
|
42
|
-
- **A real lock file.** `ai-rulez.lock` pins remote includes, installed skills and authored content the way `go.sum` or `package-lock.json` pin dependencies.
|
|
43
|
-
- **Supply-chain-grade trust.** Sigstore signing, in-toto/DSSE attestations, CycloneDX/SPDX SBOMs and reviewer approvals, so "what prompt is actually running in production" has a verifiable answer.
|
|
44
|
-
- **Org-wide policy, not just repo config.** A central [policy](docs/policy.md) sets tighten-only floors; `verify` and CI gates enforce it everywhere.
|
|
45
|
-
|
|
46
|
-
## Features
|
|
5
|
+
# ai-rulez
|
|
47
6
|
|
|
48
|
-
|
|
49
|
-
[
|
|
7
|
+
[](https://www.npmjs.com/package/ai-rulez)
|
|
8
|
+
[](https://github.com/Goldziher/ai-rulez/blob/main/LICENSE)
|
|
50
9
|
|
|
51
|
-
|
|
52
|
-
| ------- | ------------ | ------------------------ | ---- |
|
|
53
|
-
| Content authoring | Manage rules, context, skills with scripts and references, agents, commands and code-review checks. | `init`, `add`, `edit`, `show`, `list`, `remove` | [Configuration](docs/configuration.md), [Skills](docs/skills.md), [Checks](docs/checks.md) |
|
|
54
|
-
| Open-standard sources | Use `.ai-rulez/` as an OKF bundle, or author in `AGENTS.md` and `.agents/` without generation overwriting that source. Convert a pre-OKF content tree in place. | `source = "agents"`, `migrate okf`, `export okf`, `import okf`, `okf validate` | [OKF](docs/okf.md), [Agents source](docs/agents-source.md) |
|
|
55
|
-
| Domains, profiles and roles | Organize content by domain, select domains by profile, and compose roles that filter items and control skill modes. | `domain`, `profile`, `roles`, `--profile`, `--role` | [Domains and profiles](docs/domains.md), [Roles](docs/roles.md) |
|
|
56
|
-
| Configuration layers and local overrides | Merge named TOML layers, a developer's local overlay and user-level settings; inspect the effective local changes. | `config layers`, `local`, `config.<name>.toml`, `--no-local` | [Layers](docs/configuration.md#layered-configuration), [Local configuration](docs/local-overrides.md) |
|
|
57
|
-
| Shared includes and skill installation | Reuse local or Git content, choose merge precedence, install individual skills and load skill sources with pinned revisions or version ranges. | `include`, `skill install/list/remove/update`, `includes`, `installed_skills`, `skill_sources` | [Includes](docs/includes.md), [Installed skills](docs/installed-skills.md) |
|
|
58
|
-
| Builtin content | Select bundled domains and individual guidance items, or exclude items from a selected pack. | `builtins list/show`, `builtins` | [Builtin domains](docs/domains.md) |
|
|
59
|
-
| Import and migration | Convert existing harness files and supported third-party layouts with a lossiness report; migrate a 4.x configuration to v5. | `convert`, `migrate v5` | [Conversion](docs/cli.md#convert-command), [Migration](docs/migration-v5.md) |
|
|
60
|
-
| Native generation | Render the file layouts, frontmatter and settings of 52 built-in harnesses, including Claude Code, Cursor, Codex, Copilot and Gemini CLI. | `generate`, `presets` | [Harness matrix](docs/harnesses.md) |
|
|
61
|
-
| Custom presets | Define templates or provider-backed presets for an additional harness and its supported content and settings. | `presets` inline tables, provider specs | [Custom presets](docs/profiles.md), [Provider-backed presets](docs/configuration.md#provider-backed-presets-full-parity) |
|
|
62
|
-
| Hooks, permissions and MCP settings | Translate shared hooks, allow/deny rules and MCP server definitions to each harness's supported native settings; report unsupported translations. | `hooks`, `permissions`, `mcp_servers` | [Settings](docs/settings.md), [Permissions](docs/permissions.md) |
|
|
63
|
-
| Remote-session setup | A `SessionStart` hook (on by default for Claude Code) that runs `ai-rulez generate` when a cloud session starts. | `[session_start]`, `session-start` | [Remote sessions](docs/session-start.md) |
|
|
64
|
-
| Generated-file guard | Install a supported harness's PreToolUse hook to block agent edits to generated files. | `[guard] generated = true`, `guard` | [Guard](docs/cli.md#guard-command) |
|
|
65
|
-
| User scope and monorepos | Generate user-level assistant configuration, watch source changes, or process nested project roots with ordered reports. | `generate --user`, `generate --watch`, `generate/validate --recursive` | [User scope](docs/user-scope.md), [Monorepos](docs/monorepo.md) |
|
|
66
|
-
| Drift, cleanup and diagnostics | Preview a generation plan, detect output drift, remove generated files and diagnose configuration, locks, tools and MCP placeholders. | `generate --dry-run/--emit-plan/--check`, `clean`, `doctor` | [CLI reference](docs/cli.md), [Architecture](docs/architecture.md) |
|
|
67
|
-
| Plugin and marketplace authoring | Bundle runtime-specific plugins and marketplace indexes, including multi-plugin definitions, Agent Plugins and opt-in Pi packages. | `generate --plugin`, `plugin`, `plugins_authoring`, `marketplaces_authoring` | [Plugins](docs/plugins.md), [Agent Plugins](docs/agent-plugins.md) |
|
|
68
|
-
| Discovery and documentation formats | Generate `AGENTS.md` and `llms.txt`; emit ARD manifests and experimental MCP Server Cards. | `agents_md`, `llms-txt` preset, `publish --emit`, `publish emit` | [AGENTS.md](docs/agents-md.md), [llms.txt](docs/llms-txt.md), [ARD](docs/ard.md), [MCP Server Cards](docs/mcp-server-card.md) |
|
|
69
|
-
| Release artifacts and publishing | Build reproducible archives, manifests and checksums, optionally sign them, verify a dist directory and explicitly upload to GitHub releases, npm or OCI. | `publish`, `publish verify`, `--to`, `--execute --yes` | [Publishing](docs/publish.md) |
|
|
70
|
-
| Static validation and security scanning | Check config, content, scripts and conventional harness files with stable `AR` codes, without requiring an ai-rulez config. Scope by paths, globs or Git changes; use fixes, suppressions, baselines and JSON/SARIF reports. | `validate`, `scan`, `--strict`, `--path`, `--glob`, `--outputs`, `--changed` | [Validation and security rules](docs/strict-validation.md), [Harness traps](docs/harness-traps.md) |
|
|
71
|
-
| External scanners | Run configured scanner programs with explicit execution/egress controls and merge their findings into validation reports. | `lint.external`, `scanners list/doctor`, `validate/scan --external` | [Scanner integrations](docs/strict-validation.md) |
|
|
72
|
-
| Repository verifiers | Run declared deterministic checks, opt into command or LLM predicates, link checks to rules, test fixtures and calibrate model-backed checks. | `verifiers run/list/explain/test/calibrate/suggest`, `validate --verifiers` | [Verifiers](docs/verifiers.md) |
|
|
73
|
-
| Model-based judge | Review agent configuration for security, quality and governance with quoted evidence, an adjudicator, rubric skills, change-impact selection and explicit incomplete coverage. Estimate before sending; cap spend and emit JSON or SARIF. | `judge`, `--estimate`, `--allow-llm`, `--changed`, `--skill`, `--fail-on` | [Judge](docs/judge.md) |
|
|
74
|
-
| Rubric review and patch proposals | Score configured items offline or with a semantic model, calibrate a rubric's gate and propose verified patches for findings. | `review`, `review calibrate/explain/fix`, `rubric` | [Review](docs/review.md) |
|
|
75
|
-
| Skill evaluation | Run harness-neutral eval cases through adapters; measure pass rate, trigger precision/recall, ablation and cost; import scenarios and calibrate estimates. | `eval run/import/calibrate-estimate` | [Evals](docs/evals.md) |
|
|
76
|
-
| Skill improvement (experimental) | Run an external optimizer on a copy, gate candidates against held-out evals, inspect results, apply an accepted change or open an isolated PR. | `improve run/show/apply/pr/clean/adapters` | [Improve](docs/improve.md) |
|
|
77
|
-
| Locks and source updates | Pin remote sources, installed skills, authored content and outputs; check drift, inspect outdated sources and update version-range pins. | `lock`, `lock --check/--diff/--outdated`, `update`, `skill update` | [Lock file](docs/lockfile.md) |
|
|
78
|
-
| Organization policy | Apply central floors for sources, approvals, signatures, execution and model use that repository settings cannot loosen. | `--policy`, `AI_RULEZ_POLICY`, `validate --show-policy` | [Policy](docs/policy.md), [Trust model](docs/trust-model.md) |
|
|
79
|
-
| Reviewer approvals | Bind approvals to content digests, review diffs, revoke or deny content, enforce authorized reviewers and verify signed approvals. | `approve`, `verify --approvals` | [Approvals](docs/approvals.md) |
|
|
80
|
-
| Signatures and attestations | Sign locks, bundles, skills, SBOMs and policies; verify Sigstore bundles, in-toto/DSSE attestations and publisher provenance. | `sign`, `verify --attestation/--self/--plugin`, `trust update` | [Signing](docs/signing.md) |
|
|
81
|
-
| Software bills of materials | Inventory AI content, dependencies and MCP packages in CycloneDX 1.6 or SPDX 2.3; detect SBOM drift and enforce lock and pin gates. | `sbom`, `sbom --check -o <file>`, `--require-lock`, `--strict-pins`, `--type spdx-json` | [SBOM](docs/sbom.md) |
|
|
82
|
-
| MCP management and skill serving | Expose configuration tools and reports to assistants; serve skills and supporting resources on demand with role filters and session budgets. Select a read-only server or reuse a local daemon. | `mcp`, `--serve-skills`, `--read-only`, `--daemon` | [MCP server](docs/mcp-server.md) |
|
|
83
|
-
| Skill search | Rank skills lexically, by vectors or with hybrid embeddings, maintain the index, evaluate ranking and mine queries from usage. | `search`, `search index/status/mine`, `search --eval` | [Search](docs/search.md) |
|
|
84
|
-
| Catalog and inventory | Inspect item metadata, owners, roles, dependencies and lock status; join eval/usage results, compare catalogs and build a static catalog website. | `catalog`, `catalog diff`, `catalog --html` | [Catalog](docs/catalog.md) |
|
|
85
|
-
| Token and context budgets | Report generated prompt tokens, compare profiles and roles, identify costly content and gate always-loaded or on-demand budgets. | `tokens`, `cost`, `--budget`, `--on-demand-budget` | [Token reports](docs/cli.md#tokens-command), [Cost reports](docs/cli.md#cost-command) |
|
|
86
|
-
| Session exposure and areas | Show what a Claude Code session loads at its start and what that costs, map repository areas to owners and terms, and flag area terms leaking into start-of-session text, overlapping skill listings and unreadable gates (`AR9W0`-`AR9W6`). | `exposure`, `exposure inventory/areas/collisions/leakage`, `[exposure]` | [Session exposure](docs/exposure.md) |
|
|
87
|
-
| Usage and item-load telemetry | Opt into identifier-only skill invocation, feedback and item-load records; report usage and optionally export item-load telemetry through OTLP. | `telemetry record/report/feedback/enable/export` | [Usage telemetry](docs/usage-telemetry.md), [Item loads and OTLP](docs/telemetry.md) |
|
|
88
|
-
| Shared model access | Route model calls through liter-llm, including AWS Bedrock credential refresh and OpenAI-compatible gateways, with network consent, budgets, authenticated caching and redacted diagnostics. | `[llm]`, `llm doctor`, `llm estimate` | [LLM access](docs/llm.md) |
|
|
89
|
-
| Automation and embedding | Use the composite GitHub Action, pre-commit/prek, Poly or Lefthook; call the experimental Go API to load, validate, plan/apply generation and manage locks. Shell completion and JSON schemas support other integrations. | [Action](action.yml), `init --setup-hooks`, `completion`, `pkg/airulez` | [Git hooks](#git-hooks), [GitHub Actions](#github-actions), [Go API](docs/embedding.md), [Schemas](docs/schema.md) |
|
|
10
|
+
One source for the rules, skills and settings of every AI coding assistant. ai-rulez keeps them in a single `.ai-rulez/` directory and generates the native files of 52 tools (`AGENTS.md`, `CLAUDE.md`, `.cursor/rules/`, skills, MCP and settings files), then validates, locks, signs and publishes them.
|
|
90
11
|
|
|
91
|
-
|
|
92
|
-
<img src="https://raw.githubusercontent.com/Goldziher/ai-rulez/main/docs/assets/quickstart.gif" alt="ai-rulez init and generate: one .ai-rulez source becomes the native files of four AI tools" width="820" />
|
|
93
|
-
</p>
|
|
94
|
-
|
|
95
|
-
## Supported tools
|
|
96
|
-
|
|
97
|
-
ai-rulez ships 52 built-in presets — one per AI coding assistant, CLI agent or IDE integration — each writing that
|
|
98
|
-
tool's own file layout, frontmatter and settings documents from the same `.ai-rulez/` source. Mix and match any
|
|
99
|
-
combination in `presets = [...]`; the full feature matrix (rules, skills, agents, commands, MCP, hooks, permissions,
|
|
100
|
-
checks, user scope) is in [Supported harnesses](docs/harnesses.md), and a provider that isn't listed yet still gets
|
|
101
|
-
full parity through a [custom provider-backed preset](docs/configuration.md#provider-backed-presets-full-parity).
|
|
102
|
-
|
|
103
|
-
<details>
|
|
104
|
-
<summary><strong>All 52 supported tools</strong></summary>
|
|
105
|
-
|
|
106
|
-
| Preset | Tool |
|
|
107
|
-
| ------ | ---- |
|
|
108
|
-
| `aiassistant` | [JetBrains AI Assistant](https://www.jetbrains.com/help/ai-assistant/) |
|
|
109
|
-
| `amp` | [Sourcegraph Amp](https://ampcode.com) |
|
|
110
|
-
| `antigravity` | [Google Antigravity](https://antigravity.google/docs) |
|
|
111
|
-
| `augment` | [Augment Code](https://docs.augmentcode.com) |
|
|
112
|
-
| `baz` | [Baz](https://baz.ai/docs/agents/skills-and-instructions) |
|
|
113
|
-
| `bob` | [IBM Bob](https://bob.ibm.com/docs) |
|
|
114
|
-
| `claude` | [Claude Code](https://code.claude.com/docs) |
|
|
115
|
-
| `cline` | [Cline](https://docs.cline.bot) |
|
|
116
|
-
| `codebuddy` | [CodeBuddy Code](https://www.codebuddy.ai/docs/cli) |
|
|
117
|
-
| `codebuff` | [Codebuff](https://www.codebuff.com/docs) |
|
|
118
|
-
| `codewhale` | [Codewhale](https://github.com/codewhale-hq/Codewhale) |
|
|
119
|
-
| `codex` | [OpenAI Codex](https://developers.openai.com/codex) |
|
|
120
|
-
| `commandcode` | [Command Code](https://commandcode.ai/docs) |
|
|
121
|
-
| `copilot` | [GitHub Copilot](https://docs.github.com/en/copilot) |
|
|
122
|
-
| `copilot-cli` | [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli) |
|
|
123
|
-
| `cortex` | [Snowflake Cortex Code](https://docs.snowflake.com/en/user-guide/cortex-code/extensibility) |
|
|
124
|
-
| `crush` | [Crush](https://github.com/charmbracelet/crush) |
|
|
125
|
-
| `cursor` | [Cursor](https://cursor.com/docs) |
|
|
126
|
-
| `deepagents` | [Deep Agents Code](https://docs.langchain.com/oss/deepagents/code) |
|
|
127
|
-
| `devin` | [Devin CLI](https://docs.devin.ai/cli) |
|
|
128
|
-
| `dsh` | [DeepSeek Harness](https://github.com/deepseek-ai/deepseek-harness) |
|
|
129
|
-
| `factory` | [Factory Droid](https://docs.factory.ai) |
|
|
130
|
-
| `gemini` | [Gemini CLI](https://geminicli.com/docs/) |
|
|
131
|
-
| `gitlab-duo` | [GitLab Duo CLI](https://docs.gitlab.com/user/gitlab_duo_cli/customize/) |
|
|
132
|
-
| `goose` | [goose](https://goose-docs.ai) |
|
|
133
|
-
| `grok` | [Grok Build CLI](https://docs.x.ai/build/overview) |
|
|
134
|
-
| `hermes` | [Hermes Agent](https://hermes-agent.nousresearch.com/docs) |
|
|
135
|
-
| `junie` | [JetBrains Junie](https://junie.jetbrains.com) |
|
|
136
|
-
| `kilo` | [Kilo Code](https://kilo.ai/docs) |
|
|
137
|
-
| `kimi` | [Kimi Code](https://moonshotai.github.io/kimi-code/) |
|
|
138
|
-
| `kiro` | [Kiro](https://kiro.dev/docs) |
|
|
139
|
-
| `letta` | [Letta Code](https://docs.letta.com) |
|
|
140
|
-
| `mimocode` | [MiMo Code](https://mimo.xiaomi.com/mimocode) |
|
|
141
|
-
| `muse` | [Meta Muse Code](https://dev.meta.ai/docs/muse-code) |
|
|
142
|
-
| `omp` | [oh-my-pi](https://github.com/can1357/oh-my-pi) |
|
|
143
|
-
| `openclaw` | [OpenClaw](https://docs.openclaw.ai) |
|
|
144
|
-
| `opencode` | [OpenCode](https://opencode.ai/docs) |
|
|
145
|
-
| `pi` | [pi](https://pi.dev/docs/latest) |
|
|
146
|
-
| `poolside` | [Poolside Pool](https://docs.poolside.ai) |
|
|
147
|
-
| `qoder` | [Qoder](https://docs.qoder.com/cli/quickstart) |
|
|
148
|
-
| `qwen` | [Qwen Code](https://qwenlm.github.io/qwen-code-docs/en/) |
|
|
149
|
-
| `reasonix` | [Reasonix](https://github.com/esengine/DeepSeek-Reasonix) |
|
|
150
|
-
| `replit` | [Replit Agent](https://docs.replit.com/features/agent/overview) |
|
|
151
|
-
| `rovodev` | [Atlassian Rovo Dev](https://www.atlassian.com/software/rovo-dev) |
|
|
152
|
-
| `takt` | [Takt](https://github.com/nrslib/takt) |
|
|
153
|
-
| `trae` | [Trae](https://docs.trae.ai/ide/rules) |
|
|
154
|
-
| `vibe` | [Mistral Vibe](https://docs.mistral.ai/vibe) |
|
|
155
|
-
| `warp` | [Warp](https://docs.warp.dev) |
|
|
156
|
-
| `xum` | [Xum](https://xum.coder.com) |
|
|
157
|
-
| `zcode` | [ZCode](https://zcode.z.ai/en/docs) |
|
|
158
|
-
| `zed` | [Zed](https://zed.dev/docs/ai) |
|
|
159
|
-
| `zoocode` | [Zoo Code](https://docs.zoocode.dev) |
|
|
160
|
-
|
|
161
|
-
</details>
|
|
162
|
-
|
|
163
|
-
## Standards
|
|
164
|
-
|
|
165
|
-
Generation isn't limited to harness files — ai-rulez aims to be compliant with the major emerging standards in the agentic ecosystem. A standard is listed when the code generates and validates it today.
|
|
166
|
-
[docs/standards.md](docs/standards.md) carries the pinned spec version, the conformance test suite and the known gaps for
|
|
167
|
-
each row, and is the source of truth for test status.
|
|
12
|
+
Documentation: [goldziher.github.io/ai-rulez](https://goldziher.github.io/ai-rulez/)
|
|
168
13
|
|
|
169
|
-
|
|
170
|
-
| -------- | ------ | ----------------- | --------------- |
|
|
171
|
-
| [OKF](docs/okf.md) (Open Knowledge Format, v0.2), the internal format of `.ai-rulez/` | supported | `export okf`, the `okf` preset | `okf validate` |
|
|
172
|
-
| [Agent Plugins](docs/agent-plugins.md) (agent-plugins.org) | supported | `generate --plugin`, `publish --emit agent-plugins` | `validate --strict` (AR9O codes) |
|
|
173
|
-
| [ARD](docs/ard.md) (Agentic Resource Discovery, a proposal) | supported | `publish --emit ard` | `validate` (entry schema, URN grammar) |
|
|
174
|
-
| [Agent Skills](docs/skills.md) (agentskills.io) | supported | `generate` | `validate` (frontmatter checks; partial) |
|
|
175
|
-
| [AGENTS.md](docs/agents-md.md), also as the [source](docs/agents-source.md) with `source = "agents"` | supported | `generate` | `validate` |
|
|
176
|
-
| [llms.txt](docs/llms-txt.md) | supported | the `llms-txt` preset | `validate` |
|
|
177
|
-
| MCP server config | supported | `generate` | `validate` (partial) |
|
|
178
|
-
| MCP server card | partial (experimental extension, pinned `526201b`) | `publish --emit mcp-server-card`, `publish --emit ard` | conformance tests only |
|
|
179
|
-
| [CycloneDX / SPDX SBOM](docs/sbom.md) | supported | `sbom` | `sbom --check` |
|
|
180
|
-
| [in-toto / DSSE / Sigstore](docs/signing.md) | supported | `sign` | `verify --attestation` |
|
|
181
|
-
| [OpenTelemetry (OTLP)](docs/telemetry.md) | supported | `telemetry export --to otlp` | not applicable |
|
|
14
|
+
## Install
|
|
182
15
|
|
|
183
|
-
|
|
184
|
-
|
|
185
|
-
Every option below produces the same `.ai-rulez/` tree and the same generated output — pick however your project
|
|
186
|
-
already runs tools. Each one walks through init, generate and validate; [Bundle and publish](#bundle-and-publish),
|
|
187
|
-
[Validate](#validate) and [Govern](#govern) below cover what comes after.
|
|
188
|
-
|
|
189
|
-
```toml
|
|
190
|
-
# .ai-rulez/config.toml
|
|
191
|
-
presets = ["claude", "cursor", "codex", "copilot", "gemini"] # any of the 52 harnesses
|
|
192
|
-
```
|
|
193
|
-
|
|
194
|
-
<details>
|
|
195
|
-
<summary><strong>npx (Node.js, no install)</strong></summary>
|
|
196
|
-
|
|
197
|
-
```bash
|
|
198
|
-
npx ai-rulez@latest init
|
|
199
|
-
npx ai-rulez@latest generate
|
|
200
|
-
npx ai-rulez@latest validate --strict
|
|
201
|
-
```
|
|
202
|
-
|
|
203
|
-
</details>
|
|
204
|
-
|
|
205
|
-
<details>
|
|
206
|
-
<summary><strong>uvx (Python, no install)</strong></summary>
|
|
207
|
-
|
|
208
|
-
```bash
|
|
209
|
-
uvx ai-rulez init
|
|
210
|
-
uvx ai-rulez generate
|
|
211
|
-
uvx ai-rulez validate --strict
|
|
212
|
-
```
|
|
213
|
-
|
|
214
|
-
</details>
|
|
215
|
-
|
|
216
|
-
<details>
|
|
217
|
-
<summary><strong>Homebrew (macOS / Linux)</strong></summary>
|
|
218
|
-
|
|
219
|
-
```bash
|
|
220
|
-
brew install goldziher/tap/ai-rulez
|
|
221
|
-
ai-rulez init
|
|
222
|
-
ai-rulez generate
|
|
223
|
-
ai-rulez validate --strict
|
|
224
|
-
```
|
|
225
|
-
|
|
226
|
-
</details>
|
|
227
|
-
|
|
228
|
-
<details>
|
|
229
|
-
<summary><strong>Go</strong></summary>
|
|
230
|
-
|
|
231
|
-
```bash
|
|
232
|
-
go install github.com/Goldziher/ai-rulez/v5/cmd/ai-rulez@latest
|
|
233
|
-
ai-rulez init
|
|
234
|
-
ai-rulez generate
|
|
235
|
-
ai-rulez validate --strict
|
|
236
|
-
```
|
|
237
|
-
|
|
238
|
-
The module path needs `/v5`; without it `@latest` resolves to an old build.
|
|
239
|
-
This local build needs cgo, a C toolchain and the Go module cache at runtime.
|
|
240
|
-
For a statically linked build, use `mise run build` from a clone; see [source installation](docs/installation.md).
|
|
241
|
-
|
|
242
|
-
</details>
|
|
243
|
-
|
|
244
|
-
<details>
|
|
245
|
-
<summary><strong>npm (global)</strong></summary>
|
|
16
|
+
Requires Node.js 22 or newer.
|
|
246
17
|
|
|
247
18
|
```bash
|
|
248
19
|
npm install -g ai-rulez
|
|
249
|
-
ai-rulez init
|
|
250
|
-
ai-rulez generate
|
|
251
|
-
ai-rulez validate --strict
|
|
252
20
|
```
|
|
253
21
|
|
|
254
|
-
|
|
255
|
-
|
|
256
|
-
<details>
|
|
257
|
-
<summary><strong>uv tool</strong></summary>
|
|
22
|
+
Or run it without installing:
|
|
258
23
|
|
|
259
24
|
```bash
|
|
260
|
-
|
|
261
|
-
ai-rulez init
|
|
262
|
-
ai-rulez generate
|
|
263
|
-
ai-rulez validate --strict
|
|
25
|
+
npx ai-rulez@latest init acme
|
|
264
26
|
```
|
|
265
27
|
|
|
266
|
-
|
|
28
|
+
The package is a thin launcher for the `ai-rulez` Go binary. On the first run it downloads the binary for your platform
|
|
29
|
+
(Linux and macOS on amd64 and arm64, Windows on amd64) from the matching GitHub release, verifies its SHA-256 checksum,
|
|
30
|
+
and stores it inside the package. Later runs start it directly.
|
|
267
31
|
|
|
268
|
-
|
|
269
|
-
<summary><strong>pip / pipx</strong></summary>
|
|
32
|
+
## Quickstart
|
|
270
33
|
|
|
271
34
|
```bash
|
|
272
|
-
|
|
273
|
-
#
|
|
274
|
-
pipx install ai-rulez
|
|
35
|
+
ai-rulez init acme
|
|
36
|
+
ai-rulez add rule testing --content '# Testing
|
|
275
37
|
|
|
276
|
-
|
|
38
|
+
- Every bug fix ships with a regression test.'
|
|
277
39
|
ai-rulez generate
|
|
278
|
-
ai-rulez validate --strict
|
|
279
|
-
```
|
|
280
|
-
|
|
281
|
-
</details>
|
|
282
|
-
|
|
283
|
-
<details>
|
|
284
|
-
<summary><strong>Day-to-day commands</strong></summary>
|
|
285
|
-
|
|
286
|
-
```bash
|
|
287
|
-
ai-rulez generate --watch # regenerate on every change to .ai-rulez/
|
|
288
|
-
ai-rulez generate --check # CI: exit 2 when committed outputs differ from the sources
|
|
289
|
-
ai-rulez doctor # read-only diagnostics: drift, removed presets, missing tools
|
|
290
|
-
ai-rulez generate --user # the same, for your home directory (~/.claude, ~/.codex, ...)
|
|
291
40
|
```
|
|
292
41
|
|
|
293
|
-
|
|
294
|
-
|
|
295
|
-
|
|
296
|
-
`.config/ai-rulez/`, and `ai-rulez init --config-dir .config/ai-rulez` scaffolds it.
|
|
297
|
-
|
|
298
|
-
## Bundle and publish
|
|
42
|
+
Set the tools you use in `.ai-rulez/config.toml` with `presets = ["claude", "cursor", "codex"]`. Run
|
|
43
|
+
`ai-rulez generate --check` in CI to catch drift. The
|
|
44
|
+
[Quick start](https://goldziher.github.io/ai-rulez/quick-start/) covers the rest.
|
|
299
45
|
|
|
300
|
-
|
|
301
|
-
|
|
302
|
-
<details>
|
|
303
|
-
<summary><strong>Show commands</strong></summary>
|
|
304
|
-
|
|
305
|
-
```bash
|
|
306
|
-
ai-rulez generate --plugin # plugin bundles and a marketplace index from the [plugin] block
|
|
307
|
-
ai-rulez export okf # an OKF bundle of your rules, context and skills (docs/okf)
|
|
308
|
-
ai-rulez publish --emit agent-plugins --emit ard --dry-run
|
|
309
|
-
ai-rulez publish --to github-release --execute --yes
|
|
310
|
-
```
|
|
46
|
+
## Private registries and offline installs
|
|
311
47
|
|
|
312
|
-
|
|
313
|
-
|
|
314
|
-
|
|
315
|
-
gates), writes a byte-reproducible tar.gz with `SHA256SUMS`, and uploads only when you pass `--execute --yes`. See
|
|
316
|
-
[Publish](docs/publish.md) and [Authoring plugins](docs/plugins.md).
|
|
317
|
-
|
|
318
|
-
Pi packages are opt-in with `[plugin] runtimes = ["pi"]`: skills and prompt templates can be installed
|
|
319
|
-
from Git or npm. Publishing to npm preserves Pi and OpenCode runtime metadata while using the
|
|
320
|
-
configured scope and plugin name for the released package.
|
|
321
|
-
|
|
322
|
-
`verify --plugin` reports a hand-edited or stray file in a bundle as drift, and `generate --plugin` restores it:
|
|
323
|
-
|
|
324
|
-
<p align="center">
|
|
325
|
-
<img src="https://raw.githubusercontent.com/Goldziher/ai-rulez/main/docs/assets/plugin-drift.gif" alt="ai-rulez verify --plugin reporting changed and extra files in a plugin bundle, then generate --plugin restoring it" width="820" />
|
|
326
|
-
</p>
|
|
327
|
-
|
|
328
|
-
## Validate
|
|
329
|
-
|
|
330
|
-
<p align="center">
|
|
331
|
-
<img src="https://raw.githubusercontent.com/Goldziher/ai-rulez/main/docs/assets/validate.gif" alt="ai-rulez validate --strict flags a defect, --explain describes it, and generate --check fails on drift" width="820" />
|
|
332
|
-
</p>
|
|
333
|
-
|
|
334
|
-
<details>
|
|
335
|
-
<summary><strong>Show commands</strong></summary>
|
|
336
|
-
|
|
337
|
-
```bash
|
|
338
|
-
ai-rulez validate # config plus content checks, exit 2 on findings
|
|
339
|
-
ai-rulez validate --explain AR001 # what a rule checks and how to suppress it
|
|
340
|
-
ai-rulez validate --format sarif --output ai-rulez.sarif
|
|
341
|
-
ai-rulez validate --path catalog --glob "plugins/**/*.json" # also lint files outside .ai-rulez/
|
|
342
|
-
ai-rulez validate --outputs # also lint the generated files; each problem is reported once
|
|
343
|
-
ai-rulez validate --strict # in any repo: with no config it lints AGENTS.md, SKILL.md, .claude/, .agents/
|
|
344
|
-
ai-rulez okf validate docs/okf # lint any OKF bundle, ai-rulez's or a third party's
|
|
345
|
-
ai-rulez generate --check # generated files still match their sources
|
|
346
|
-
```
|
|
347
|
-
|
|
348
|
-
</details>
|
|
349
|
-
|
|
350
|
-
## Govern
|
|
351
|
-
|
|
352
|
-
<details>
|
|
353
|
-
<summary><strong>Show commands</strong></summary>
|
|
354
|
-
|
|
355
|
-
```bash
|
|
356
|
-
ai-rulez lock # pin remote includes, installed skills and authored content
|
|
357
|
-
ai-rulez approve --list # what still needs a reviewer's approval
|
|
358
|
-
ai-rulez sign --lock # a Sigstore bundle (DSSE over an in-toto statement) for the lock
|
|
359
|
-
ai-rulez verify --attestation # check it offline against the [signing] policy
|
|
360
|
-
ai-rulez sbom -o ai-bom.cdx.json # CycloneDX 1.6 (or --type spdx-json)
|
|
361
|
-
```
|
|
362
|
-
|
|
363
|
-
</details>
|
|
364
|
-
|
|
365
|
-
An organization [policy](docs/policy.md) sets tighten-only floors a repository cannot loosen. See the
|
|
366
|
-
[trust model](docs/trust-model.md).
|
|
367
|
-
|
|
368
|
-
## Operate
|
|
369
|
-
|
|
370
|
-
- **MCP server.** `ai-rulez mcp` lets an assistant manage the configuration; with `--serve-skills` one server serves
|
|
371
|
-
skills on demand and the config tools together (`--read-only` keeps only the read-only tools).
|
|
372
|
-
See [MCP server](docs/mcp-server.md).
|
|
373
|
-
Served skills cost nothing until an assistant asks for them:
|
|
374
|
-
|
|
375
|
-
<img src="https://raw.githubusercontent.com/Goldziher/ai-rulez/main/docs/assets/skills-mcp.gif" alt="ai-rulez tokens before and after serving skills over MCP, then find_skill and load_skill" width="780" />
|
|
376
|
-
|
|
377
|
-
- **Monorepos.** Nested roots each carry their own `.ai-rulez/`; `generate --recursive` and
|
|
378
|
-
`validate --recursive` walk them all, and `tokens --budget` gates what every session loads.
|
|
379
|
-
See [Monorepos](docs/monorepo.md).
|
|
380
|
-
|
|
381
|
-
<img src="https://raw.githubusercontent.com/Goldziher/ai-rulez/main/docs/assets/monorepo.gif" alt="ai-rulez generate --recursive over two nested roots, recursive validation, and a token budget check" width="780" />
|
|
382
|
-
|
|
383
|
-
- **Telemetry.** Item-load records with an optional OTLP export. See [telemetry](docs/telemetry.md).
|
|
384
|
-
- **Evals and improve.** `ai-rulez eval` scores skills; `improve` (experimental) optimizes them behind a held-out eval
|
|
385
|
-
gate. See [evals](docs/evals.md) and [improve](docs/improve.md).
|
|
386
|
-
- **Judge.** `ai-rulez judge` reviews skills, agents, commands, rules, `CLAUDE.md`, `AGENTS.md`, MCP and settings files
|
|
387
|
-
with models, from the command line alone: security, quality and governance reviewers, a verifier that checks quoted
|
|
388
|
-
evidence, an independent adjudicator, and scores computed in code. Failed rubric criteria without a verifiable quote
|
|
389
|
-
are reported separately as unit-level findings. Governance reads the rules and
|
|
390
|
-
`CLAUDE.md` files that apply to each unit, nested `.claude/` directories at any depth. `ai-rulez judge --estimate`, then
|
|
391
|
-
`--allow-llm` to send; `--changed=origin/main` for a pull request, `--format sarif` for code scanning. See [judge](docs/judge.md).
|
|
392
|
-
- **Cost and inventory.** `tokens`, `cost`, `catalog` and `search` report what the configuration contains and costs.
|
|
393
|
-
- **Session exposure.** `exposure` reports what a Claude Code session loads at its start and gates it with `[exposure] start_budget`; with an `[exposure]` area map, `exposure leakage` and `exposure collisions` find area terms in start-of-session text and overlapping skill listings. See [Session exposure](docs/exposure.md).
|
|
394
|
-
|
|
395
|
-
Existing project on 4.x? Run `ai-rulez migrate v5 --dry-run`, then see [Migrating to v5](docs/migration-v5.md).
|
|
396
|
-
|
|
397
|
-
## Documentation
|
|
398
|
-
|
|
399
|
-
Full documentation at [goldziher.github.io/ai-rulez](https://goldziher.github.io/ai-rulez/). For how a source becomes
|
|
400
|
-
generated files, and the package map, see [Architecture](docs/architecture.md).
|
|
401
|
-
|
|
402
|
-
## Git Hooks
|
|
403
|
-
|
|
404
|
-
ai-rulez supports multiple pre-commit hook harnesses.
|
|
405
|
-
|
|
406
|
-
<details>
|
|
407
|
-
<summary><strong>pre-commit/prek</strong></summary>
|
|
408
|
-
|
|
409
|
-
Add to `.pre-commit-config.yaml`:
|
|
410
|
-
|
|
411
|
-
```yaml
|
|
412
|
-
repos:
|
|
413
|
-
- repo: https://github.com/Goldziher/ai-rulez
|
|
414
|
-
rev: v5.10.0
|
|
415
|
-
hooks:
|
|
416
|
-
- id: ai-rulez-recursive # generate: write outputs for every nested .ai-rulez/ root
|
|
417
|
-
- id: ai-rulez-validate # validate --recursive: content, security and link checks
|
|
418
|
-
```
|
|
419
|
-
|
|
420
|
-
Every hook runs `scripts/pre-commit/run-ai-rulez.sh` and triggers only on root or nested `.ai-rulez/` changes:
|
|
421
|
-
|
|
422
|
-
| Hook id | Runs |
|
|
423
|
-
| --- | --- |
|
|
424
|
-
| `ai-rulez-generate` | `generate`, the root `.ai-rulez/` only |
|
|
425
|
-
| `ai-rulez-recursive` | `generate --recursive`, every nested root |
|
|
426
|
-
| `ai-rulez-validate` | `validate --recursive` — a real validation run, not a dry run |
|
|
427
|
-
| `ai-rulez-plugin-generate` | `generate --recursive --plugin --if-configured` |
|
|
428
|
-
| `ai-rulez-plugin-verify` | `verify --recursive --plugin --if-configured` |
|
|
429
|
-
|
|
430
|
-
Add `ai-rulez-plugin-generate` and `ai-rulez-plugin-verify` too if the repository ships plugin bundles; the
|
|
431
|
-
`--if-configured` flag makes them no-ops on consumer-only repositories.
|
|
432
|
-
|
|
433
|
-
</details>
|
|
434
|
-
|
|
435
|
-
<details>
|
|
436
|
-
<summary><strong>Poly</strong></summary>
|
|
437
|
-
|
|
438
|
-
Add ai-rulez as a managed source in your existing `poly.toml` and select the hooks your
|
|
439
|
-
repository needs:
|
|
440
|
-
|
|
441
|
-
```toml
|
|
442
|
-
[[hooks.sources]]
|
|
443
|
-
id = "ai-rulez"
|
|
444
|
-
git = "https://github.com/Goldziher/ai-rulez.git"
|
|
445
|
-
revision = "v5.10.0"
|
|
446
|
-
hooks = ["ai-rulez-recursive", "ai-rulez-plugin-verify"]
|
|
447
|
-
```
|
|
448
|
-
|
|
449
|
-
The source also provides `ai-rulez-validate`, `ai-rulez-generate`,
|
|
450
|
-
and `ai-rulez-plugin-generate`.
|
|
451
|
-
Plugin hooks use `--if-configured`, so they skip consumer-only repositories that
|
|
452
|
-
do not contain a producer `[plugin]` or multi-member `[marketplace]` block.
|
|
453
|
-
|
|
454
|
-
Resolve and commit the source lock, then install the Git shims:
|
|
455
|
-
|
|
456
|
-
```bash
|
|
457
|
-
poly hooks update
|
|
458
|
-
git add poly.toml poly-hooks.lock
|
|
459
|
-
poly hooks install
|
|
460
|
-
```
|
|
461
|
-
|
|
462
|
-
</details>
|
|
463
|
-
|
|
464
|
-
<details>
|
|
465
|
-
<summary><strong>Lefthook</strong></summary>
|
|
466
|
-
|
|
467
|
-
Add to `lefthook.yml`:
|
|
468
|
-
|
|
469
|
-
```yaml
|
|
470
|
-
pre-commit:
|
|
471
|
-
commands:
|
|
472
|
-
ai-rulez:
|
|
473
|
-
glob: ".ai-rulez/**"
|
|
474
|
-
run: ai-rulez generate --recursive --no-local
|
|
475
|
-
```
|
|
476
|
-
|
|
477
|
-
Hooks run on each developer's machine and would otherwise load that developer's gitignored
|
|
478
|
-
`config.local.toml` overlay and `.ai-rulez/local/` content. Pass `--no-local` (also accepted by `validate`
|
|
479
|
-
and `tokens`) where a hook should see only the shared configuration, as a teammate or CI does. If you do
|
|
480
|
-
not, `generate` still refuses to write local-derived changes into tracked shared files; never add
|
|
481
|
-
`--allow-local-drift` to a hook. See [Poly hooks guide](docs/poly-hooks.md#machine-local-configuration-in-hooks).
|
|
482
|
-
|
|
483
|
-
In a monorepo, `ai-rulez generate --recursive` and `ai-rulez validate --recursive` process every nested
|
|
484
|
-
`.ai-rulez/` root, report all failures, and exit non-zero if any root failed.
|
|
485
|
-
|
|
486
|
-
Or run `ai-rulez init --setup-hooks` while initializing a repo to wire hooks in automatically.
|
|
487
|
-
|
|
488
|
-
</details>
|
|
489
|
-
|
|
490
|
-
## GitHub Actions
|
|
491
|
-
|
|
492
|
-
ai-rulez ships its own composite Action ([`action.yml`](action.yml) at the repository root), so any workflow can
|
|
493
|
-
`uses: Goldziher/ai-rulez@<ref>` directly — no subpath. It downloads a release binary, verifies its sha256 against
|
|
494
|
-
the release's `checksums.txt`, caches it (keyed by OS, arch and the resolved version) and adds it to `PATH`. No Go
|
|
495
|
-
toolchain, Node or Python needed in the job. It reuses the same `scripts/pre-commit/run-ai-rulez.sh`
|
|
496
|
-
download-and-verify logic the pre-commit hooks above use, so the two stay in sync.
|
|
497
|
-
|
|
498
|
-
Use `Goldziher/ai-rulez@v5` for compatible action updates: publishing a stable v5 release moves
|
|
499
|
-
this annotated floating tag after all distribution jobs succeed. `uses: Goldziher/ai-rulez@v5` with
|
|
500
|
-
`version: latest` keeps a workflow on the newest 5.x action and the newest released CLI with no
|
|
501
|
-
per-release edits. Pin a full release tag or commit SHA to fix the action code. The action ref and
|
|
502
|
-
installed CLI version are independent: set `version` as well to pin the binary; its default
|
|
503
|
-
`latest` can eventually select a newer major release.
|
|
504
|
-
|
|
505
|
-
| | |
|
|
506
|
-
| --- | --- |
|
|
507
|
-
| **Input** `version` | `X.Y.Z`, `vX.Y.Z`, `X.Y.Z-rc.N` or `latest` (default: the newest stable GitHub release). Optional — omit it to always use the newest release. |
|
|
508
|
-
| **Inputs** `llm-*` | Optional provider, model, gateway, credential variable name, network opt-in, budgets and other LLM settings exported to later steps. [Full reference](docs/github-actions.md#llm-configuration-inputs). |
|
|
509
|
-
| **Output** `version` | The resolved version, without the leading `v`. |
|
|
510
|
-
| **Output** `path` | Absolute path to the installed `ai-rulez` binary. |
|
|
511
|
-
|
|
512
|
-
<details>
|
|
513
|
-
<summary><strong>Show workflow</strong></summary>
|
|
514
|
-
|
|
515
|
-
```yaml
|
|
516
|
-
name: ai-rulez
|
|
517
|
-
on:
|
|
518
|
-
pull_request:
|
|
519
|
-
push:
|
|
520
|
-
branches: [main]
|
|
521
|
-
jobs:
|
|
522
|
-
check:
|
|
523
|
-
runs-on: ubuntu-latest
|
|
524
|
-
steps:
|
|
525
|
-
- uses: actions/checkout@v7
|
|
526
|
-
- uses: Goldziher/ai-rulez@v5
|
|
527
|
-
with:
|
|
528
|
-
version: 5.9.2 # pin the CLI independently of the floating action ref
|
|
529
|
-
- run: ai-rulez generate --check # the committed output matches the sources
|
|
530
|
-
- run: ai-rulez validate --strict # content and security checks, warnings fail
|
|
531
|
-
- run: ai-rulez lock --check # pins were updated when the sources were
|
|
532
|
-
```
|
|
48
|
+
To avoid the GitHub download, publish the package with binaries in `bin/` named `ai-rulez-linux-amd64`,
|
|
49
|
+
`ai-rulez-linux-arm64`, `ai-rulez-darwin-amd64`, `ai-rulez-darwin-arm64` or `ai-rulez-windows-amd64.exe`. The launcher
|
|
50
|
+
uses a packaged binary first. If the Windows binary needs `liter_llm_ffi.dll`, add it as `bin/liter_llm_ffi.dll`.
|
|
533
51
|
|
|
534
|
-
|
|
52
|
+
## Other channels
|
|
535
53
|
|
|
536
|
-
`
|
|
537
|
-
|
|
538
|
-
|
|
539
|
-
untracked files. `expected-config-count` fails a run that finds a different number of roots, and a job summary lists
|
|
540
|
-
every command. See [the check sub-action](docs/github-actions.md#governance-gate-check).
|
|
541
|
-
`uses: Goldziher/ai-rulez/update@v5` on a schedule runs `ai-rulez update` when `lock --outdated` reports an allowed
|
|
542
|
-
update, regenerates, re-pins the content and opens a pull request with the outdated table (or pushes directly with
|
|
543
|
-
`direct: true`). See [scheduled pin updates](docs/github-actions.md#scheduled-pin-updates-update).
|
|
54
|
+
Homebrew (`brew install goldziher/tap/ai-rulez`), PyPI (`pipx install ai-rulez` or `uv tool install ai-rulez`) and Go
|
|
55
|
+
(`go install github.com/Goldziher/ai-rulez/v5/cmd/ai-rulez@latest`). See
|
|
56
|
+
[Installation](https://goldziher.github.io/ai-rulez/installation/).
|
|
544
57
|
|
|
545
|
-
|
|
546
|
-
pass provider credentials through `env:` on the command step or job, and run `ai-rulez judge
|
|
547
|
-
--allow-llm`. Installation itself makes no model requests. See the [action guide](docs/github-actions.md)
|
|
548
|
-
for all inputs, environment precedence, Bedrock, outputs and complete examples.
|
|
58
|
+
## Links
|
|
549
59
|
|
|
550
|
-
|
|
551
|
-
|
|
60
|
+
[Documentation](https://goldziher.github.io/ai-rulez/) · [Source](https://github.com/Goldziher/ai-rulez) ·
|
|
61
|
+
[Issues](https://github.com/Goldziher/ai-rulez/issues) · [MIT license](https://github.com/Goldziher/ai-rulez/blob/main/LICENSE)
|
package/package.json
CHANGED
|
@@ -1,66 +1,23 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ai-rulez",
|
|
3
|
-
"version": "5.
|
|
4
|
-
"description": "Author, generate, validate and govern
|
|
3
|
+
"version": "5.11.1",
|
|
4
|
+
"description": "Author, generate, validate and govern rules, skills, plugins and MCP configuration for 52 AI coding assistants from one .ai-rulez/ source. Lock, sign and SBOM your agent configuration, review it with verified model evidence, and publish plugin bundles. CLI, MCP server and Go API.",
|
|
5
5
|
"keywords": [
|
|
6
|
-
"agent-plugins",
|
|
7
|
-
"agent-skills",
|
|
8
|
-
"agents",
|
|
9
|
-
"agents-md",
|
|
10
|
-
"ai",
|
|
11
|
-
"ai-assistant",
|
|
12
|
-
"ai-development",
|
|
13
|
-
"ai-governance",
|
|
14
6
|
"ai-rules",
|
|
15
|
-
"
|
|
16
|
-
"
|
|
17
|
-
"
|
|
18
|
-
"baz",
|
|
19
|
-
"claude",
|
|
7
|
+
"agents-md",
|
|
8
|
+
"agent-skills",
|
|
9
|
+
"agent-plugins",
|
|
20
10
|
"claude-code",
|
|
21
|
-
"
|
|
22
|
-
"cline",
|
|
23
|
-
"code-generation",
|
|
24
|
-
"code-review",
|
|
11
|
+
"cursor",
|
|
25
12
|
"codex",
|
|
26
|
-
"config",
|
|
27
|
-
"configuration",
|
|
28
13
|
"copilot",
|
|
29
|
-
"cursor",
|
|
30
|
-
"cyclonedx",
|
|
31
|
-
"developer-tools",
|
|
32
|
-
"development",
|
|
33
|
-
"devin",
|
|
34
|
-
"gemini",
|
|
35
|
-
"generator",
|
|
36
|
-
"git-hooks",
|
|
37
|
-
"go",
|
|
38
|
-
"golang",
|
|
39
|
-
"governance",
|
|
40
|
-
"hooks",
|
|
41
|
-
"in-toto",
|
|
42
|
-
"lifecycle",
|
|
43
|
-
"llm-evaluation",
|
|
44
|
-
"llms-txt",
|
|
45
14
|
"mcp",
|
|
46
|
-
"
|
|
47
|
-
"monorepo",
|
|
48
|
-
"okf",
|
|
49
|
-
"opencode",
|
|
50
|
-
"permissions",
|
|
51
|
-
"pre-commit",
|
|
52
|
-
"presets",
|
|
53
|
-
"productivity",
|
|
54
|
-
"publish",
|
|
55
|
-
"rules",
|
|
15
|
+
"ai-governance",
|
|
56
16
|
"sbom",
|
|
57
17
|
"sigstore",
|
|
58
|
-
"skills",
|
|
59
|
-
"spdx",
|
|
60
|
-
"standards",
|
|
61
18
|
"supply-chain",
|
|
62
|
-
"
|
|
63
|
-
"
|
|
19
|
+
"llms-txt",
|
|
20
|
+
"cli"
|
|
64
21
|
],
|
|
65
22
|
"homepage": "https://goldziher.github.io/ai-rulez/",
|
|
66
23
|
"bugs": {
|