Code Block Examples Present
The instruction file must contain fenced code blocks with concrete examples. Code blocks are the clearest way to show the agent exact syntax and patterns.
Antipatterns
- Writing commands in inline code (
`npm test`) without any fenced code block. The check looks for fenced code blocks (triple backtick blocks), not inline code spans. - Providing examples only as prose descriptions ("run the test suite, then check coverage"). Without a fenced code block, the agent has no copy-pasteable syntax to follow.
- Including a single empty code block as a placeholder. The check verifies code blocks exist but a trivially empty block provides no value.
Pass / Fail
Pass
# MyProject
## Commands
```bash
uv run pytest tests/ -v
uv run ruff check src/
```
Fail
# MyProject
## Commands
Run `pytest` for tests and `ruff` for linting.
Use the standard test runner.
Limitations
Checks for the presence of code blocks. Does not evaluate whether the code examples are correct or complete.
