skills.rest
qte77
qte77COMMUNITY
Explore all skills by this author →
WebsiteGitHub

maintaining-agents-md

Audit and synchronize governance documents with codebase changes.

2|1|Updated Feb 22, 2026
Search Tags:#codebase#learning#governance#drift#promotions#communications#audits
One-click install
npx skills add https://github.com/qte77/claude-code-plugins --skill maintaining-agents-md
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maintaining-agents-md
Source: https://github.com/qte77/claude-code-plugins/tree/main/plugins/docs-governance/skills/maintaining-agents-md
Command: npx skills add https://github.com/qte77/claude-code-plugins --skill maintaining-agents-md

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps AGENTS.md, AGENT_LEARNINGS.md, AGENT_REQUESTS.md, and CONTRIBUTING.md aligned with codebase changes, preventing governance drift and stale references.

Core Features & Use Cases

  • Governance drift detection and synchronization across governance documents.
  • Promotion readiness evaluation and alignment with codebase changes.
  • Sprint and PR governance health checks to maintain documentation integrity.

Quick Start

Run a governance audit to identify drift and apply fixes to governance files so they reflect the current codebase.

Frequently Asked Questions about maintaining-agents-md

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent governance drift in AGENTS.md during codebase updates?▼

To prevent governance drift, audit and synchronize AGENTS.md, AGENT_LEARNINGS.md, AGENT_REQUESTS.md, and CONTRIBUTING.md with codebase changes. This detects stale references and resolves discrepancies during sprint reviews, PR updates, and structural changes.

What is the best way to automate promotion readiness evaluation for agents?▼

Automate promotion readiness by evaluating alignment between governance documents and codebase changes. Perform governance health checks during sprint reviews to verify documentation integrity and support automated promotion decisions per established criteria.

How do I check for stale references and role-boundary drift in governance files?▼

Check for stale references and role-boundary drift by running a governance audit. This identifies discrepancies in AGENTS.md and related files, ensuring they reflect the current codebase and maintaining documentation integrity.

When do I need to synchronize governance documents with codebase changes?▼

Synchronize governance documents during sprint reviews, PR updates, and structural changes. This prevents governance drift and stale references, verifying governance health and resolving discrepancies to keep files aligned with the current codebase.

Can I use this governance audit for missing learnings in AGENT_LEARNINGS.md?▼

Yes, the governance audit implements checks for missing learnings in AGENT_LEARNINGS.md. It detects these gaps and applies fixes to governance files so they accurately reflect codebase changes and maintain documentation integrity.

Related Skills

Explore More Software Engineering Skills→
iliaaliliaal

md-docs

Update AGENTS.md, README.md, and CONTRIBUTING.md to reflect codebase changes.

Community
Intermediate
makyua-sanmakyua-san

land-and-deploy

Automates Git-based PR merge, CI wait, production deploy, and canary health checks.

Community
Advanced
LusciiLuscii

make-agent

Generate GitHub Copilot custom agent files with YAML frontmatter and templates.

Official
Basic
nguyenphpnguyenphp
41

lint-and-validate

Run linters, type checkers, and security audits across Node.js and Python projects.

Community
Intermediate