Problem
CLAUDE.md / .agent/AGENTS.md still describe a planned, not-yet-exposed --gitignore-global flag ("Global gitignore support is planned but not exposed until implemented", "Do not expose --gitignore-global until it is implemented and tested"). That capability has since shipped under a different surface: agent-init init --visibility=global-default (#52, PR #61), which writes a managed block to the machine-wide global excludes file with the idempotent managed-block + machine-wide-warning behavior the planned flag specified.
The canonical instructions now contradict the implemented CLI.
Why it matters
.agent/AGENTS.md (symlinked as CLAUDE.md) is the source of truth agents read before working in this repo. Describing --gitignore-global as unimplemented/forbidden while --visibility=global-default already delivers it will mislead future contributors and agents, and risks someone re-implementing it under the old flag name.
Acceptance criteria
Notes
Touches this repo's own .agent/ canonical instructions, which are normally off-limits to edit without explicit ask — this issue is that explicit authorization once it's picked up. Best done after #61 merges.
Problem
CLAUDE.md /
.agent/AGENTS.mdstill describe a planned, not-yet-exposed--gitignore-globalflag ("Global gitignore support is planned but not exposed until implemented", "Do not expose--gitignore-globaluntil it is implemented and tested"). That capability has since shipped under a different surface:agent-init init --visibility=global-default(#52, PR #61), which writes a managed block to the machine-wide global excludes file with the idempotent managed-block + machine-wide-warning behavior the planned flag specified.The canonical instructions now contradict the implemented CLI.
Why it matters
.agent/AGENTS.md(symlinked asCLAUDE.md) is the source of truth agents read before working in this repo. Describing--gitignore-globalas unimplemented/forbidden while--visibility=global-defaultalready delivers it will mislead future contributors and agents, and risks someone re-implementing it under the old flag name.Acceptance criteria
--gitignore-globalreferences in.agent/AGENTS.md(and any inCLAUDE.md/docs) to describe the shipped--visibility=global-defaultmode instead, or explicitly note--gitignore-globalwas superseded by it.docs/cli.mdand README describe--visibility=global-defaultconsistently (PR feat(cli): support --visibility=global-default machine-wide ignore (#52) #61 already adds these; confirm no stale--gitignore-globalmention remains).Notes
Touches this repo's own
.agent/canonical instructions, which are normally off-limits to edit without explicit ask — this issue is that explicit authorization once it's picked up. Best done after #61 merges.