# AGENTS.md Management Plugin

Codex conversion of Anthropic's CLAUDE.md management plugin.

## What It Does

Two complementary skills help keep Codex instruction files useful and current:

| Skill | Purpose | Use when |
| --- | --- | --- |
| `agents-md-improver` | Audit AGENTS.md quality against the current codebase | You want to check, improve, or repair project guidance |
| `revise-agents-md` | Capture durable learnings from the current session | The session revealed commands, gotchas, setup quirks, or conventions future Codex runs should know |

## Codex Mapping

- `CLAUDE.md` became `AGENTS.md`.
- `.claude.local.md` became Codex's supported override pattern: `AGENTS.override.md`.
- The original `/revise-claude-md` slash command became the `revise-agents-md` skill.

Codex reads global guidance from `~/.codex/AGENTS.md` or `~/.codex/AGENTS.override.md`, then walks from the project root toward the current directory and includes one `AGENTS.override.md` or `AGENTS.md` per directory.

## Usage

Ask Codex things like:

```text
Audit my AGENTS.md files.
Check whether this repo's AGENTS.md is current.
Revise AGENTS.md with the learnings from this session.
```

## Source

Based on `claude-md-management` from:

https://github.com/anthropics/claude-plugins-official/tree/main/plugins/claude-md-management