---
# .github/workflows/agents-md-maintainer.md  ·  GitHub Agentic Workflow (gh-aw)
# QRefAI AI Coding Field Guide, Part 3 (Q3.6)
#
# Keeps AGENTS.md honest as the repo evolves. READ-ONLY token; proposes edits via
# the create-pull-request safe output. Runs on a schedule so drift is caught
# regularly, not just on a related push. Compile with:  gh aw compile --strict
on:
  schedule:
    - cron: "0 6 * * 1"     # weekly, Monday 06:00 UTC
  workflow_dispatch: {}      # allow manual runs

permissions:
  contents: read

safe-outputs:
  create-pull-request:
    max: 1
    draft: true
---

# AGENTS.md maintainer

Audit the repository's `AGENTS.md` against current reality:

1. Verify the stated stack, versions, build/test commands, and project-structure
   notes still match the codebase.
2. Flag any rule that is now stale, contradicted by the code, or duplicated by the
   linter (which shouldn't be restated in AGENTS.md).
3. Watch the LENGTH — if AGENTS.md has crept past ~200–300 lines, propose moving
   bulky or situational content into skills, keeping the always-on file lean.

Open ONE draft PR with proposed edits and a short rationale per change. Make no
other modifications. If AGENTS.md is accurate and lean, do nothing.