[BUG] Please reopen #6377 ("Frontmatter Parsing Error: Missing 'name' Field Despite Valid YAML")

Preflight Checklist

• [x] I have searched existing issues and this hasn't been reported yet
• [x] This is a single bug report (please file separate reports for different bugs)
• [x] I am using the latest version of Claude Code

What's Wrong?

This is NOT a new bug, but it definitely has not been resolved, and all dupes have been closed/dupe, or closed/inactive, except for #6377, which github-actions "Closed as not planned"(?!) last week.

My info:

Operating System: Fedora 43 6.18.3-200.fc43.x86_64
Terminal: ghostty 1.2.3-2.fc43

However:

According to (closed) issues (and, based on my dumpster-diving here, in unrelated issue's error logs), this has happened on all platforms, and many versions: current and even pre-2.0.

Definitely an issue, with latest (2.1.2, as of this post).

This has been appearing consistently in unrelated error logs in tens of GH issues since Aug/Sept '25.

AFAICT, this breaks agents completely, as none are even discovered.

Great Catch-22 btw: can't omit name; any attempt to include name causes error.

What Should Happen?

Claude should discover, load, and use agents defined in .md files with valid front-matter

Error Messages/Logs

/doctor

 Agent Parse Errors
 └ Failed to parse 8 agent file(s):
   └ ~/.claude/agents/code-reviewer.md: Missing required "name" field in frontmatter
   └ ~/.claude/agents/js-debugger.md: Missing required "name" field in frontmatter
   └ ~/.claude/agents/le-dépôt-ménager.md: Missing required "name" field in frontmatter
   └ ~/.claude/agents/py-debugger.md: Missing required "name" field in frontmatter
   └ ~/.claude/agents/swe-master-prompter.md: Missing required "name" field in frontmatter
   └ ~/.claude/agents/unstucker.md: Missing required "name" field in frontmatter
   └ ~/.claude/agents/test-automator.md: Missing required "name" field in frontmatter
   └ ~/.claude/agents/python-pro-coder.md: Missing required "name" field in frontmatter

Steps to Reproduce

1. Create agent.md file, with e.g.

---
name: code-reviewer
---

<valid Markdown agent definition>

1. Load/Re-load claude-code
2. Run /doctor

Claude Model

Not sure / Multiple models

Is this a regression?

Yes, this worked in a previous version

Last Working Version

Sorry, not certain. Probaby pre-August '25.

Claude Code Version

2.1.2 (Claude Code)

Platform

Google Vertex AI

Operating System

Other Linux

Terminal/Shell

Other

Additional Information

All of

• #6709
• #6868
• #6950
• #7280
• #7281
• #7303
• #7448
• #7794
• #7850
• #7903

contain this exact error, during the time span in question (Aug-Sep '5 -- present), in spite of none actually being filed for this exact issue.