{"id":50542855,"url":"https://github.com/sabrydawood/claude-config","last_synced_at":"2026-06-03T21:30:30.429Z","repository":{"id":359213547,"uuid":"1245050810","full_name":"sabrydawood/claude-config","owner":"sabrydawood","description":"A portable multi-role Claude Code agent system: auto-detection between CTO/PM/Engineer/UI-UX/Growth/BA/DevOps/BD roles + Auto-ADR + Discovery-First + Knowledge base. Arabic-primary.","archived":false,"fork":false,"pushed_at":"2026-05-20T22:06:48.000Z","size":199,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-21T03:25:18.835Z","etag":null,"topics":["agentic-ai","ai-agent","ai-agents","ai-workflow","anthropic","arabic-tech","claude","claude-code","developer-tools","dotfiles","multi-agent","prompt-engineering","system-prompts"],"latest_commit_sha":null,"homepage":"","language":"PowerShell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/sabrydawood.png","metadata":{"files":{"readme":"README.ar.md","changelog":null,"contributing":"CONTRIBUTING.ar.md","funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.ar.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-20T21:29:45.000Z","updated_at":"2026-05-21T02:53:29.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/sabrydawood/claude-config","commit_stats":null,"previous_names":["sabrydawood/claude-config"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/sabrydawood/claude-config","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabrydawood%2Fclaude-config","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabrydawood%2Fclaude-config/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabrydawood%2Fclaude-config/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabrydawood%2Fclaude-config/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/sabrydawood","download_url":"https://codeload.github.com/sabrydawood/claude-config/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/sabrydawood%2Fclaude-config/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33881107,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-03T02:00:06.370Z","response_time":59,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agentic-ai","ai-agent","ai-agents","ai-workflow","anthropic","arabic-tech","claude","claude-code","developer-tools","dotfiles","multi-agent","prompt-engineering","system-prompts"],"created_at":"2026-06-03T21:30:29.509Z","updated_at":"2026-06-03T21:30:30.421Z","avatar_url":"https://github.com/sabrydawood.png","language":"PowerShell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🤖 Claude Code Config — نظام الأدوار المتعدد\n\n\u003e **[English](README.md)** | **العربية**\n\nتكوين شخصي محمول لـ [Claude Code](https://claude.com/claude-code) يحوّله إلى **شريك هندسي متعدد الأدوار** — يغطي وجهات نظر تقنية، منتجية، نموّ، تصميم، أعمال، وبنية تحتية.\n\n---\n\n## 🎯 لماذا نشرت هذا؟ (وما الذي فيه لك)\n\n### أهدافي\n\n1. **🌍 مشاركة مع المجتمع العربي** — التوثيق التقني العميق بالعربية نادر. هذا المشروع يحاول سد جزء من الفجوة.\n2. **🏗️ Portfolio لتفكيري الهندسي** — يعكس كيف أفكر في architecture، products، growth، business — وليس مجرد كود.\n3. **🤝 بداية محادثة** — لمن يريد التعاون أو الاستفسار عن خدماتي، الـ repo يجيب نصف الأسئلة قبل أن تُطرح.\n4. **🔄 تحسين تعاوني** — أنماطكم قد تحسّن نظامي. الـ feedback مفتوح.\n\n### لماذا يهمك أنت؟\n\n#### 👨‍💻 إذا كنت مطوّراً عربياً\n\n- **توفير أسابيع من التجربة والخطأ** — نظام مُجرَّب على مشاريع فعلية، ليس فكرة نظرية\n- **توثيق عربي فصيح** — لا حاجة للترجمة الذهنية المستمرة من الإنجليزية\n- **مرجع جاهز** — `Patterns/` و `Anti-patterns/` يوفران عليك تكرار أخطاء معروفة\n- **قابل للتخصيص بسهولة** — استبدل `PersonalContext.md` بسياقك وستتكيّف التوصيات تلقائياً\n\n#### 🚀 إذا كنت Solo developer أو Founder\n\n- **تفكير بإنتاجية فريق** — 8 أدوار = 8 وجهات نظر متخصصة بدون توظيف\n- **يكسر الـ AI tunnel vision** — بدلاً من رد generic، تحصل على رأي CTO + رأي PM + رأي Growth في القرار الواحد\n- **يمنع الـ Freelancer Trap** — نظام تنبيه تلقائي عند الأنماط التي تستنزف وقتك (deals صغيرة، one-time، إلخ)\n- **Auto-ADR** — قراراتك المعمارية محفوظة بشكل منظم، لا تنسى \"لماذا اخترت X\" بعد 6 أشهر\n\n#### 🤔 إذا كنت تفكر في التعاون معي\n\n- **اطلع على منهجيتي قبل اللقاء** — كيف أحلل، أصمم، أتخذ القرارات\n- **اعرف مستوى التوثيق المتوقع** — هذا ما أنتجه لمشاريعي ولعملائي\n- **اختبر التوافق التقني/الثقافي** — قبل استثمار وقت في discovery calls\n\n#### 🔬 إذا كنت مهتماً بـ AI workflows\n\n- **مثال عملي لـ multi-agent thinking** — وليس \"single prompt\"\n- **Lazy-loaded architecture** — تعلّم كيف تكسر الـ context bloat\n- **Discovery-First protocol** — حل عملي لمشكلة الـ AI hallucinated functions\n\n### كيف تشارك؟\n\n| تريد... | افعل... |\n|---------|---------|\n| **تجربة النظام** | شغّل [الـ one-liner](#-البدء-السريع) — 30 ثانية وتكون جاهزاً |\n| **بناء نسختك الخاصة** | عمل [fork](https://github.com/sabrydawood/claude-config/fork) واستبدل `PersonalContext.md` |\n| **مساهمة pattern أو anti-pattern** | افتح [PR](https://github.com/sabrydawood/claude-config/pulls) — أراجع كل واحد |\n| **سؤال أو نقاش** | افتح [Issue](https://github.com/sabrydawood/claude-config/issues) — تفاعل مفتوح |\n| **التواصل مباشرة** | [GitHub @sabrydawood](https://github.com/sabrydawood) |\n| **مشاركة مع آخرين** | شارك الـ repo مع developer عربي يحاول إتقان Claude Code |\n\n\u003e **لماذا تساهم؟** كل pattern تضيفه يصبح متاحاً لك ولكل مطوّر آخر يستخدم النظام. التحسينات تعود لك أيضاً.\n\n---\n\n## 🎬 شاهده في عمل\n\n\u003c!-- ![Auto-Detection في عمل](docs/screenshots/auto-detection.gif) --\u003e\n\n```text\n                          السؤال\n                            ↓\n   ┌────────────────────────────────────────────────────┐\n   │ \u003e هل أرفع أسعاري من $5K إلى $10K للمشاريع الجديدة؟    │\n   └────────────────────────────────────────────────────┘\n\n                  Auto-Detection يُفعَّل (بدون أمر يدوي)\n                            ↓\n              ┌─────────────────────────────────────┐\n              │ 🎭 Active: Senior PM + BD + Growth   │\n              │ 📌 السبب: قرار تسعير له أبعاد متعددة   │\n              └─────────────────────────────────────┘\n\n                  رد منظم متعدد الأدوار\n                            ↓\n   ┌────────────────────────────────────────────────────┐\n   │ ## 🎯 Product Take — رفع السعر لـ $10K               │\n   │                                                    │\n   │ ### من منظور PM                                     │\n   │ - $5K/مشروع حالياً = $X/ساعة فعلي                    │\n   │ - المضاعفة تحفّز إعادة تصنيف العملاء                 │\n   │                                                    │\n   │ ### من منظور BD                                     │\n   │ - عند $10K، حجم الـ deal يبرر retainer pitch         │\n   │ - تفقد أدنى 30% من الـ leads — selection effect     │\n   │                                                    │\n   │ ### من منظور Growth                                 │\n   │ - حسابات LTV/CAC: عند $10K، LTV/CAC = 4.2× (صحي)    │\n   │                                                    │\n   │ ### التوصية ← A/B test على آخر 3 leads               │\n   │                                                    │\n   │ ✅ سجّلت القرار: Decisions/Global/0003-pricing.md    │\n   └────────────────────────────────────────────────────┘\n```\n\n---\n\n## 🎯 ما هذا؟\n\nهذا الـ repo عبارة عن **تكوين شخصي لـ Claude Code** مصمم للمطورين المنفردين والفرق الصغيرة، ليجعل الـ AI assistant:\n\n- 🎭 **يتحوّل تلقائياً بين 8 أدوار** (CTO, PM, Engineer, UI/UX, Growth, BA, DevOps, BD) حسب السياق — بدون الحاجة لكتابة \"فكّر كـ...\"\n- 📐 **ينشئ Architecture Decision Records (ADRs) تلقائياً** للقرارات التقنية المهمة\n- 🔍 **يستخدم Discovery-First protocol** — يتحقق من الكود الموجود قبل كتابة functions جديدة (يتجنب تكرار اللوجيك)\n- 🧠 **يحافظ على السياق** عبر sessions بواسطة ملفات lazy-loaded\n- 🌐 **يتواصل بالعربية** (الأساس) مع مصطلحات تقنية بالإنجليزية\n- ⚙️ **يعمل مع أي stack** (Bun/Node/Go/Rust/PHP/.NET) مع توجيه stack-specific حسب الحاجة\n\n## 🏗️ بنية الـ Repo\n\n```tree\nclaude-config/\n├── CLAUDE.md                      # الملف الرئيسي (يُحمَّل في كل session)\n├── CommunicationProfiles.md       # 5 أساليب كتابة حسب الجمهور\n├── PersonalContext.template.md    # Template — املأ بياناتك (يبقى محلياً)\n├── settings.template.json         # Settings نظيف — انسخ وعدّل\n├── Roles/                         # 8 أدوار (lazy-loaded)\n│   ├── README.md                  # دليل Auto-Detection\n│   ├── CTO.md\n│   ├── Senior-PM.md\n│   ├── Senior-Engineer.md\n│   ├── UI-UX.md\n│   ├── Growth-Strategist.md\n│   ├── Business-Analyst.md\n│   ├── DevOps-SRE.md\n│   └── Business-Developer.md\n├── Patterns/                      # مكتبة How-tos قابلة للاستخدام\n├── Anti-patterns/                 # سجل الأخطاء الشائعة\n├── Decisions/                     # ADR template + هيكل\n├── Stacks/                        # Gotchas حسب الـ stack\n│   ├── Bun-Hono.md\n│   ├── NextJS.md\n│   └── ... (10 stacks)\n├── agents/                        # Sub-agents مخصصة\n├── commands/                      # Slash commands مخصصة\n├── skills/                        # Skills مخصصة\n└── scripts/                       # Sync scripts\n    ├── install.ps1                # Windows: repo → ~/.claude/\n    ├── install.sh                 # Mac/Linux: repo → ~/.claude/\n    ├── backup.ps1                 # Windows: ~/.claude/ → repo\n    └── sync-check.ps1             # Windows: عرض الفروقات\n```\n\n## 🚀 البدء السريع\n\n### المتطلبات\n\n- [Claude Code](https://claude.com/claude-code) مُثبّت\n- Git\n- PowerShell 5+ (Windows) أو Bash (Mac/Linux)\n\n### ⚡ تثبيت بأمر واحد (موصى به)\n\n**Windows (PowerShell):**\n\n```powershell\nirm https://raw.githubusercontent.com/sabrydawood/claude-config/main/bootstrap.ps1 | iex\n```\n\n**Mac / Linux (Bash):**\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/sabrydawood/claude-config/main/bootstrap.sh | bash\n```\n\nهذا كل ما تحتاجه. الـ bootstrap سيقوم بـ:\n\n1. عمل clone للـ repo إلى `~/claude-config`\n2. نسخ احتياطية لـ `~/.claude/` الموجود (بـ timestamp)\n3. تثبيت كل ملفات التكوين\n4. إنشاء `PersonalContext.md` و `settings.json` من الـ templates\n\n### تثبيت يدوي (بديل)\n\n```powershell\n# Windows\ngit clone https://github.com/sabrydawood/claude-config.git\ncd claude-config\n.\\scripts\\install.ps1\n```\n\n```bash\n# Mac / Linux\ngit clone https://github.com/sabrydawood/claude-config.git\ncd claude-config\nbash scripts/install.sh\n```\n\n### بعد التثبيت\n\n- عدّل `~/.claude/PersonalContext.md` — املأ سياقك التجاري\n- عدّل `~/.claude/settings.json` — أضف صلاحياتك/hooks/أسرارك\n- أعد تشغيل Claude Code لتحميل التكوين الجديد\n\n## 🧠 كيف يعمل نظام الأدوار المتعددة\n\n### Auto-Detection (الكشف التلقائي)\n\nعند طرح سؤال، يكتشف الـ Agent تلقائياً أي دور (أو أدوار) يجب تفعيله حسب السياق:\n\n| إذا سألت... | الأدوار المُفعّلة |\n|------------|------------------|\n| \"هل أرفع أسعاري؟\" | PM + BD + Growth |\n| \"كيف أوسّع هذا الـ API؟\" | DevOps + CTO |\n| \"قيّم هذا العرض للشراكة\" | BD + BA |\n| \"هل أبني هذه الـ feature؟\" | PM + CTO |\n| \"لماذا users بيتركوا؟\" | Growth + PM |\n\nBanner يظهر في بداية الرد مع الأدوار النشطة + السبب.\n\n### الوضع الافتراضي\n\nالـ Agent يعمل في **CTO + Senior PM mode افتراضياً** — يخطط ويحلل لكن **لا يكتب كود** إلا بإذن صريح (\"نفّذ\" / \"implement this\").\n\n### Auto-ADR\n\nعندما يتخذ الـ Agent قراراً معمارياً مهماً (اختيار stack، vendor، إلخ)، ينشئ Architecture Decision Record في `Decisions/` تلقائياً.\n\n### Discovery-First Coding\n\nقبل كتابة أي كود، الـ Agent مُلزم بـ:\n\n1. قراءة الـ context الكامل (الملف + types + interfaces)\n2. البحث عن implementations موجودة (عبر Serena MCP)\n3. التحقق من الفهم مع المستخدم\n4. ثم الكتابة\n\nهذا يمنع نمط \"تكرار اللوجيك\" الشائع في توليد كود AI.\n\n## ⚙️ التكوين\n\n### `PersonalContext.md` (Template-based)\n\nبعد التثبيت، عدّل `~/.claude/PersonalContext.md` بـ:\n\n- حجم فريقك وتخصصك\n- الأهداف السنوية + تركيز الربع الحالي\n- المشاريع النشطة ونموذج العملاء\n- تفضيلات Stack الافتراضية\n- تفضيلات التواصل\n- ما لا تريد الـ Agent يفعله\n\nهذا الملف **gitignored** — بياناتك الشخصية تبقى على جهازك.\n\n### `settings.json` (Template-based)\n\nعدّل الصلاحيات والـ hooks والـ MCP servers. **لا تـ commit ملف `settings.json` أبداً** — قد يحتوي على:\n\n- Database connection strings مع passwords\n- API tokens\n- مسارات تكشف بنية المشروع\n\n### MCP Servers الموصى بها\n\nهذا التكوين محسّن لـ MCP servers التالية (اضبطها بشكل منفصل):\n\n- **Serena** — Code intelligence (`find_symbol`, `search_for_pattern`)\n- **code-review-graph** — Per-project code graph لتحليل المخاطر\n\n## 🎓 اللغات\n\n- **الأساسية:** العربية — للمحادثات الطبيعية مع Sabry\n- **التقنية:** الإنجليزية — للكود، frameworks، والمصطلحات القياسية\n\nالنظام مصمم للمطورين العرب لكن المحتوى التقني (frameworks، patterns، code) بالإنجليزية.\n\n## 🔄 سيناريوهات الاستخدام\n\n| السيناريو | الأمر |\n|----------|-------|\n| **جهاز جديد كلياً** | الـ one-liner أعلاه |\n| **إعادة تثبيت (refresh)** | نفس الـ one-liner — يكتشف الـ repo الموجود ويحدّثه |\n| **رفع تعديلاتك المحلية للـ repo** | `cd ~/claude-config \u0026\u0026 .\\scripts\\backup.ps1 \u0026\u0026 git push` |\n| **سحب تحديثات من جهاز آخر** | نفس الـ one-liner — يسحب التحديثات ويثبّتها |\n| **عرض الفروقات قبل أي مزامنة** | `.\\scripts\\sync-check.ps1` |\n\n## 📚 مصادر الإلهام\n\nهذا الإعداد مستوحى من:\n\n- **ثقافة dotfiles** — version control لبيئات المطورين\n- **Architecture Decision Records (ADRs)** — نمط Michael Nygard\n- **أنظمة multi-agent role-based** — بدلاً من assistant واحد عام، أدوار متخصصة\n- **Lazy loading** — main config خفيف، تحميل المعرفة المتخصصة عند الحاجة\n\n## 🤝 المساهمة\n\nهذا تكوين شخصي لكن لا تتردد في:\n\n- عمل fork وتكييفه مع workflow الخاص بك\n- فتح issues لو لقيت bugs\n- اقتراح patterns أو anti-patterns اكتشفتها\n\n## 📝 الترخيص\n\nMIT — راجع [LICENSE](LICENSE)\n\n## 🙋 أسئلة شائعة\n\n**س: لماذا 8 أدوار؟ ألا يكفي assistant واحد؟**\nج: قرارات مختلفة تحتاج عقليات (mental models) مختلفة. الـ CTO يفكر بشكل مختلف عن Growth Strategist. إجبار دور واحد على التعامل مع كل شيء يؤدي لنصائح عامة. فصل الأدوار = نتائج مركّزة وقابلة للتنفيذ.\n\n**س: ما الفرق بين هذا وبين system prompts العادية؟**\nج: هذا نظام طبقي: core صغير دائم (CLAUDE.md) + أدوار متخصصة lazy-loaded + قواعد معرفية منظمة (Patterns, Decisions, Anti-patterns). يتوسع مع الاستخدام بدون نفخ الـ context.\n\n**س: لماذا لا نستخدم `/agents` المدمجة في Claude؟**\nج: الـ sub-agents لـ spawning مهام معزولة. الأدوار هنا عبارة عن عقليات (mental models) تُحمَّل في المحادثة الأساسية — غرض مختلف.\n\n**س: هل أحتاج كل الأدوار الثمانية؟**\nج: لا. ابدأ بـ CTO + PM (افتراضي)، وأضف الباقي عند الحاجة. كل ملف دور مستقل عن الآخر.\n\n**س: كيف أحدّث الـ repo من تعديلاتي المحلية؟**\nج: شغّل `.\\scripts\\backup.ps1` ثم `git push`. الـ script ينسخ الملفات الـ trackable فقط (يتجاهل runtime data والـ secrets).\n\n**س: ماذا لو عملت تعديلات على CLAUDE.md ولا أريد رفعها؟**\nج: استخدم `~/.claude/settings.local.json` للـ overrides الخاصة بالجهاز. أو أنشئ branch محلي في الـ repo بدون push.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsabrydawood%2Fclaude-config","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fsabrydawood%2Fclaude-config","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fsabrydawood%2Fclaude-config/lists"}