Skip to content

Stop tracking AGENTS.md across owned repos #155

Description

@twistedmelonman

Nine of my 32 non-fork repos carry a tracked AGENTS.md, and seven of those have been mechanically substituted from a copy of CLAUDE.md: every "Claude" became "Codex," including the ones inside file paths. The result is a tracked file telling a reader to edit .Codex-plugin/plugin.json and that my global infrastructure lives at ~/.Codex/. Neither path exists.

smartwatermelon/pr-review is the worst of them. Five hits, including this:

This file provides guidance to Codex (Codex.ai/code) when working with code in this repository.
...
The `.Codex/` directory (note: no hyphen, different from `.Codex-plugin/`) is boilerplate
from a local git template (project-specific config/hook scaffolding for Andrew's global
Codex infrastructure at `~/.Codex/`).

I don't use Codex, nothing in any repo reads AGENTS.md, and I'd rather not maintain another tool's config by hand. So the fix is to stop tracking it rather than to repair the substitution.

Per repo:

git rm AGENTS.md
printf 'AGENTS.md\n' >> .gitignore

.gitignore rather than .git/info/exclude, since the intent is permanent and other people should see it. Worth remembering that the ignore rule alone does nothing to a file that's already tracked: without the git rm, git keeps tracking it and the rule is silently inert.

Already done in twistedmelonman/personify as part of the 2.0 changeset. The remaining eight, with substitution hit counts:

repo hits
smartwatermelon/pr-review 5
smartwatermelon/dev-env 2
smartwatermelon/claude-code-workflows-agents 2
twistedmelonman/huddle-transcribe 1
smartwatermelon/gmail-newsletter-filter 1
nightowlstudiollc/amelia-boone 1
smartwatermelon/mac-server-setup 0
nightowlstudiollc/tnjcleaning 0

The two at zero are clean copies with no bad paths. They still go, for the same reason: nothing reads them.

smartwatermelon/repo-template doesn't ship one, so nothing regenerates these. Whatever created them was per-repo and is not still running.

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions