- Enforce Understand → Plan → Wait for Approval → Implement → Validate → Review.
- Require agents to read code, load skills, and produce a plan before changing files.
- Add explicit STOP after presenting the plan until user approval.
- Define minimum validation commands and self-review checklist.
- Allow trivial fixes to skip directly to implementation, but still require validation.
- Add 'Mandatory First Step for Agents' section at the top of AGENTS.md.
- Require agents to inspect .agents/skills/ and load all applicable skills before starting work.
- Clarify that skill instructions take precedence over general instructions and that ambiguous or conflicting tasks must stop for user consultation.
- Remove the old bottom 'Skills Reference' section.
- Add 'Any project rule, skill instruction, or requirement is unclear or ambiguous' to the 'When to Ask the User' list.
- Add .agents/skills/review/SKILL.md with a required review checklist covering
project rules, model client rules, pipeline rules, XML rules, and test rules.
- Update AGENTS.md with a dedicated 'Review Stage Rules' section that makes
review mandatory and maps confidence thresholds to XML generation behavior.
- Add review skill to the skills reference.
- Add .ruff_cache/ to .gitignore and keep agent XML templates out of the '*.xml' ignore rule.
fegger