Follow Discord
Sweep 22 Oct 2026 · 21:04Z Build v2.1.309 528 read Stable v2.1.308 Latest v2.1.308 Next v2.1.309 Feeds RSS JSON llms.txt llms-full.txt Unofficial

Claude Code v2.1.233 ·

Frontmatter errors now say what actually happens at load time

Broken frontmatter errors now tell you what will actually happen to that component at load time.

You'll notice Improvements
JSON All of v2.1.233
You'll noticeTier: how much it should matter to you
2Useful: my rating, 1 to 5
1Signal: worth watching, 1 to 5
PluginsArea: what it touches
ImprovementsKind: in v2.1.233,
ImprovementsSection of the release
What

When a component's YAML frontmatter fails to parse, the validator tells you the runtime consequence for that specific component type rather than a generic parse error.

Details
  • A project agent does not load at all and is treated as a co-located reference document.
  • A plugin agent loads with its name taken from the filename and every other field dropped.
  • Other component types load with empty metadata.
  • A frontmatter block that parses to null is now accepted as an empty mapping instead of reported as a type error.
Evidence

At runtime this agent loads with its name taken from the filename and every other frontmatter field silently dropped.

Strings lifted out of the shipped bundle, so the claim above can be checked against them.

See this entry in the whole of v2.1.233 →

Feedback