Menu
Align AGENTS.md, rules, README, plans, and chronicles with the codebase; use --clean to archive obsolete task docs into ATLAS.md.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Compare Claude Code and Codex on the same real code-change task with isolated worktrees, identical gates, transcripts, time, and cost.
Research current best practices and turn the evidence into a clear recommendation. Use for state-of-the-art, evidence-based, optimal-approach, comparison, or pros-and-cons questions in any field.
Clarify an ambiguous or consequential change before planning or implementation when more than one sound approach exists.
Add CHANGELOG.md entries, derive them from commits, or cut a Keep a Changelog and SemVer release.
Create a user-requested Conventional Commit from the staged changes.
Define or implement regression proof for a project or business flow. Use for test strategy, black-box or deep-integration tests, business KPIs and thresholds, test audits, missing tests, or test implementation.
| name | align-docs |
| description | Align AGENTS.md, rules, README, plans, and chronicles with the codebase; use --clean to archive obsolete task docs into ATLAS.md. |
| user-invocable | true |
| allowed-tools | Read, Edit, Write, Bash, Glob, Grep, AskUserQuestion |
Make the repository the one shared source for Claude Code, Codex, and humans:
CLAUDE.md # exactly @AGENTS.md
AGENTS.md # concise always-read facts and rules index
.agents/rules/*.md # topic rules with paths: frontmatter
.claude/rules -> ../.agents/rules
Resolve the git root and inspect these files, README, docs/, manifests, referenced paths, and any agent memory. Report missing, stale, duplicated, or oversized context before editing.
Preserve an align-docs:principles-customized block in AGENTS.md if already present. Otherwise prepend agents-template.md at the top of AGENTS.md. Keep AGENTS.md near 70 lines: project scope, only non-obvious domain/infrastructure/company/project facts, then one index row per rule. A rule owns its topic; AGENTS.md links instead of repeating it.
Ensure CLAUDE.md is the one-line import, the rules symlink exists, and .gitignore contains .claude/CLAUDE.md and AGENTS.override.md. Personal machine facts belong in .claude/CLAUDE.md or the user's global Codex AGENTS file, not shared docs.
Capture only durable facts learned in the current session and absent from disk. Cold invocation reports CAPTURE: NONE. Put always-read facts in AGENTS.md, topic depth in a rule, decisions in chronicles, and procedures in plans. Empty or generic memory is deleted after useful content is moved.
With --clean, also follow clean-mode.md: update docs/ATLAS.md as the decision index and archive obsolete plans/chronicles without deleting decisions.
Finish by checking line budget, rule scopes, symlink target, ignored personal files, README/manifests against disk, and every Markdown link. Apply the reduce-gate to all changed agent docs.