Skip to content

chore: rename CLAUDE.md to AGENTS.md and Justfile to justfile - #31

Merged
lesnik512 merged 1 commit into
mainfrom
docs/agents-md-rename
Sep 6, 2026
Merged

chore: rename CLAUDE.md to AGENTS.md and Justfile to justfile#31
lesnik512 merged 1 commit into
mainfrom
docs/agents-md-rename

Conversation

@lesnik512

Copy link
Copy Markdown
Member

Summary

Renames the agent-instructions file to the cross-agent name, and the justfile to lowercase.

AGENTS.md is the filename other coding agents look for; until now these instructions were
visible only to Claude Code. Claude Code discovers AGENTS.md natively (verified against
2.1.261), so this is a plain rename — no CLAUDE.md symlink or stub, which also avoids
the Windows core.symlinks caveat and the risk of a tool replacing the file and silently
breaking the link.

The Justfilejustfile rename brings this repo in line with modern-di,
faststream-outbox, chat-app and compose2pod, which already use the lowercase name.
just resolves either casing, so nothing changes operationally.

Part of modern-python/.github#51.

Changes

  • git mv CLAUDE.md AGENTS.md — recorded as a rename, so git log --follow keeps the history.
  • git mv Justfile justfile — likewise.
  • Updated live references to both names.

Historical records deliberately untouched

References inside planning/changes/, planning/releases/, planning/retros/ and
planning/audits/ are not rewritten. Those files narrate what was done at the time,
when the files genuinely were called CLAUDE.md and Justfile; rewriting them would
falsify the record. Live pointers — the instructions file itself, README, .github/,
docs/ (including ADRs), architecture/, planning/deferred.md, planning/decisions/,
source and tests — are updated.

@lesnik512
lesnik512 merged commit 3edb086 into main Sep 6, 2026
6 checks passed
@lesnik512
lesnik512 deleted the docs/agents-md-rename branch September 6, 2026 10:12
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant