Superpowers for Claude Code
كيف تخلّي الـ AI يكتب كود بشكل منهجي وليس عشوائياً.
لو شغّلت Claude Code أو Cursor وحسّيت إن الـ agent يقفز مباشرة للكتابة قبل ما يفهم وش تبغى تبني، أنت مو لوحدك. المشكلة مو في الموديل، المشكلة في إن ما عنده منهجية عمل. Superpowers هو الإطار اللي يعطي الـ agent الخطوات الصحيحة قبل ما يلمس الكود.
🧩 إيش هو بالضبط
Superpowers عبارة عن مجموعة "مهارات" (skills) مرتّبة تُحمّل في أي coding agent بيدعم البلاغين زي Claude Code أو Cursor. كل مهارة عبارة عن ملف نص بسيط يشرح للـ agent كيف يتصرف في سيناريو معين، من لحظة ما تطرح الفكرة لحين ما تدمج الكود في الـ main branch.
التشبيه المناسب: تخيّل إنك وظّفت مهندس ذكي بس ما عنده خبرة في شغل الشركة. Superpowers هو الـ onboarding manual اللي يحوّله من شخص يكتب أي شيء إلى شخص يتبع عملية واضحة ومثبتة.
الفرق الجوهري هو هذا: بدون Superpowers الـ agent يخمّن. معه يتحقق من خطوة لخطوة.
⚙️ كيف يشتغل
العملية مرتّبة بشكل متسلسل وتبدأ من أول ما تفتح جلسة جديدة:
1️⃣ **التخطيط أولاً (Brainstorming):** ما إن يحسّ الـ agent إنك تبغى تبني شيء، يتوقف ويسألك أسئلة لتحديد المتطلبات الفعلية. ما يكتب سطر واحد قبل ما يكون عنده spec واضح.
2️⃣ **عزل بيئة العمل (Git Worktrees):** بعد إقرار التصميم، الـ agent ينشئ branch منفصل ويتحقق إن الـ tests الأساسية شغّالة قبل ما يبدأ أي تعديل.
3️⃣ **كتابة الخطة (Writing Plans):** يكسّر الشغل إلى مهام صغيرة كل وحدة من 2 إلى 5 دقائق، مع مسارات الملفات الكاملة والكود المطلوب وخطوات التحقق.
4️⃣ **التطوير بالـ Subagents:** يطلق عملاء فرعيين (subagents) لكل مهمة مع مراجعة ثنائية المرحلة، أول مراجعة للـ spec ثانية لجودة الكود.
5️⃣ **TDD إلزامي:** ما في كود يُكتب قبل الـ test. الـ cycle الصحيح هو: RED ← GREEN ← REFACTOR. أي كود يُكتب قبل الـ test يُحذف.
6️⃣ **مراجعة منتظمة (Code Review):** بين كل مهمة ومهمة، الـ agent يراجع المخرجات على الـ spec ويبلّغ عن أي مشاكل قبل ما يكمل.
🌍 وين تشوفه في حياتك
الإطار مناسب لأي شخص يستخدم coding agents في عمله اليومي:
🧑💻 المطوّر المستقل اللي يبني features كاملة بمساعدة Claude Code ويحتاج يضمن إن الـ agent ما يخرج عن الخطة.
🏢 فرق الـ startups اللي تستخدم AI في كتابة الكود وتحتاج مستوى من الانضباط في العملية.
📚 المتعلّم الجديد للـ AI-assisted coding اللي يبغى يفهم كيف يبني workflow صح من البداية.
⚗️ أي شخص يستخدم Claude Code أو Cursor أو Gemini CLI أو Codex ويلاحظ إن الـ agent يقفز لحلول قبل ما يفهم المشكلة.
🛠️ الأدوات اللي تستخدمها فعلاً
🔧 Claude Code
الـ coding agent الرسمي من Anthropic، يشتغل في الـ terminal مباشرة. Superpowers متاح عبر الـ official plugin marketplace.
كيف تبدأ:
1️⃣ ثبّت Claude Code إذا ما عندك: `npm install -g @anthropic-ai/claude-code`
2️⃣ افتح مشروعك في الـ terminal واكتب: `/plugin install superpowers@claude-plugins-official`
3️⃣ ابدأ جلسة جديدة واكتب "help me plan this feature" وراقب الـ agent وهو يتبع منهجية Superpowers تلقائياً.
🔧 Cursor
بيئة تطوير مبنية على VS Code مع دعم كامل للـ AI agents. Superpowers متاح مباشرة من plugin marketplace الخاص فيه.
كيف تبدأ:
1️⃣ افتح Cursor وروح للـ Agent chat.
2️⃣ اكتب: `/add-plugin superpowers` أو دوّر "superpowers" في قائمة البلاغين.
3️⃣ ابدأ محادثة جديدة واطلب من الـ agent بناء feature معينة وشوف الفرق.
🔧 Gemini CLI
واجهة سطر أوامر من Google تدعم الـ AI agents. Superpowers يدعمها عبر نظام الـ extensions.
كيف تبدأ:
1️⃣ ثبّت Gemini CLI إذا ما عندك من الموقع الرسمي.
2️⃣ في الـ terminal اكتب: `gemini extensions install https://github.com/obra/superpowers`
3️⃣ لتحديث الإطار لاحقاً: `gemini extensions update superpowers`
💡 جرّب بنفسك: خطوة بخطوة
سيناريو عملي: تبغى تبني feature بسيطة في مشروع Node.js قائم باستخدام Claude Code مع Superpowers.
1️⃣ افتح الـ terminal في مجلد مشروعك وثبّت Superpowers من الـ marketplace كما شرحنا.
2️⃣ ابدأ جلسة جديدة مع Claude Code واكتب مثلاً: "I want to add a user notification system." لاحظ إن الـ agent ما يبدأ بالكود مباشرة، بل يسألك أسئلة توضيحية عن نوع الإشعارات والحالات المختلفة.
3️⃣ أجب على الأسئلة بصدق وبشكل واضح. الـ agent سيبني spec ويعرضها عليك للمراجعة، تقدر توافق أو تعدّل.
4️⃣ بعد الموافقة، الـ agent سينشئ خطة تفصيلية مقسّمة إلى مهام صغيرة ويبدأ التنفيذ. ستشوف كيف يكتب الـ test أولاً ثم الكود، وكيف يراجع كل مهمة قبل ما ينتقل للتالية.
النتيجة المتوقعة هي feature مبنية بشكل صحيح، مغطّاة بالـ tests، موثّقة في git بشكل منضبط، وقابلة للمراجعة خطوة بخطوة.
وش تسوي بعد ذا
✅ جرّب تثبّت Superpowers في مشروعك الحالي وابدأ بطلب بسيط واحد لتشوف الفرق في سلوك الـ agent.
✅ اقرأ ملفات الـ skills الموجودة في المشروع على GitHub لتفهم كيف يُبنى prompt منهجي.
✅ اسأل نفسك: أي جزء من workflow الحالي مع الـ AI ينقصه منهجية؟ Superpowers ممكن يكون الجواب.
الـ AI مو مشكلته الذكاء، مشكلته غياب المنهجية. Superpowers يحلّها.
———— English ————
**Superpowers for Claude Code**
The framework that gives your coding agent a methodology, not just muscle.
If you've worked with Claude Code or Cursor for more than a few sessions, you've probably noticed the pattern: the agent dives straight into writing code before it fully understands what you actually want. The problem isn't the model. The problem is that there's no workflow. Superpowers is a framework that fixes exactly that.
**What it actually is**
Superpowers is a collection of text-based "skills" that get loaded into your AI coding agent and tell it how to behave at each stage of a development session. From the moment you describe an idea, all the way through testing, review, and merging, the agent follows a defined process instead of guessing.
Think of it like this: you hired a smart engineer who has never worked at your company before. Superpowers is the onboarding manual that turns them from someone who writes whatever makes sense in the moment into someone who follows a tested, repeatable process. The core difference is discipline. Without Superpowers the agent improvises. With it, it verifies.
**How it works**
The workflow kicks in automatically as soon as you start a new session. Here's the full sequence:
1️⃣ **Brainstorming first:** Before touching any code, the agent asks clarifying questions to extract a proper spec. It does not write a single line until it understands what you are building and why.
2️⃣ **Isolated workspace:** Once you approve the design, the agent creates a separate git branch using worktrees and verifies the test baseline is clean before making any changes.
3️⃣ **Detailed planning:** It breaks the work into tasks that are two to five minutes each, with exact file paths, complete code, and verification steps for every task.
4️⃣ **Subagent-driven execution:** Individual subagents handle each task, with a two-stage review covering spec compliance first, then code quality.
5️⃣ **Mandatory TDD:** No code gets written before a test. The cycle is RED then GREEN then REFACTOR. Any code written before the corresponding test gets deleted.
6️⃣ **Continuous review:** Between every task, the agent checks its output against the original plan and flags issues before moving forward.
**Where you see it**
Superpowers is relevant any time a developer uses AI agents to build real software:
👨💻 Solo developers building full features with Claude Code who need the agent to stay on track over a multi-hour session.
🏢 Small teams using AI-assisted development and wanting a consistent level of process quality across all sessions.
📖 Developers who are new to agentic coding and want to understand what a proper AI workflow actually looks like from day one.
🔬 Anyone who has noticed their coding agent jumping to solutions before understanding the problem, regardless of which tool they use.
**🛠️ Tools you actually use**
🔧 Claude Code
Anthropic's official coding agent, running directly in your terminal. Superpowers is available through the official plugin marketplace with a single command.
How to get started:
1️⃣ Install Claude Code if you haven't: `npm install -g @anthropic-ai/claude-code`
2️⃣ In your project folder, run: `/plugin install superpowers@claude-plugins-official`
3️⃣ Start a new session and say something like "help me plan this feature" and watch the methodology kick in automatically.
🔧 Cursor
A VS Code-based development environment with deep AI agent support. Superpowers integrates directly through the Cursor plugin marketplace.
How to get started:
1️⃣ Open Cursor and navigate to the Agent chat panel.
2️⃣ Type `/add-plugin superpowers` or search "superpowers" in the plugin marketplace.
3️⃣ Start a new agent session and request a feature build to see the structured workflow in action.
🔧 Gemini CLI
Google's command line interface for AI-assisted development, with Superpowers support through the extensions system.
How to get started:
1️⃣ Install Gemini CLI from the official Google source if you don't have it.
2️⃣ Run: `gemini extensions install https://github.com/obra/superpowers`
3️⃣ To keep it current later: `gemini extensions update superpowers`
**💡 Try it yourself: step by step**
Scenario: you want to add a simple feature to an existing Node.js project using Claude Code with Superpowers installed.
1️⃣ Open your terminal in your project folder and install Superpowers using the Claude Code marketplace command above.
2️⃣ Start a new Claude Code session and describe what you want to build. Something like: "I want to add a user notification system." Notice the agent does not immediately start writing code. It asks you clarifying questions about notification types, triggers, and edge cases.
3️⃣ Answer honestly and clearly. The agent will synthesize a spec from your answers and present it back to you in sections. You can approve it as-is or adjust anything before moving forward.
4️⃣ Once you approve, the agent builds a detailed task plan and begins execution. Watch how it writes the failing test first, makes it pass with minimal code, then commits and moves to the next task. At every step it reviews its own work against the plan before continuing.
What you get at the end is a feature that is properly tested, clearly committed in git, and traceable from spec to code.
**What to do next**
✅ Install Superpowers in your current project and run one real feature request to see how differently the agent behaves.
✅ Browse the skills folder in the GitHub repository to understand how a well-structured agent prompt is written.
✅ Ask yourself which part of your current AI coding workflow lacks a defined process. That is your starting point.
AI agents are not short on intelligence. They are short on process. Superpowers gives them one.