Frontmatter Parsing Error: Missing 'name' Field Despite Valid YAML

Bug Description

• The persistent error: "Missing required 'name' field in frontmatter"
• That it affects all agent files despite proper YAML formatting
• The /doctor command continues to fail after multiple formatting attempts Here's a summary of what we attempted:

Troubleshooting Steps Completed

1. YAML Format Testing: Tried both quoted and unquoted field values
2. Character Encoding: Checked for hidden characters and encoding issues
3. Schema Compliance: Added all required fields (name, description, tools) per

official documentation

1. Minimal Testing: Created test files to isolate the issue
2. Documentation Research: Verified we're following the exact format specified in

Claude Code docs

Current Status

All agent files now have proper frontmatter that should parse correctly:
---
name: agent-name
description: Agent description
tools: Read, Write, Edit, Bash, Glob, Grep, TodoWrite
---

Environment Info

• Platform: linux
• Terminal: vscode
• Version: 1.0.88
• Feedback ID: a942567c-9da8-44af-a221-c31589b22d21

Errors

[{"error":"Error: Agent file /home/jose-a-pichardo/taprideit_enterprise/.claude/agents/planning-agent.md is missing required 'name' in frontmatter\n    at IJ5 (file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:6763)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5236\n    at Array.map (<anonymous>)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5166\n    at async file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2441:5084","timestamp":"2025-08-22T20:09:26.020Z"},{"error":"Error: Agent file /home/jose-a-pichardo/taprideit_enterprise/.claude/agents/security-agent.md is missing required 'name' in frontmatter\n    at IJ5 (file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:6763)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5236\n    at Array.map (<anonymous>)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5166\n    at async file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2441:5084","timestamp":"2025-08-22T20:09:26.025Z"},{"error":"Error: Agent file /home/jose-a-pichardo/taprideit_enterprise/.claude/agents/agent-routing.md is missing required 'name' in frontmatter\n    at IJ5 (file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:6763)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5236\n    at Array.map (<anonymous>)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5166\n    at async file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2441:5084","timestamp":"2025-08-22T20:09:26.026Z"},{"error":"Error: Agent file /home/jose-a-pichardo/taprideit_enterprise/.claude/agents/repo-engineer.md is missing required 'name' in frontmatter\n    at IJ5 (file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:6763)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5236\n    at Array.map (<anonymous>)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5166\n    at async file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2441:5084","timestamp":"2025-08-22T20:09:26.027Z"},{"error":"Error: Agent file /home/jose-a-pichardo/taprideit_enterprise/.claude/agents/devops-agent.md is missing required 'name' in frontmatter\n    at IJ5 (file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:6763)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5236\n    at Array.map (<anonymous>)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:5166\n    at async file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2441:5084","timestamp":"2025-08-22T20:09:26.028Z"},{"error":"Error: Agent file /home/jose-a-pichardo/taprideit_enterprise/.claude/agents/frontend-agent.md is missing required 'name' in frontmatter\n    at IJ5 (file:///home/jose-a-pichardo/.nvm/versions/node/v22.18.0/lib/node_modules/@anthropic-ai/claude-code/cli.js:2401:6763)\n    at file:///home/jose-a-pichardo/.nvm/versions/node/v22.

Note: Error logs were truncated.