Skip to content

Prune AGENTS.md of v1 internals deleted at the M11 swap - #907

Merged
derek73 merged 1 commit into
masterfrom
claude/agents-md-maintenance-640b0a
Oct 27, 2026
Merged

derek73 merged 1 commit into
masterfrom
claude/agents-md-maintenance-640b0a

Conversation

@derek73

@derek73 derek73 commented Oct 27, 2026

Copy link
Copy Markdown
Owner

AGENTS.md still described the v1 parser and config machinery that the M11 swap deleted. A session reading it would look for parse_full_name's pipeline, the _derived_* sets, the _SetManagerAttribute/_EmptyAttributeDefaultAttribute descriptors, _join_bound_first_name, join_on_conjunctions or v1's is_suffix. None of them exists in nameparser/ (checked by grep; the names survive only in _facade._V1_HOOKS and comments).

Removed

  • The ### Parser (nameparser/parser.py) section (v1 parse flow).
  • Extension Patterns: adding a scalar or collection Constants attribute, the unknown-key TupleManager warning, and the flag-gated post_process transform.
  • Gotchas: the descriptor paragraphs, the _join_bound_first_name guard, the list.index() lookup in join_on_conjunctions, and the asymmetry in is_suffix().

Rewritten where the lesson still holds

This takes the file from 26,824 to about 25,300 words. I didn't touch the length problem; moving the oversized paragraphs is a follow-up.

Test plan

  • Grepped AGENTS.md and both nested AGENTS.md files for every removed symbol: no dangling references.
  • Checked that the code comments citing AGENTS.md all point at sections that are kept.
  • uv run pytest: 31621 passed.

🤖 Generated with Claude Code

…swap

The Parser section, the v1 Extension Patterns (scalar and collection
Constants attributes, flag-gated post_process transforms, unknown-key
warnings) and six Gotchas described code that has not existed since
2.0: parse_full_name's pipeline, the _derived_* sets, the
_SetManagerAttribute/_EmptyAttributeDefaultAttribute descriptors,
_join_bound_first_name, join_on_conjunctions and v1's is_suffix.

Rewritten rather than dropped where the lesson still holds: the layer
overview, constants=None (a TypeError since #261), the #241 assignment
guard (now in Constants.__setattr__), the parse-never-mutates-config
invariant, the suffix/initial veto in _vocab's names, the C pickle key,
and the xfail and empty-path test advice. 26,824 -> ~25,300 words.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@derek73 derek73 added the docs Documentation fixes and updates label Oct 27, 2026
@derek73 derek73 self-assigned this Oct 27, 2026
@derek73
derek73 merged commit faa8b70 into master Oct 27, 2026
12 checks passed
@derek73 derek73 added this to the 2.7 milestone Oct 27, 2026
@derek73
derek73 deleted the claude/agents-md-maintenance-640b0a branch October 28, 2026 02:21
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation fixes and updates

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant