09:13بعد دقيقة
الـ AI بيرد في ثواني. الكود بيعمل compile، واللستة بتظهر.
غالبًا كنت هتعمله merge. أغلب كود Angular على الإنترنت شكله كده، فده اللي الموديل بيتعلم يكتبه.
Angular 22 · TypeScript 6.0 · signals · NgRx SignalStore
Angular Philosophies هو الطريقة اللي بكتب بيها Angular، متكتبة: اتناشر فصل تقراهم، ونفس النصايح كـ 132 قاعدة يمشي عليها الـ AI اللي بتستخدمه وهو شغال. لـ Angular 22.
order-list.component.ts+377 تعليقات مراجعة
اختار الأداة. كل سطر بيضيف نفس القواعد.
الـ skill و MCP server في خطوة واحدة. الـ skill بيتحمّل لما تشتغل على Angular.
/plugin marketplace add tomavic/angular-philosophies
/plugin install angular-philosophies@angular-philosophiesملف AGENTS.md تحطه في root المشروع، لـ Codex وCopilot وGemini CLI وغيرهم.
curl -o AGENTS.md https://raw.githubusercontent.com/tomavic/angular-philosophies/main/ai/AGENTS.mdشغّله من root المشروع. القواعد هتنزل في .cursor/rules.
mkdir -p .cursor/rules && curl -sSL https://github.com/tomavic/angular-philosophies/archive/refs/heads/main.tar.gz | tar -xz --strip-components=3 -C .cursor/rules angular-philosophies-main/ai/cursorمفيش وصول للملفات؟ اديله llms-full.txt، الدليل كله في ملف واحد.
https://raw.githubusercontent.com/tomavic/angular-philosophies/main/ai/llms-full.txtلو مشروعك ليه قواعده، اكتبها فوق القواعد المتولّدة. المشروع بيكسب على الدليل.
اتناشر فصل، كل واحد بيخلص بقواعده. وقتك ضيق؟ ابدأ بـ 03.
البنية
00الفلسفةابني اللي محتاجه وبس، حط كل نوع كود في مكان واحد، واجعل الصح هو الأسهل.6 قواعد 01المعماريةازاي الـ workspace بيتقسم لـ domains وطبقات، وإيه اللي يقدر يعمل import لإيه، وفين الكود الجديد يروح.11 قاعدة 02الـ Componentscomponents standalone وبدون zone، بـ signal APIs وtemplates بسيطة، وتسمية الملفات.14 قاعدةالـ State
03الـ signal store ابدأ هناشكل الـ store: الـ facade، وstore لكل صفحة، ومين اللي بيعمله provide.15 قاعدة 04الوصول للبياناتالقراية بـ resources، والكتابة بـ mutations، وإيه اللي بيفضل لما الـ reload يفشل.13 قاعدة 05الـ toolkitأنهي extensions تستخدمها، وأنهي تستنى عليها، وأنهي تبعد عنها.8 قواعد 06الـ store features المخصصةاكتب الـ feature الخاص بيك، وخلّي الـ stores تتكلم مع بعض بـ events.8 قواعدالجودة
07الفورم والـ routing والترجمة والـ RTLReactive Forms، وroutes بتتحمّل lazy، والترجمة، وlayouts بتتقلب للعربي.14 قاعدة 08إمكانية الوصولتباين بتقيسه، وكيبورد وfocus، ومعنى مش معتمد على اللون.12 قاعدة 09الاختباراتازاي تكتب spec في سبع خطوات، بـ fakes بدل الـ stubs.15 قاعدة 10الأدواتpnpm وNx وTypeScript strict وlint وformat وcommits وhooks.12 قاعدة09:12الصبح، أول اليوم
بتفتح Claude Code أو Cursor أو Copilot، وتكتب سطر واحد: عايز صفحة طلبات فيها بحث وتقسيم صفحات. نوع الصفحة اللي في كل app منها عشرة.
Add an orders list page with filters.
09:13بعد دقيقة
غالبًا كنت هتعمله merge. أغلب كود Angular على الإنترنت شكله كده، فده اللي الموديل بيتعلم يكتبه.
09:14بعد دقيقتين
كل تعليق بيقتبس قاعدة من الدليل بالحرف، وبيقول إيه اللي هيبوظ لو اتجاهلتها.
Angular Philosophiesسطر 4 · 1 من 7
Import through path aliases (@shop/..., @/...); never use ../../ across feature or library boundaries.
التلات مستويات ../ دي بتقول الملف قاعد فين، مش هو إيه. انقل الـ feature وكل import زي ده هيتكسر.
01 · المعماريةAngular Philosophiesسطر 16 · 2 من 7
Inject dependencies with inject() in field initialisers; do not use constructors for injection.
طريقة واحدة للـ inject في كل حتة: الـ components والـ functions والـ store features كلها بتستخدم inject()، ومفيش حاجة معتمدة على ترتيب الـ constructor.
02 · الـ ComponentsAngular Philosophiesسطر 11 · 3 من 7
Give every resource a defaultValue and { errorHandling: 'previous value' }; never write ?. or ?? on a resource value in a component.
فالـ template بيتملي ?. والـ empty state بيظهر لحظة قبل أول صفحة.
04 · الوصول للبياناتAngular Philosophiesسطور 2، 16، 29، 30 · 4 من 7
Make a signalStore the facade, API layer and state layer for its slice; components never inject HttpClient or a data service.
كده الـ component شايل الـ URL والـ params والـ error handling، والصفحة الجاية هتنسخ التلاتة.
03 · الـ signal storeAngular Philosophiesسطور 3، 14، 28، 31، 34، 35 · 5 من 7
Never call .subscribe() in a component; use signals, resources or rxMethod.
كل subscribe هو leak مستني unsubscribe اتنسى. ودي محتاجة تتقفل في مكانين أصلًا.
03 · الـ signal storeAngular Philosophiesسطور 19، 24، 27 · 6 من 7
Never add a load() method that a component must call after a filter changes; derive reads from state with resources.
ضيف فلتر status بكرة، انسى نداء واحد، واللستة هتفضل تعرض النتيجة القديمة من غير ما حد ياخد باله.
03 · الـ signal storeAngular Philosophiesسطور 22، 23 · 7 من 7
Reset page to 1 in every filter setter.
ابحث وإنت في صفحة 3، والسيرفر هيرجّع صفحة 3 من النتايج. غالبًا فاضية، فاليوزر هيفتكر إن مفيش حاجة طابقت. ودي bug حقيقية.
03 · الـ signal storeأو الـ AI يقرا الدليل قبل ما يكتب أول سطر.
09:20بعد 8 دقايق من أول طلب
الـ component بيصغر لحد ما يبقى اللي الصفحة المفروض تكونه: store وtemplate. كل اللي كان بيعمله بإيده راح لـ store بيقرا من الـ state. من 9:12 لـ 9:20: تمان دقايق، ومفيش حاجة محتاجة تتصلّح.
ده الـ store اللي الـ AI بيكتبه وهو ماشي على الدليل. ونفس الكود موجود في الدليل نفسه ومتجرّب: بيعمل compile، وليه tests بتعدّي.
خلاصة خبرة السنين في شكل جديد، تقدر تستعمله مع الـ AI، وكأني أنا موجود معاك وبقولك على كل النصايح وإنت شغال.