ai-agents-generation-and-release

# ai-agents Generation and Release <!-- vendor-portability: contributor-facing knowledge pack for the rjmurillo/ai-agents repo itself; intentionally references upstream paths (.agents/, .claude/, scripts/, build/) because its audience is repo contributors, not plugin consumers (issue #2050) --> Runbook for the build, generation, mirroring, versioning, and release machinery of this repo. Every command below was executed or read from source on 2026-07-02/03; re-verify with the one-liners in Provenance before trusting a volatile number. Jargon, defined once: - Generator: a Python function or script that reads a canonical tree and writes a derived (generated) tree. - Drift: the generated tree no longer matches what the generators would produce from the canonical tree. - Canonical: the tree you are allowed to edit. Generated trees are outputs; you never hand-edit them. - Semver: semantic version string MAJOR.MINOR.PATCH; "strictly greater" means the new version compares higher than the old one. ## Triggers - `regenerate the mirrors` - `run the drift checks` - `bump the plugin version` - `release the npm cli` - `why is the drift gate red` ## When NOT to Use This Skill | You want | Use instead | |----------|-------------| | Set up the dev environment, uv, hooks | `ai-agents-build-and-env` | | WHY the seam is shaped this way, invariants | `ai-agents-architecture-contract` | | Triage a red CI gate you do not understand | `ai-agents-debugging-playbook` | | Change classification,...