من المؤسسFrom the Founder العلومScience التعلم الغامرImmersive Learning القوالبTemplates الإضافةExtension
تقنيةTech
30 ي30d
اكتب CLAUDE.md إنتاجي لأي codebase خلال 21 يومWrite a Production-Grade CLAUDE.md for Any Codebase in 21 Days
تقنيةTech

اكتب CLAUDE.md إنتاجي لأي codebase خلال 21 يوم Write a Production-Grade CLAUDE.md for Any Codebase in 21 Days

تدقيق قاعدة كود قائمة، وكتابة أقسام المعمارية والقواعد والأوامر في ملف CLAUDE.md في الجذر، واختبار الملف أمام جلسات Claude Code جديدة، ثم تثبيت وثيقة تعريف تجعل Claude يجيب عن أسئلة خاصة بالكود دون سياق إضافي. Audit an existing codebase, write Architecture, Rules, and Commands sections in a root CLAUDE.md, test the file against fresh Claude Code sessions, and commit a briefing document that lets Claude answer codebase-specific questions without extra context.

4 نتائج رئيسية4 key results ·35 مهمة35 tasks ·30 يوم30 days
⏱ 30 يوماً30 Days

ابدأ هذه الخطة مجاناً Start This Plan — Free

لا يلزم بطاقة ائتمانية · مجاني للبدء No credit card · Free to start

إيه اللي هتحصله مع زالفولWhat You Get with Zalfol

🐟

Goldfish ModeGoldfish Mode

مهمة واحدة في كل مرة، مؤقتة، بدون تشتيتOne task at a time. Timed. No distractions.

⬡

CEO ModeCEO Mode

خطة كاملة، منظمة، مع تتبع حقيقيFull plan. Organized. With real tracking.

🗑

صندوق الإفراغDump Box

كل حاجة في دماغك — افرغها هنا الأولEverything in your head — dump it here first.

الخطةThe Plan

1
اكتمال تدقيق قاعدة الكودCodebase Audit Complete
20%
✓ افتح root فولدر الكود. اعمل ملف `audit-notes.md` في الـ root. ضيف عناوين: `Folders`, `Key files`, `Data model`, `Rules`, `Commands`, `Test gaps`.Open the codebase root folder. Create `audit-notes.md` in the root. Add headings: `Folders`, `Key files`, `Data model`, `Rules`, `Commands`, `Test gaps`. 5 دmin
✓ افتح root فولدر الكود. اكتب كل فولدر في depth 1. لكل فولدر اكتب جملة واحدة: بيحتوي على إيه ومش بيحتوي على إيه. احفظ القائمة تحت `Folders` في `audit-notes.md`.Open the codebase root folder. List every folder at depth 1. For each folder, write one sentence: contents and excluded contents. Save the list under `Folders` in `audit-notes.md`. 5 دmin
✓ افتح Claude Code. ابدأ session جديدة من غير context. اسأل `What does this project do? What is the primary data model? What framework is used?` وسجّل كل سؤال Claude يطلبه في `audit-notes.md`.Open Claude Code. Start a fresh session with no context. Ask `What does this project do? What is the primary data model? What framework is used?` Log every question Claude asks back in `audit-notes.md`. 5 دmin
✓ افتح قائمة ملفات الـ root. حدد أكبر 10 source files بعدد السطور. اكتب path وعدد السطور ووظيفة سطر واحد تحت `Key files` في `audit-notes.md`.Open the root file list. Identify the 10 largest source files by line count. Write file path, line count, and one-line purpose under `Key files` in `audit-notes.md`. 5 دmin
✓ افتح ملفات database أو schema أو models أو migrations. اكتب الـ entities الأساسية وأسماء الأعمدة الغريبة وقواعد العلاقات تحت `Data model` في `audit-notes.md`.Open database, schema, model, or migration files. Write the primary entities, unusual column names, and relationship rules under `Data model` in `audit-notes.md`. 5 دmin
✓ افتح commits قديمة أو README notes أو issue comments. اكتب 8 قرارات غير موثقة صاحب المشروع عارفها تحت `Rules` في `audit-notes.md`.Open old commits, README notes, or issue comments. Write 8 undocumented decisions the builder already knows under `Rules` in `audit-notes.md`. 5 دmin
✓ افتح 3 ملفات اتغيرت قريب وكتبها ناس تانية. لكل ملف اكتب نمط التسمية والتعامل مع الأخطاء والاعتمادات تحت `Rules` في `audit-notes.md`.Open three recently changed files written by other people. For each file, write the observed naming, error handling, and dependency pattern under `Rules` in `audit-notes.md`. 5 دmin
✓ افتح notes بتاعة production bugs أو TODO comments أو hotfix commits. اكتب 5 قواعد موجودة عشان bug حصل قبل كده تحت `Rules` في `audit-notes.md`.Open production bug notes, TODO comments, or hotfix commits. Write 5 rules that exist because a bug already happened under `Rules` in `audit-notes.md`. 5 دmin
✓ افتح `package.json` وملفات build config وenvironment examples وdeployment config. اكتب runtime JavaScript والـ scripts والـ env vars وهدف النشر تحت `Commands` في `audit-notes.md`.Open `package.json`, build config, environment example files, and deployment config. Write JavaScript runtime, scripts, env vars, and deployment target under `Commands` in `audit-notes.md`. 5 دmin
✓ افتح ملفات Python settings وdependencies وmigrations وentrypoints. اكتب أمر virtual environment وsettings module والـ ORM وأمر migrations تحت `Commands` في `audit-notes.md`.Open Python settings, dependency, migration, and entrypoint files. Write virtual environment command, settings module, ORM, and migration command under `Commands` in `audit-notes.md`. 5 دmin
✓ افتح ملفات mobile build وplatform وsigning وenvironment. اكتب targets التطبيق وأوامر simulator وملاحظات signing وقيود كل platform تحت `Commands` في `audit-notes.md`.Open mobile build, platform, signing, and environment files. Write app targets, simulator commands, signing notes, and platform-specific constraints under `Commands` in `audit-notes.md`. 5 دmin
2
اختبار المعمارية والقواعدArchitecture and Rules Tested
30%
✓ افتح `audit-notes.md`. اعمل section باسم `CLAUDE.md outline` بعناوين: `Last updated`, `Project overview`, `Architecture`, `Rules`, `Commands`, `Testing checklist`, `Known traps`.Open `audit-notes.md`. Create a `CLAUDE.md outline` section with headings: `Last updated`, `Project overview`, `Architecture`, `Rules`, `Commands`, `Testing checklist`, `Known traps`. 5 دmin
✓ افتح `CLAUDE.md` في root المشروع. ضيف `Last updated: 2026-05-03` و`Project overview` من 3 جمل يذكر هدف المنتج والمستخدم والـ workflow الأساسي.Open `CLAUDE.md` in the project root. Add `Last updated: 2026-05-03` and a 3-sentence `Project overview` that names product purpose, user, and primary workflow. 5 دmin
✓ افتح `audit-notes.md`. اكتب section `Architecture` في `CLAUDE.md` وفيه stack lines وfolder map وdata flow وkey files بعدد السطور وmental model من جملتين.Open `audit-notes.md`. Write the `Architecture` section in `CLAUDE.md` with stack lines, folder map, data flow, key files with line counts, and a 2-sentence mental model. 5 دmin
✓ افتح session جديدة في Claude Code. الصق section `Architecture` بس. اسأل `Describe the system architecture and identify the file that handles [core function]`. عدّل `CLAUDE.md` لحد ما الإجابة تبقى صح.Open a fresh Claude Code session. Paste only the `Architecture` section. Ask `Describe the system architecture and identify the file that handles [core function]`. Revise `CLAUDE.md` until the answer is correct. 5 دmin
3
اكتمال قسم الأوامرCommands Section Complete
25%
4
تثبيت CLAUDE.md ونجاحهCLAUDE.md Committed and Passing
25%

+ 20 مهمة أخرى — استورد الخطة عشان تشوفهم كلهم+ 20 more tasks — import the plan to see them all

النجاح شكله إيهWhat Success Looks Like

تظهر نافذة الطرفية في جذر المستودع. تقرأ جلسة Claude Code جديدة ملف CLAUDE.md، وتجيب عن خمسة أسئلة معمارية دون طلب سياق، وتسمّي الملف الدقيق للمسار الأساسي، بينما يعرض سجل Git رسالة `docs: add CLAUDE.md codebase briefing` في الأعلى. A terminal is open in the repository root. A fresh Claude Code session reads CLAUDE.md, answers five architecture questions without asking for context, names the exact file for the core workflow, and the git log shows `docs: add CLAUDE.md codebase briefing` at the top.

التكلفة المتوقعةExpected Costs

البندItem التكلفةAmount مطلوب؟Required?
اشتراك Claude Code ProClaude Code Pro subscription ~1,000 EGP/month ($20/month). Required from Day 1 because the work depends on fresh Claude Code sessions, repeated tests, and enough capacity to revise the file. ✓
تكلفة الوقت لكتابة أول CLAUDE.mdTime cost to write first CLAUDE.md 4-8 focused hours. The return is removing 10-30 minutes of re-briefing from every future Claude Code session and improving onboarding for every developer after that. ✓
استضافة Git والوصول للمستودعGit hosting and repository access 0 EGP if the repository already exists on GitHub, GitLab, Bitbucket, or a local Git remote. Needed only so CLAUDE.md can live beside the code. ✓
⚠️ مصيدة هدر - سوق قوالب CLAUDE.mdWASTE TRAP - CLAUDE.md template marketplace Generic templates cannot know folder responsibilities, broken commands, or the bugs hidden in local patterns. Use examples for structure only, never as the final document. اوفر فلوسكSkip it
⚠️ مصيدة هدر - أدوات مدفوعة لتوليد التوثيقWASTE TRAP - paid documentation generation tools The point is understanding the codebase, not auto-generating prose. Auto docs fail the fresh-session test because they miss why the code is shaped this way. اوفر فلوسكSkip it
⚠️ مصيدة هدر - اشتراك Notion أو Confluence لهذا الاستخدامWASTE TRAP - Notion or Confluence subscription for this use case CLAUDE.md must be a plain text file committed to the repo root. External docs can help humans later, but they do not remove the Claude Code briefing tax. اوفر فلوسكSkip it

المخاطر اللي تاخد بالك منهاRisks to Watch

highhigh
كتابة CLAUDE.md بشكل عام أكثر من اللازمCLAUDE.md written too abstractly
أعد كتابة كل جملة يمكن أن تنطبق على مئة مستودع آخر. السطر المفيد يذكر ملفًا محليًا أو قاعدة محلية أو أمرًا محليًا أو نمط فشل محليًا.Rewrite every sentence that could apply to 100 other repositories. A useful line names a local file, local rule, local command, or local failure mode.
highhigh
تجاوز اختبار الجلسات الجديدةFresh-session testing skipped
شغّل خمس جلسات جديدة واعتبر كل سؤال متابعة فشلًا في الاختبار. أصلح الوثيقة، ثم أعد السؤال نفسه مرة واحدة.Run five fresh sessions and treat every follow-up question as a failed test. Fix the document, then rerun that exact question once.
highhigh
قسم القواعد مبهم أكثر من اللازمRules section too vague
اكتب كل قاعدة بصيغة `Never [action] - [specific breakage]`، وأضف البديل المحلي المقبول عندما يكون موجودًا.Format every rule as `Never [action] - [specific breakage]` and include the accepted local alternative where one exists.
mediummedium
تحول CLAUDE.md إلى وثيقة قديمةCLAUDE.md becomes stale
حافظ على سطر `Last updated` في الأعلى، وحدّث CLAUDE.md في طلب الدمج نفسه لأي تغيير في المعمارية أو الأوامر أو نموذج البيانات.Keep `Last updated` at the top and update CLAUDE.md in the same pull request as any architecture, command, or data model change.
criticalcritical
تثبيت ملاحظات خاصة بالخطأPrivate scratch notes get committed
شغّل `git status` قبل التثبيت ولا تضف إلا CLAUDE.md. احذف ملفات المسودة أو أضفها إلى gitignore بعد اكتمال ملف التعريف.Run `git status` before commit and stage only CLAUDE.md. Delete or gitignore scratch files after the briefing file is complete.

مين هتشتغل معاهمWho You'll Work With

👤
شريك المساءلةAccountability Partner
يتابع اكتمال الاختبارات والتثبيتaccountable
👤
أول قارئ باردFirst Cold Reader
يختبر وضوح الوثيقة دون معرفة سابقةreviewer
👤
عضو الفريق المستقبليFuture Team Member
يستخدم الملف كوثيقة تعريفonboarded
👤
المنفذ كنسخة مستقبليةBuilder as Future Self
يحافظ على الملف بعد تغير الكودowner

الخطة دي بتتكيف مع وضعكThis Plan Adapts to Your Situation

الكود من نوع إيه؟What kind of codebase are being documented?
مشروع بنيته أناMy own project - I built itكود ورثته أو من فريقInherited or team codebase - I did not write most of itكود قديم مش موثقLegacy codebase - old, undocumented, possibly scary
الـ stack الأساسي إيه؟What is the primary stack?
Full-stack JavaScriptFull-stack JavaScript - React, Next.js, NodeBackend PythonPython backend - Django, FastAPI, FlaskموبايلMobile - React Native, Flutter, Swift
مين هيستخدم الـ CLAUDE.md ده؟Who will use this CLAUDE.md?
أنا لوحديJust me - solo developerأنا وفريق صغيرMe plus 1-3 teammatesلأونبوردينج developers جددOnboarding new developers - this is the briefing doc

اقرأ أكترRead More

التعلم العميق — العلم وراء طريقة التلميذ
←
Immersive Learning — The Science Behind Disciple Mode
→
دماغ الـ ADHD: Iron Man أو Dory
←
The ADHD Brain: Iron Man vs. Dory
→

خد الخطوة الأولىTake the First Step

اكتب CLAUDE.md إنتاجي لأي codebase خلال 21 يوم Write a Production-Grade CLAUDE.md for Any Codebase in 21 Days

ابدأ هذه الخطة مجاناً Start This Plan — Free

لا يلزم بطاقة · مجاني للبدء No credit card · Free to start