refactor-agents-md
Refactor AGENTS.md
Refactor an AGENTS.md for GPT-6 Astra. Every retained line enters each Codex session in its scope, so it must earn that attention. Move narrower guidance to the closest applicable scope or a reusable skill, and remove instructions that do not change behavior. Preserve the user's intended behavior and existing authorization.
Instructions
-
Pick the target. Use the target named by the invocation or established in the conversation. If the target remains ambiguous, ask the user to choose among the files that exist:
- The user-level file at
$CODEX_HOME/AGENTS.md, defaulting to~/.codex/AGENTS.mdwhenCODEX_HOMEis unset. - The current project's root
AGENTS.md. - Any nested
AGENTS.mdon the path from the project root to the current working directory.
- The user-level file at
-
Fetch the yardsticks. Fetch these pages to calibrate the audit. Use the GPT-6 Astra prompting guidance for model behavior and the AGENTS.md guide for organization; preserve explicit user choices where the guides offer defaults. If a source is unavailable, disclose the gap and continue with available evidence.