Maintain Agent Guidance
Put each rule at the narrowest scope that must inherit it. Guidance changes affect future context on every matching task, so prefer replacement, consolidation, or deletion over accumulating reminders.
Scope model
- User guidance applies across unrelated projects for one user.
- Repository guidance applies to every contributor and agent in one repository.
- Nested guidance applies only below a specific directory.
.local/AGENTS.md holds private workstation or personal workflow rules and must remain untracked.
Treat AGENTS.md and .local/AGENTS.md as the universal sources. Do not create independent branded copies. When Claude Code compatibility is explicitly requested, prefer a managed CLAUDE.md import of @AGENTS.md or a locally excluded CLAUDE.local.md import of @.local/AGENTS.md; preserve any surrounding Claude-specific content.
Do not move private paths, credentials, personal service setup, or machine-specific values into shared guidance.
Workflow
- Read the applicable guidance chain and the evidence for the requested change.
- Identify overlaps, conflicts, stale facts, and the exact decision point the rule must influence.
- Draft independently numbered proposals. Each proposal must state the audience, target, exact add, replace, or delete diff, expected behavior, and context-cost tradeoff.
- Wait for item-level approval. Apply only accepted proposal IDs and do not bundle adjacent cleanup.
- Re-read each target before editing. If its preimage changed, revise the proposal instead of applying a stale diff.
- Validate nesting, language, commands, privacy boundaries, managed-section ownership, and any requested compatibility import.
- Report applied IDs and leave rejected or undecided proposals unchanged.
When an operation reads or changes .local/AGENTS.md, use protect-local-boundary first. It owns the private directory and Git exclusion boundary; this skill owns guidance scope and content.
1---2name: maintain-agent-guidance3description: Audit and update universal AGENTS.md guidance at the narrowest user, repository, nested, or private scope through exact approval-gated proposals.4---56# Maintain Agent Guidance78Put each rule at the narrowest scope that must inherit it. Guidance changes affect future context on every matching task, so prefer replacement, consolidation, or deletion over accumulating reminders.910## Scope model1112- User guidance applies across unrelated projects for one user.13- Repository guidance applies to every contributor and agent in one repository.14- Nested guidance applies only below a specific directory.15- `.local/AGENTS.md` holds private workstation or personal workflow rules and must remain untracked.1617Treat `AGENTS.md` and `.local/AGENTS.md` as the universal sources. Do not create independent branded copies. When Claude Code compatibility is explicitly requested, prefer a managed `CLAUDE.md` import of `@AGENTS.md` or a locally excluded `CLAUDE.local.md` import of `@.local/AGENTS.md`; preserve any surrounding Claude-specific content.1819Do not move private paths, credentials, personal service setup, or machine-specific values into shared guidance.2021## Workflow22231. Read the applicable guidance chain and the evidence for the requested change.242. Identify overlaps, conflicts, stale facts, and the exact decision point the rule must influence.253. Draft independently numbered proposals. Each proposal must state the audience, target, exact add, replace, or delete diff, expected behavior, and context-cost tradeoff.264. Wait for item-level approval. Apply only accepted proposal IDs and do not bundle adjacent cleanup.275. Re-read each target before editing. If its preimage changed, revise the proposal instead of applying a stale diff.286. Validate nesting, language, commands, privacy boundaries, managed-section ownership, and any requested compatibility import.297. Report applied IDs and leave rejected or undecided proposals unchanged.3031When an operation reads or changes `.local/AGENTS.md`, use `protect-local-boundary` first. It owns the private directory and Git exclusion boundary; this skill owns guidance scope and content.
MrMaxie