🔬 اكتشف ما يفعله نظامك حقًا وأين تكمن المخاطر.
تقرأ مرحلة detect الكود ولا تسجّل إلا ما تجده فعلًا، مع الأدلة التي تحتاجها المراحل اللاحقة. وقاعدتها الحاكمة هي الاكتشاف، لا الاختلاق.
طريقة الاستخدام
- فحص كامل
- حدّد المسارات
- صِف مصدر قلق
/lagune-detect
/lagune-detect src/routes/ src/auth.ts
/lagune-detect تأكد من أن بيانات العملاء لا تُكشف أبدًا
ما يرصده
يقرأ Lagune الكود ويرصد ما يجده. تحمل كل ملاحظة ماهيتها، وسبب أهميتها، والدليل عليها. على سبيل المثال:
- رفع الملفات، يقبل النظام ملفات من المستخدمين:
- سبب الأهمية: قد يخفي ملف متنكر في صورة كودًا خبيثًا.
- الدليل: يثق الـ handler الخاص بـ
POST /uploadبنوع MIME الذي يرسله العميل، دون التحقق من النوع الحقيقي للملف.
- تسجيل الدخول والجلسات، يسجّل المستخدمون الدخول للوصول إلى حساباتهم:
- سبب الأهمية: ضعف إدارة الجلسات يسمح بالاستيلاء على حساب من حساب آخر.
- الدليل: منطق إصدار الجلسات، حيث تُصدر الجلسات دون تحديد مدة انتهاء.
وفي الطريق، تمنح مرحلة detect كل تخصص في كتالوج مشروعك حكمًا مقابل الكود، وتطبّق التخصصات التي يتوفر سياقها، وتسجّلها تحت Applied specializations، وهي القائمة التي تعيد مرحلتا harden و verify استخدامها.
ومن هنا تحصل على خريطة واضحة لما يفعله نظامك وأين تكمن المخاطر، جاهزة لتعمل عليها الخطوات التالية.
- تشغيلها مجددًا يحدّث الخريطة: تختفي الملاحظات التي حُلّت، وتظهر الجديدة.
- تُحفظ خريطة detect في
.lagune/memory/detect.md.
التالي
حوّل الخريطة إلى خطة: /lagune-plan.
الأسئلة الشائعة
يقرأ الكود ويرصد ما يفعله نظامك وأين تكمن المخاطر، ولا يسجّل إلا ما يجده فعلًا. وقاعدته هي الاكتشاف، لا الاختلاق.
الملاحظة خطر واحد مكتشف، تحمل ماهيته، وسبب أهميته، والدليل عليه في الكود. وهي الوحدة المتتبَّعة التي تحملها مراحل plan و harden و verify إلى الأمام.
في .lagune/memory/detect.md.
يحصل كل تخصص في كتالوج مشروعك على حكم مقابل الكود. وتطبّق مرحلة detect التخصصات التي يتوفر سياقها وتسجّلها تحت Applied specializations.
