miscellaneous documentation

AGENTS.md

@@ -3,9 +3,9 @@
 ## Project Goal
 Build a reliable, maintainable salon booking platform with Django (backend) and React (frontend), optimized for KSA needs (phone auth, local payments) while keeping a clean path to scale.
 
-## Coding 
+## Coding
 
-- Comment concisely and often as appropriate
+- Comment concisely and often, especially where intent, edge cases, or business rules are not obvious.
 
 ## Current Plan (Roadmap)
 ### Phase 1: Core MVP Reliability
@@ -50,6 +50,7 @@ Build a reliable, maintainable salon booking platform with Django (backend) and
 - Use explicit, readable model fields and serializers.
 - Small, well‑named functions > monolithic handlers.
 - Prefer predictable error responses (HTTP status + `detail`).
+- Prefer short, intent-focused comments over silent complexity.
 
 ## Known Gaps (Tracked)
 - See `docs/risks.md` for current gaps/risks to address.