ai-agents-generation-and-releaselisted

# ai-agents Generation and Release <!-- vendor-portability: contributor-facing knowledge pack for the rjmurillo/ai-agents repo itself. It intentionally references .agents/architecture, .agents/retrospective, .claude/lib, scripts/hook_utilities, scripts/github_core, scripts/ai_review_common, scripts/sync_plugin_lib.py, scripts/validation, build/generate_agents.py, build/scripts, templates/agents, and templates/platforms 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 and re-verified against the working tree on 2026-07-29; 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. The plugin manifests carry no version at all (ADR-092); the npm package still does. ## Triggers - `regenerate the mirrors` - `run the drift checks` - `why is the plugin version gate red` - `release the npm cli` - `why is the drift gate red` ## When NOT to Use This Skill | You want | Use instead | |