ai-agents-build-and-envlisted

# ai-agents Build and Environment Runbook <!-- 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) --> Recreate a working dev environment for this repository from a fresh clone, verify it actually works, and avoid the traps that have cost prior contributors real time. Audience: a zero-context mid-level engineer or Sonnet-class model. Every command below was verified against the repo on 2026-07-03; the Provenance section gives a re-verification one-liner for each volatile fact. ## Triggers - `set up this repo` - `bootstrap the environment` - `fresh clone setup` - `ModuleNotFoundError: No module named yaml` - `environment traps` ## Scope This skill is environment setup and survival only. Adjacent problems route to siblings: | You want | Use instead | |----------|-------------| | Regenerate mirrors, run the drift gates, release | `ai-agents-generation-and-release` | | Understand what counts as test evidence, run CI-equivalent gates | `ai-agents-validation-and-qa` | | Full catalog of env vars, skip markers, escape hatches | `ai-agents-config-catalog` | | Triage a failing hook, gate, or test | `ai-agents-debugging-playbook` | ## Process ### Phase 1: Prerequisites The interpreter version has ONE source of truth: `.python-version` (currently `3.14.6`, as of 2026-07-03). Do not