메뉴
Align AGENTS.md, rules, README, plans, and chronicles with the codebase; use --clean to archive obsolete task docs into ATLAS.md.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
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.