--- title: "Vibe Coding Done Right: Why Context Engineering Beats a Powerful Model Every Time" title_ar: "الـ Vibe Coding الصحيح: ليش هندسة السياق بتغلب النموذج القوي" url: "https://www.aiwithmo.com/prompts/context-engineering-vibe-coding" canonical: "https://www.aiwithmo.com/prompts/context-engineering-vibe-coding" published: 2026-05-21 updated: 2026-05-21 category: ai-tools languages: [ar, en] author: Mohamed Khair site: aiwithmo --- # Vibe Coding Done Right: Why Context Engineering Beats a Powerful Model Every Time ## الـ Vibe Coding الصحيح: ليش هندسة السياق بتغلب النموذج القوي Source: https://www.aiwithmo.com/prompts/context-engineering-vibe-coding · Author: Mohamed Khair (محمد خير), aiwithmo · Published in Arabic and English. ## English Most people think Vibe Coding means typing a request to an AI and expecting working software to come out the other side. They are wasting their time, and they end up with the same result every time: buggy code, a half-broken system, and a project that collapses the moment it gets complex. The problem is not the model. The newest, most powerful model will still produce a mess if you hand it a vague request and no structure. The real skill behind Vibe Coding is not prompting. It is Context Engineering: preparing clear, structured files that guide the AI step by step, the same way a senior engineer would brief a team before any code is written. This guide explains the approach that separates people who actually ship working software with AI from people who keep restarting broken projects. It is built on three ideas. First, breaking the AI's randomness by organizing your project requirements into structured files like ROADMAP.md, so the model works with full awareness of the goal instead of guessing. Second, reducing hallucination and errors by splitting the project into clear phases: the model executes one bounded, well-defined chunk at a time instead of trying to hold an entire system in its head. Third, shifting your own role: you stop being a regular user typing prompts and become the architect directing the AI like a team lead directs engineers. The model is the worker. Context Engineering is the management. And the quality of your output is decided by the management, not the worker. This approach works across every AI coding tool: Claude Code, Codex, Gemini, Cursor, and Lovable. Follow for more: - https://www.instagram.com/ai.with.mo/ Course Registration: https://halaqa.app/enrollment?course=start-with-ai ## العربية معظم الناس مفكرين إن الـ Vibe Coding يعني بس تكتب طلب للذكاء الاصطناعي وتتوقع يطلعلك برنامج شغّال من الطرف التاني. وهنّي عم يضيّعوا وقتهم، وبينتهوا بنفس النتيجة كل مرة: كود مليان أخطاء، سيستم نص مكسور، ومشروع بينهار أول ما يصير معقّد. المشكلة مو بالموديل. أحدث وأقوى موديل رح يطلّعلك فوضى إذا سلّمته طلب مبهم وبدون أي هيكلة. المهارة الحقيقية ورا الـ Vibe Coding مو البرومبت، بل هي هندسة السياق (Context Engineering): تجهيز ملفات واضحة ومنظّمة بتوجّه الذكاء الاصطناعي خطوة بخطوة، بنفس الطريقة اللي مهندس خبير بيعمل فيها بريف لفريقه قبل ما ينكتب أي سطر كود. هالدليل بيشرح المنهج اللي بيفصل بين الناس اللي فعلاً عم يطلّعوا برامج شغّالة بالذكاء الاصطناعي، والناس اللي عم يعيدوا يبلشوا مشاريع مكسورة. وهو مبني على ثلاث أفكار. أول شي، كسر عشوائية الذكاء الاصطناعي عبر تنظيم متطلبات مشروعك بملفات منظّمة متل ROADMAP.md، حتى الموديل يشتغل بوعي كامل عن الهدف بدل ما يخمّن. ثاني شي، تقليل الهلوسة والأخطاء عبر تقسيم المشروع لمراحل واضحة: الموديل بينفّذ جزء واحد محدّد ومعرّف بدل ما يحاول يمسك سيستم كامل بدماغه. ثالث شي، تغيير دورك أنت: بتوقف تكون مستخدم عادي بيكتب برومبتات، وبتصير المهندس اللي بيوجّه الذكاء الاصطناعي متل ما القائد بيوجّه فريق المهندسين. الموديل هو العامل. هندسة السياق هي الإدارة. وجودة مخرجاتك بتتقرّر بالإدارة، مو بالعامل. هالمنهج بيشتغل مع كل أدوات البرمجة بالذكاء الاصطناعي: Claude Code وCodex وGemini وCursor وLovable. تابع حسابي على الانستغرام: - https://www.instagram.com/ai.with.mo/ رابط الانضمام للدورة: https://halaqa.app/enrollment?course=start-with-ai ## Steps ### 1. The Vibe Coding Misconception That Breaks Projects *A magic prompt is not a plan - and the AI cannot read your mind* The most common belief about Vibe Coding is that you describe what you want in a prompt, the AI codes it, and you get working software. For anything beyond a tiny script, this fails almost every time. The reason is simple: a vague request forces the AI to invent everything you did not specify - the architecture, the folder structure, the data model, the scope, the priorities. It guesses. And because it guesses differently across messages, the project becomes internally inconsistent: one part assumes a structure another part contradicts. You end up debugging a system that was never coherent to begin with. The model did not fail. You asked it to be an architect, a project manager, and a developer all at once, with no brief. No human engineer could succeed under those conditions either. The fix is not a better prompt or a stronger model. It is giving the AI what any real engineering team needs before writing code: a clear, written plan. ### 2. What Context Engineering Actually Means *You are not prompting the AI - you are managing it* Context Engineering is the practice of preparing the information environment the AI works inside, so its output is shaped by a clear structure instead of guesswork. Instead of holding the whole project in a chat and hoping the model keeps up, you write the project down into structured files: a roadmap that defines the goal and the phases, an architecture file that locks the technical decisions, a rules file that tells the AI how to behave, and a progress file that tracks where things stand. The AI reads these before it does anything. The shift this creates is fundamental. With a vague prompt, you are a user requesting something and hoping. With engineered context, you are a manager who has briefed a capable worker properly. The model's raw intelligence barely changes between those two situations - but the output quality changes enormously, because in one case the model is guessing and in the other it is executing a defined plan. The secret was never the model. It was always the management layer around it. ### 3. The Core Files: ROADMAP.md and the Structure That Guides the AI *Four files that turn a vague idea into an executable plan* A solid Context Engineering setup rests on four files. ROADMAP.md is the master plan: it states the goal in one paragraph, names the tech stack, breaks the project into clearly defined phases each with its own outcome and task list, and lists what is out of scope so the AI does not over-build. ARCHITECTURE.md locks the technical decisions: the folder structure, the data model, the key decisions and the reasons behind them, and the naming conventions - so the AI never quietly contradicts an earlier choice. CONTEXT.md holds the rules for the AI itself: read the plan first, work one phase at a time, write a plan before coding, never touch files outside the current scope, ask when something is unclear. PROGRESS.md is the living status: current phase, completed items, what is in progress, what is next, and known issues. Together these four files do something a prompt never can - they give the AI a stable, written source of truth that does not degrade, does not get forgotten, and does not change every time you start a new conversation. ### 4. Working in Phases: The Workflow That Produces Real Code *Plan, approve, execute one phase, update - then repeat* Files alone are not enough - you also need the right rhythm. The workflow runs phase by phase. You start a session and ask the AI to read ROADMAP.md, ARCHITECTURE.md, and CONTEXT.md. Then you point it at one phase only: write a plan for Phase 1 and wait for my approval. This planning step is where you catch most errors before they ever become code - the AI tells you which files it will touch and how it interprets the phase, and you correct any misunderstanding in plain language. Once the plan is right, you let it execute that single phase and nothing else. When the phase is done, you ask it to update PROGRESS.md, then you start a fresh session for the next phase. This phased rhythm is what kills hallucination: the AI is never holding an entire complex system in its head, only one bounded, well-defined chunk at a time. And running it this way trains you, too. You stop being a user who types requests and hopes, and you become the architect who plans the system, reviews the work, and directs the AI the way a lead directs a team. That shift - from user to director - is the real meaning of mastering Vibe Coding. ## الخطوات ### 1. سوء الفهم اللي بيكسر مشاريع الـ Vibe Coding *البرومبت السحري مو خطة - والذكاء الاصطناعي ما بيقرا أفكارك* أكثر اعتقاد شائع عن الـ Vibe Coding هو إنك بتوصف اللي بدك إياه ببرومبت، الذكاء الاصطناعي بيبرمجه، وبتطلعلك برنامج شغّال. لأي شي أكبر من سكربت صغير، هاد بيفشل كل مرة تقريباً. والسبب بسيط: الطلب المبهم بيجبر الذكاء الاصطناعي يخترع كل شي ما حدّدته - البنية، هيكل المجلدات، نموذج البيانات، النطاق، الأولويات. هو بيخمّن. وبما إنه بيخمّن بشكل مختلف من رسالة لرسالة، المشروع بيصير غير متّسق داخلياً: جزء بيفترض هيكلية وجزء تاني بيناقضها. وبتنتهي عم تصحّح سيستم ما كان متماسك من الأساس. الموديل ما فشل. أنت طلبت منه يكون مهندس معماري ومدير مشروع ومطوّر بنفس الوقت، بدون أي بريف. ما في مهندس بشري بينجح تحت هالظروف كمان. الحل مو برومبت أحسن ولا موديل أقوى. الحل إنك تعطي الذكاء الاصطناعي اللي بيحتاجه أي فريق هندسة حقيقي قبل ما يكتب كود: خطة واضحة ومكتوبة. ### 2. شو يعني هندسة السياق فعلياً *أنت مو عم تكتب برومبت للذكاء الاصطناعي - أنت عم تديره* هندسة السياق هي ممارسة تجهيز البيئة المعلوماتية اللي بيشتغل الذكاء الاصطناعي جوّاتها، حتى مخرجاته تتشكّل بهيكلية واضحة بدل التخمين. بدل ما تمسك المشروع كله بمحادثة وتتمنّى الموديل يلحق، بتكتب المشروع بملفات منظّمة: روودماب بيحدّد الهدف والمراحل، ملف معمارية بيثبّت القرارات التقنية، ملف قواعد بيقول للذكاء الاصطناعي كيف يتصرّف، وملف تقدّم بيتابع وين وصلت الأمور. الذكاء الاصطناعي بيقرأ هالملفات قبل ما يعمل أي شي. والتحوّل اللي بيخلقه هاد جوهري. مع البرومبت المبهم، أنت مستخدم عم يطلب شي وعم يتمنّى. مع السياق المُهندَس، أنت مدير عمل بريّف عامل قدير كما يجب. ذكاء الموديل الخام بالكاد بيتغيّر بين الحالتين - بس جودة المخرجات بتتغيّر بشكل هائل، لأنه بحالة الموديل عم يخمّن وبالحالة التانية عم ينفّذ خطة محدّدة. السر ما كان أبداً بالموديل. هو دايماً كان بطبقة الإدارة اللي حواليه. ### 3. الملفات الأساسية: ROADMAP.md والهيكلية اللي بتوجّه الذكاء الاصطناعي *أربع ملفات بتحوّل فكرة مبهمة لخطة قابلة للتنفيذ* أي إعداد متين لهندسة السياق بيرتكز على أربع ملفات. ROADMAP.md هو الخطة الرئيسية: بيذكر الهدف بفقرة وحدة، بيسمّي الـ Tech Stack، بيقسّم المشروع لمراحل واضحة كل وحدة إلها مخرج ولائحة مهام، وبيعدّد شو خارج النطاق حتى الذكاء الاصطناعي ما يبني أكثر من اللزوم. ARCHITECTURE.md بيثبّت القرارات التقنية: هيكل المجلدات، نموذج البيانات، القرارات المفصلية والأسباب وراها، وقواعد التسمية - حتى الذكاء الاصطناعي ما يناقض بهدوء خيار سابق. CONTEXT.md بيحمل القواعد للذكاء الاصطناعي نفسه: اقرأ الخطة أول شي، اشتغل مرحلة وحدة بالمرة، اكتب خطة قبل البرمجة، ما تلمس ملفات بره النطاق الحالي، اسأل لما يكون في شي مبهم. PROGRESS.md هو الحالة الحية: المرحلة الحالية، العناصر المنجزة، شو قيد التنفيذ، شو الجاي، والمشاكل المعروفة. هالأربع ملفات مع بعض بيعملوا شي ما بيقدر البرومبت يعمله - بيعطوا الذكاء الاصطناعي مصدر حقيقة مكتوب وثابت ما بيتدهور، ما بينُنسى، وما بيتغيّر كل ما تبلش محادثة جديدة. ### 4. العمل بالمراحل: سير العمل اللي بينتج كود حقيقي *خطّط، وافق، نفّذ مرحلة وحدة، حدّث - وبعدها كرّر* الملفات لحالها مو كافية - بدّك كمان الإيقاع الصح. سير العمل بيمشي مرحلة بمرحلة. بتبلش جلسة وبتطلب من الذكاء الاصطناعي يقرأ ROADMAP.md وARCHITECTURE.md وCONTEXT.md. وبعدها بتوجّهه لمرحلة وحدة بس: اكتب خطة للمرحلة الأولى وانتظر موافقتي. خطوة التخطيط هي وين بتمسك معظم الأخطاء قبل ما تصير كود أصلاً - الذكاء الاصطناعي بيقلّك أي ملفات رح يلمسها وكيف فهم المرحلة، وأنت بتصحّح أي سوء فهم بلغة بسيطة. بمجرد ما الخطة تصير صح، بتخلّيه ينفّذ هالمرحلة الوحيدة وما شي غيرها. لما تخلص المرحلة، بتطلب منه يحدّث PROGRESS.md، وبعدها بتبلش جلسة جديدة للمرحلة الجاية. هالإيقاع المرحلي هو اللي بيقتل الهلوسة: الذكاء الاصطناعي أبداً ما عم يمسك سيستم معقّد كامل بدماغه، بس جزء واحد محدّد ومعرّف بالمرة. وتشغيله بهالطريقة بيدرّبك أنت كمان. بتوقف تكون مستخدم بيكتب طلبات ويتمنّى، وبتصير المهندس اللي بيخطّط السيستم، بيراجع الشغل، وبيوجّه الذكاء الاصطناعي متل ما القائد بيوجّه فريق. هالتحوّل - من مستخدم لقائد - هو المعنى الحقيقي لإتقان الـ Vibe Coding. ## Prompt (البرومبت) ```text # CONTEXT ENGINEERING: THE CORE FILE STRUCTURE # Create these files in your project root BEFORE writing any code. # Works with Claude Code, Codex, Gemini, Cursor, and Lovable. # ════════════════════════════════════════ # FILE 1: ROADMAP.md (the master plan) # ════════════════════════════════════════ """ # PROJECT ROADMAP ## Goal [One paragraph: what the finished product does and who it is for] ## Tech Stack [Frontend, backend, database, hosting, be specific] ## Phases ### Phase 1: [Name] - Outcome: [what works when this phase is done] - Tasks: [bounded task list] ### Phase 2: [Name] - Outcome: [...] - Tasks: [...] ### Phase 3: [Name] - Outcome: [...] - Tasks: [...] ## Out of Scope [What this project will NOT do, prevents the AI over-building] """ # ════════════════════════════════════════ # FILE 2: ARCHITECTURE.md (the technical decisions) # ════════════════════════════════════════ """ # ARCHITECTURE ## Folder Structure [How the project is organized] ## Data Model [Tables / entities and their relationships] ## Key Decisions - [Decision + reason, so the AI never re-litigates it] ## Conventions - Naming, file patterns, error handling rules """ # ════════════════════════════════════════ # FILE 3: CONTEXT.md (rules for the AI) # ════════════════════════════════════════ """ # RULES FOR THE AI - Always read ROADMAP.md and ARCHITECTURE.md before coding - Work on ONE phase at a time, never jump ahead - Before coding a phase, write a short plan and wait for approval - After finishing a phase, update PROGRESS.md - Do not touch files outside the current phase scope - If a requirement is unclear, ask before assuming """ # ════════════════════════════════════════ # FILE 4: PROGRESS.md (the living status) # ════════════════════════════════════════ """ # PROGRESS LOG ## Current Phase: [number + name] ## Completed - [Done items with date] ## In Progress - [Current task] ## Next - [Immediate next task] ## Known Issues - [Bugs / debt to address] """ # ─── THE WORKFLOW ─── # 1. Fill ROADMAP.md and ARCHITECTURE.md yourself (or co-write with the AI) # 2. Start a session: "Read ROADMAP.md, ARCHITECTURE.md and CONTEXT.md." # 3. "We are on Phase 1. Write a plan for it and wait for my approval." # 4. Review the plan → correct misunderstandings → approve # 5. Let the AI execute ONLY that phase # 6. "Update PROGRESS.md." → start a fresh session for the next phase # ─── WHY THIS WORKS ─── # Vague prompt → the AI guesses scope, structure, and intent → broken output # Engineered context → the AI executes a defined plan → real, scalable code # The model is the worker. These files are the management layer. # ─── PRO TIPS ─── # One phase per session, keep each conversation short and focused # If a phase is big, split it into sub-tasks inside ROADMAP.md # Never let the AI design and build in the same uncontrolled step # Review every plan BEFORE execution, that is where you catch 90% of errors ``` --- More free bilingual AI guides: https://www.aiwithmo.com/prompts · One to one AI mentorship in Arabic or English: https://www.aiwithmo.com/mentorship