parser-development
Installation
SKILL.md
Parser Development
Use crates/biome_parser/CONTRIBUTING.md as the canonical parser guide. Read the section matching the current grammar, lexer, parse-rule, or recovery task.
Workflow
- Inspect the language grammar and neighboring parse rules.
- Add or adjust focused
ok/anderror/fixtures before changing recovery behavior. - Update the grammar when the typed tree shape changes.
- Regenerate syntax and factory artifacts after
.ungramchanges. - Implement parser logic with explicit presence tests and bounded recovery.
- Run the language parser's focused tests and inspect snapshots.
Grammar
Grammar files under xtask/codegen/ define typed syntax nodes and fields. Follow existing language naming: