Mohammad's personal coding rules and development guidelines, organized by category.
They apply to every Laravel 13 + Livewire project (Livewire 3/4, Alpine, Tailwind, Pest, PHP 8.4). Start with How to read these rules for the [H] / [+] tags and the MUST / SHOULD levels.
| Folder | What's in it |
|---|---|
general/ |
How to read the rules, code quality (PHP style, Pint, PHPStan, honest hand-offs) |
architecture/ |
Layering and patterns: thin controllers/Livewire, service layer, policies, enums, DTOs |
frontend/ |
Views and components (no inline PHP/CSS/JS, cards not tables, accessibility) and routes and screens |
backend/ |
Data and performance: migrations, money types, indexes, N+1, queues, transactions |
i18n/ |
Translations: per-feature lang bundles, every locale, RTL for Arabic |
security/ |
Security: rate limiting, policies, tenant scoping, soft deletes, audit log |
testing/ |
Testing: Pest rules and the pre-hand-off self-check |
git/ |
Git workflow: branch from develop, conventional commits, PR contents |
ai-agents/ |
CLAUDE.md, the short prompt to paste into a project's CLAUDE.md or AGENTS.md |
originals/ |
The original source files, unchanged: CLAUDE.md and Mohammad-Development-Rules.pdf |