CRITICAL: Mandatory rules for AI agents. Non-compliance will result in rejected code.
Use agent_harness for all agent interactions
- Use
.yamlfor ALL YAML files (NOT.yml) - Use
.mdfor ALL Markdown files (NOT.MD,.markdown) - Use
.rsfor ALL Rust files
CI/CD pipelines expect .yaml. Using .yml causes build failures.
- Use
lowercase_with_underscores.mdfor all documentation files README.md,LICENSE.md,CONTRIBUTING.md,CODE_OF_CONDUCT.md,AGENTS.md, andCHANGELOG.mdare the ONLY exception to the lowercase rule- Never use CamelCase, kebab-case, spaces, or uppercase
Inconsistent naming breaks documentation links.
- No emojis in code, comments, documentation, or commit messages
- Exception: This AGENTS.md file only
Emojis cause encoding issues and break tooling.
Run in this order before claiming any task complete:
markdownlint --fix --config .markdownlint.json "${FILE}"
prettier --write --parser markdown --prose-wrap always "${FILE}"Stop immediately and fix if any command fails.
- Never skip documentation because "code is self-documenting"
Do not write custom scripts for tasks that can be accomplished with the agent tools.
Do not run git commands. The user handles all git interactions.
This file is updated as new patterns emerge.