You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
{{ message }}
Repository navigation
Consumer repos have no built-in way to keep generated *.lock.yml in sync (drift/freshness gap) #1663
Repos that consume ado-aw commit the generated .github/agents/*.lock.yml next to its source .md. There is currently no built-in, consumer-facing way to guarantee the committed lock stays in sync with (a) its source .md and (b) the pinned ado-aw compiler version. Every consumer repo ends up hand-rolling its own drift check and version-bump automation — which is duplicative and easy to get wrong.
Where this bites
Upgrading a consumer's pinned compiler (e.g. 0.36.0 -> 0.45.1) and editing an agent's frontmatter surfaced three failure modes:
A version bump not followed by ado-aw compile leaves the lock's COMPILER_VERSION / release-download URLs pointing at the new version while the generated body is still the old one — an internally inconsistent pipeline.
Editing the source .md without recompiling silently desyncs the running pipeline from what is in the repo.
Every mitigation is per-repo boilerplate: a Renovate custom manager + postUpgradeTasks recompile (needs allowedPostUpgradeCommands, usually unavailable on a shared org Renovate instance), or a standalone ado-aw check PR pipeline (needs its own branch-policy registration). Each consumer has to replicate this.
Ask: resolve it universally in ado-aw
The building blocks already exist — the ado-aw check command, and ado-aw already recompiles its own fixtures on each release. Please expose this to consumers so no repo needs bespoke wiring. Options, roughly in preference order:
Self-check baked into the generated lock (or a shared template consumers extends).compile already knows the source + compiler version, so the generated pipeline could run ado-aw check on itself as an early fast-fail step — every compiled pipeline would be drift-protected for free, with no per-repo YAML.
Release-driven recompile PRs for consumers. Extend the existing on-release fixture recompile to open "recompile lock" PRs against onboarded consumer repos when a new version ships — centralizing bump + recompile instead of per-repo Renovate.
Agency dispatch guard. Since Agency is the central trigger for these pipelines, have it refuse to run (or warn) when a lock does not match its source at the pinned compiler.
Option 1 alone would remove the need for every consumer to add a custom ado-aw check gate.
Note
This is separate from the inline-suggestion rendering fixed in v0.38.0 (#1104, "render applyable PR suggestions correctly"). This issue is specifically about lock freshness / drift for consumer repos, not suggestion rendering.
Markdown prompt changes have no bearing on compiler output. Prompts are dynamically consumed at runtime. Markdown frontmatter modifications require recompilation.
ado-aw check if part of generated pipelines. The markdown is recompiled at runtime and if the output does not match, an integrity check violation stops the run from proceeding. ado-aw check can optionally be used in your own CI too as a gate to frontmatter modification
ado-aw will not provide scheduled recompilation out of the box. It is on the user to define how workflows should be updated because of the security implications. ado-aw does support use of ado-aw at runtime and you can configure an agentic workflow to periodically recompile your workflows and create a PR.
If i've not addressed something in the issue let me know - perhaps a more specific example might illustrate the miss better.
Thanks @jamesadevine - that clears it up. I'd missed the Verify pipeline integrity step in the generated pipeline (runtime ado-aw check that halts on mismatch), which already covers the core drift concern. Agreed that auto-recompile shouldn't be built in; the runtime integrity check + optional ado-aw check in CI for PR-time fail-fast + an agentic workflow for periodic recompile-and-PR cover our needs. Closing.
Activity
jamesadevine commentedon Jul 27, 2026
hey @YuliiaKovalova
Much of what you describe is already supported.
ado-aw checkcan optionally be used in your own CI too as a gate to frontmatter modificationIf i've not addressed something in the issue let me know - perhaps a more specific example might illustrate the miss better.
YuliiaKovalova commentedon Jul 27, 2026
Thanks @jamesadevine - that clears it up. I'd missed the
Verify pipeline integritystep in the generated pipeline (runtimeado-aw checkthat halts on mismatch), which already covers the core drift concern. Agreed that auto-recompile shouldn't be built in; the runtime integrity check + optionalado-aw checkin CI for PR-time fail-fast + an agentic workflow for periodic recompile-and-PR cover our needs. Closing.