Irab

When tools are available: Call full_irab at the start. The result IS your complete analysis — just format the output as flowing Arabic prose. Review only ambiguities and verification issues manually. When tools are unavailable: Fall back to manual analysis using references/disambiguation.md and the grammar references.

Core Principle: العامل أولاً (Governor First)

NEVER assign a case marker (رفع/نصب/جر/جزم) without first identifying the عامل (governor) that causes it. The analysis chain is always:

حدد العامل → استنتج الحكم الإعرابي → بيّن العلامة
Identify governor → Derive grammatical case → State the sign

Analysis Pipeline (4 Passes)

Execute these passes sequentially. Each pass produces explicit visible output before the next pass begins. Do NOT skip passes or combine them. This separation prevents errors by reducing cognitive load per pass.

Pass 1: التصنيف — Classification

Classify the sentence and every word in it. Produce a classification table.

Instructions:

1. Call classify_sentence(text) — this returns a complete classification table deterministically, including:
   • Per-word: type (اسم/فعل/حرف), subtype, tense, voice, transitivity, gender, number, definiteness, morphological class, مبني/معرب status, particle disambiguation, tashkeel
   • Sentence-level: sentence type (اسمية/فعلية), النواسخ identification
2. Review the result — override only if syntactic context clearly requires it (e.g., the tool picked the wrong reading for a truly ambiguous word)
3. For any words the tool flagged in ambiguities, apply manual reasoning using references/disambiguation.md
4. If classify_sentence is unavailable, fall back to manual classification: a. Add tashkeel if missing (use references/disambiguation.md § "فكّ التباس النص غير المشكّل") b. For each word: determine اسم/فعل/حرف and its subtype c. For multi-function particles: use the decision trees in references/disambiguation.md d. For verbs: determine tense, voice, transitivity e. For nouns: determine number, gender, definiteness, morphological class f. Determine مبني/مُعرب for each word g. Classify sentence type and identify النواسخ

Pass 1 is internal reasoning — do NOT output the classification table to the user. Use it to build the analysis internally, then output only the condensed format defined below.

Pass 2: العوامل — Governor Mapping

For every مُعرب word (and every مبني word that has a محل), identify its عامل. Produce a governor map.

Instructions:

1. If map_governors was called in Pass 1: the governor map is already available. Review only the ambiguities list — these are cases where the deterministic rules were uncertain. For each ambiguity, apply manual reasoning using the عامل→effect table below and the grammar references.
2. If tools are unavailable: for every word, ask what causes this word's case? — identify the عامل using the reference below.
3. Use this reference for common عامل→effect mappings:

4. For شبه الجملة (جار ومجرور / ظرف): identify the متعلَّق به
5. Identify any hidden elements: ضمائر مستترة، محذوفات (خبر/مبتدأ/فعل/عائد محذوف)
   • For every ضمير مستتر: state وجوباً or جوازاً (see references/special-cases.md § الضمير المستتر). This must appear in the output: "والفاعل ضمير مستتر جوازاً تقديره هو" — never omit وجوباً/جوازاً.

Passes 2-4 are internal reasoning — do NOT output them to the user. Work through them mentally, then produce only the final condensed output below.

Output Format — Condensed for Terminal

After completing all 4 passes internally, output ONLY this:

Format: Traditional Phrase-Grouped Style

Group words into logical phrases (as a grammarian naturally would), and write each group as a bullet point (•) with flowing Arabic prose. All i'rab information for the phrase in one paragraph.

Rules:

1. Group by phrase — put related words together (e.g., جار ومجرور together, فعل + ضمائره together, not one word per line)
2. Flowing prose — write naturally as in Arabic grammar books, not as structured fields or tables
3. Inline everything — ضمائر, متعلَّقات, محل الجمل, all within the paragraph for that phrase
4. Use colons for sub-elements — الواو: استئنافية. إنْ: أداة شرط جازمة. كنتم: فعل ماضٍ...
5. State reasons — "مبني على السكون لاتصاله بضمير الرفع المتحرك" not just "مبني على السكون"
6. جمل within their phrase — "وجملة نزّلنا صلة الموصول" goes with the نزّلنا bullet, not in a separate section

Style: A grammarian states reasons naturally. When a grammatical judgment has a cause, state it the way a نحوي would — as a natural continuation, not a separate field:

• "مبني على السكون لاتصاله بضمير الرفع المتحرك" — not just "مبني على السكون"
• "ممنوع من الصرف للعلمية والعجمة" — not just "ممنوع من الصرف"
• "مبني على حذف النون لأنّ مضارعه من الأفعال الخمسة"
• "منصوب بالكسرة بدلاً من الفتحة لأنه ملحق بجمع المؤنث السالم"
• "بضمة مقدرة على الألف منع من ظهورها التعذر"

This is not about adding extra explanation — it's about completeness. The reason IS part of the إعراب. A grammarian who says "مبني على السكون" without saying why has given an incomplete analysis.

Example:

• كتبَ الطالبُ الرسالةَ: كتبَ: فعل ماضٍ مبني على الفتح. الطالبُ: فاعل مرفوع
  وعلامة رفعه الضمة الظاهرة. الرسالةَ: مفعول به منصوب وعلامة نصبه الفتحة الظاهرة.
  والجملة الفعلية ابتدائية لا محل لها من الإعراب.

Longer example (with شرط):

• وَإِنْ كُنْتُمْ: الواو: استئنافية. إنْ: أداة شرط جازمة. كنتم: فعل ماضٍ ناقص
  مبني على السكون لاتصاله بضمير الرفع المتحرك. التاء: ضمير متصل في محل رفع اسم
  «كان» والميم علامة الجمع. والفعل في محل جزم فعل الشرط.

• فِي رَيْبٍ مِمَّا: جار ومجرور متعلق بخبر «كنتم» المحذوف. ممّا: مكونة من «مِن»
  حرف جر و«ما» اسم موصول بمعنى «الذي» مبني على السكون في محل جر بمن. والجار
  والمجرور متعلق بريب أو بصفة محذوفة منها.

• فَأْتُوا: الفاء: مقترنة بجملة الشرط الطلبية الجوابية. ائتوا: فعل أمر مبني على
  حذف النون لأنّ مضارعه من الأفعال الخمسة. الواو: ضمير متصل في محل رفع فاعل
  والألف فارقة. وجملة «ائتوا» جواب شرط جازم مقترن بالفاء في محل جزم.

Internal Verification (do NOT output — just fix silently):

Before outputting, verify:

1. Every case matches its عامل
2. Every sign matches its morphological class
3. No مبني word has ظاهر case
4. Every مبني word has محل (or "لا محل")
5. Every word accounted for, every ضمير identified, every شبه جملة has متعلَّق
6. Every مقدرة has its reason If any check fails, fix it before outputting. Do NOT show the checklist.

Case Signs Reference Table (جدول العلامات)

العلامات الأصلية (Primary Signs)

العلامات الفرعية (Subsidiary Signs)

ملاحظة: الملحق بـ vs الأصلي — بعض الكلمات ملحقة بجموع ليست منها حقيقةً وتأخذ علاماتها:

• ملحق بجمع المذكر السالم: أولو، عالَمون، سنون، بنون، أهلون، عشرون-تسعون
• ملحق بجمع المؤنث السالم: كلمات مثل «كلمات، أولات، أذرعات» (ما كان مفرده يحتوي تاء أصلية أُبدلت بألف وتاء)
• ملحق بالمثنى: اثنان/اثنتان، كلا/كلتا (إذا أُضيفتا إلى ضمير)

عند الإعراب: قل "ملحق بـ..." إذا كان ملحقاً لا أصلياً. مثال: «كلماتٍ: مفعول به منصوب بالكسرة بدلاً من الفتحة لأنه ملحق بجمع المؤنث السالم».

المبني vs المعرب — Built vs Declinable

الكلمات المبنية (لا تتغير حركتها):

• الأفعال: الماضي (مبني دائماً)، الأمر (مبني دائماً)
• الحروف: كلها مبنية بلا استثناء
• الأسماء المبنية: الضمائر، أسماء الإشارة (ما عدا المثنى)، الأسماء الموصولة (ما عدا المثنى)، أسماء الشرط، أسماء الاستفهام (ما عدا أيّ)، بعض الظروف (الآنَ، حيثُ، إذْ، إذا)، أسماء الأفعال (هيهاتَ، صهْ)، الأعداد 11-19 (مبنية على فتح الجزأين ما عدا 12)
• الفعل المضارع المبني (استثناء من كونه مُعرباً): مبني على السكون مع نون النسوة (يكتبْنَ)، مبني على الفتح مع نون التوكيد المباشرة (يكتبَنَّ)

قاعدة المبني: اذكر حالة البناء (مبني على الضم/الفتح/الكسر/السكون) ثم المحل إن وُجد:

• مثال: هو → ضمير منفصل مبني على الفتح في محل رفع مبتدأ

Error Prevention Rules (قواعد منع الخطأ)

Rule 1: العامل أولاً — Governor First

NEVER write "مرفوع" or "منصوب" before stating WHY. Always identify the عامل first.

• ✗ "كلمة منصوبة وعلامة نصبها الفتحة" (no عامل stated)
• ✓ "مفعول به منصوب بالفعل [كتبَ] وعلامة نصبه الفتحة"

Rule 2: الفاعل والمفعول — Subject vs Object

• الفاعل is the doer of the action (or its grammatical substitute), ALWAYS مرفوع
• المفعول به is the receiver of the action, ALWAYS منصوب
• In passive voice (المبني للمجهول): the original مفعول becomes نائب فاعل (مرفوع)
• Check: Does the word DO the action or RECEIVE it?

Rule 3: الأسماء الخمسة — Five Nouns Conditions

أبو، أخو، حمو، فو، ذو take subsidiary signs (الواو/الألف/الياء) ONLY when ALL THREE conditions are met:

1. مفردة (not dual or plural)
2. مكبّرة (not diminutive)
3. مضافة لغير ياء المتكلم

If ANY condition fails → regular أصلية signs (الضمة/الفتحة/الكسرة).

• أبوك → subsidiary: رفع بالواو
• أبي → أصلية: رفع بالضمة المقدرة (مضاف لياء المتكلم)
• آباء → أصلية: جمع تكسير

Rule 4: المبني — Identify Built Words

Before analyzing case, check: is this word مبني or مُعرب?

• If مبني: state البناء (على الفتح/الضم/الكسر/السكون) + المحل (if any)
• If مُعرب: proceed with normal case analysis
• Common trap: الأفعال الماضية are ALWAYS مبنية — never say "فعل ماضٍ مرفوع"

Rule 5: الإعراب التقديري — Estimated Case

Three categories with different reasons:

1. التعذر (impossibility): الاسم المقصور (الفتى، المستشفى) — all three cases estimated
2. الثقل (heaviness): الاسم المنقوص (القاضي) — only الرفع and الجر estimated; النصب ظاهرة
3. اشتغال المحل (occupied position): المضاف لياء المتكلم — الكسرة المناسبة تشغل المحل

Rule 6: الإعراب المحلي — Positional Case

Use this template: "مبني على [حركة البناء] في محل [الحكم الإعرابي]" Applies to: الضمائر، أسماء الإشارة، الأسماء الموصولة، الجمل التي لها محل

Handling Undiacritized Text

When the input lacks تشكيل (diacritical marks):

1. Analyze the most probable reading based on context and grammar
2. Add the appropriate تشكيل in your analysis
3. If genuinely ambiguous (multiple valid parsings), present the primary reading and note alternatives under ملاحظات
4. Common cases: إلى vs على (prepositions are unambiguous), passive vs active voice

When to Consult Reference Files

Load reference files ONLY when the sentence contains relevant constructions:

• references/grammar-rules.md — When the sentence contains:

  • كان or any of its sisters (أصبح، أضحى، ظل، أمسى، بات، صار، ليس، ما زال، ما فتئ، ما برح، ما انفك، ما دام) — includes حذف كان, كان الزائدة, حذف نون يكن, ضمير الشأن
  • إنّ or any of its sisters (أنّ، كأنّ، لكنّ، ليت، لعل) — includes 8 مواضع الكسر, 4 مواضع جواز الفتح/الكسر, اللام المزحلقة (8 sub-rules), المخففة+الفواصل, العطف على اسم إنّ
  • ظنّ وأخواتها (+ حجا, وهب, ردّ), أعطى وأخواتها, أرى وأخواتها — includes التعليق (6 أدوات), الإلغاء (3 أحكام), إجراء القول مجرى الظنّ
  • كاد وأخواتها (أوشك، عسى، كرب، شرع، أنشأ، طفق، جعل=بدأ، أخذ=بدأ، علق)
  • ما الحجازية / لات / لا العاملة عمل ليس / إنْ النافية (شروط كل منها)
  • المبني للمجهول / نائب الفاعل
  • Conditional constructions (إنْ، إذما، مَنْ، ما الشرطية، إذا، لو) — includes 4 tense combos, حذف الجواب, اجتماع الشرط والقسم
  • حروف النصب (أنْ، لن، كي، إذن+3 شروط) — includes أنْ المضمرة (حتى، فاء السببية، واو المعية، لام التعليل/الجحود، أو)، حتى الابتدائية (رفع واجب)
  • حروف الجزم (لم، لمّا، لام الأمر، لا الناهية) + جزم المضارع في جواب الطلب
  • لا النافية للجنس — includes 5 أوجه العطف, 3 أوجه النعت
  • المصدر المؤول (أنْ/أنّ/ما/لو + فعل/جملة)
  • المشتقات العاملة (اسم فاعل/مفعول/صفة مشبهة/صيغ مبالغة + معمول)
  • نون التوكيد (الثقيلة والخفيفة)
  • لو (المصدرية/الشرطية/التمنّي), أمّا (حرف تفصيل+لزوم الفاء), لولا/لوما (الامتناعية/التحضيضية)

• references/roles-and-functions.md — When the sentence contains:

  • المفعول المطلق (مصدر بعد فعل من لفظه: ضربتُ ضرباً)
  • المفعول لأجله (مصدر قلبي يبيّن السبب: قمتُ إجلالاً)
  • المفعول فيه / الظرف (ظروف الزمان والمكان: يومَ، أمامَ، عندَ، حيثُ)
  • المفعول معه (واو بمعنى مع: سرتُ والنيلَ)
  • المنصوب على نزع الخافض
  • المضاف إليه (تفصيلاً: أنواع الإضافة، الإضافة اللفظية vs المعنوية)
  • تعلّق شبه الجملة (الجار والمجرور / الظرف ومتعلقه)
  • مسوغات الابتداء بالنكرة / تقديم وحذف المبتدأ والخبر

• references/special-cases.md — When the sentence contains:

  • الأسماء الخمسة (أب، أخ، حم، فو، ذو) — includes 3 لغات (إتمام/قصر/نقص)
  • الأفعال الخمسة (يفعلان، تفعلان، يفعلون، تفعلون، تفعلين)
  • المثنى or جمع المذكر السالم or جمع المؤنث السالم
  • الممنوع من الصرف — includes detailed subcases: وصفية+أ.ن (سكران/سيفان), وصفية+أفعل (عارض الوصفية/الاسمية), علمية+تأنيث بالتعليق (5 حالات), علمية+عجمة, علمية+وزن الفعل
  • الإعراب التقديري or المحلي
  • بناء الأفعال التفصيلي
  • الضمائر (جداول كاملة)
  • الأعداد — includes جمع القلة, إضافة العدد المركب, اسم الفاعل من العدد (حادي/ثالث...)
  • أسماء الإشارة (7 صيغ للمؤنث, 3 رتب: قربى/وسطى/بعدى, كاف الخطاب/لام البعد, إشارة المكان)
  • الأسماء الموصولة (كل الصيغ, الحرفية 5, أيّ الموصولة, ذا الموصولة, شروط الصلة 3, حذف العائد 4 أنواع)
  • العلم (اسم/كنية/لقب, المركب المزجي/الإضافي)
  • التنوين وأنواعه الستة

• references/sentence-analysis.md — When the sentence contains:

  • Embedded clauses (جمل داخل الجملة — 7+7 types)
  • التوابع: نعت (4/10 مطابقة حقيقي, 2/5 سببي, القطع), عطف نسق (11 حرفاً مفصّلاً, العطف على ضمير), عطف بيان, توكيد (لفظي/معنوي, فصل الضمير), بدل (4 أنواع including مباين)
  • الحال (جمود, مسوّغات من نكرة, من مضاف إليه, تقديم, المضارع+الواو, حذف العامل, تعدد)
  • التمييز (جرّ بالإضافة, أفعل التفضيل+تمييز, تقديم)
  • الاستثناء (تقديم, تكرار إلا, ليس/لا يكون, المفرّغ الموجب, سوى, حاشا)
  • النداء + المنادى المضاف لياء المتكلم (5 أوجه) + الاستغاثة + الندبة + الترخيم + أسماء لازمت النداء

• references/asaleeb.md — When the sentence contains:

  • أسلوب التعجب (ما أفعلَهُ! / أفعِلْ بِهِ!)
  • أسلوب المدح والذم (نِعمَ / بِئسَ / حبّذا)
  • اسم التفضيل (أفعل: أكبر، أحسن...)
  • أسلوب القسم (واللهِ، تاللهِ، لَعَمرُك)
  • أسلوب الاشتغال (زيداً أكرمتُهُ)
  • أسلوب التنازع (جاء وذهبَ زيدٌ)
  • أسلوب الاختصاص (نحن — العربَ — نكرم الضيف)
  • أسلوب الإغراء والتحذير (الصدقَ الصدقَ! / إيّاكَ والكسلَ!)
  • أسماء الأفعال (هيهاتَ، صهْ، آمينَ)
  • لا سيّما
  • إذا الفجائية
  • كم الخبرية vs الاستفهامية

• references/disambiguation.md — Consult ALWAYS, especially when:

  • Multi-function particles appear — 22 decision trees available:
    • Original 11: ما، لا، أنْ/إنْ، الواو، الفاء، مِن/مَن، الباء (11 معنى)، اللام (22 معنى)، أل، أنّ/إنّ، جعل
    • New 11: في (10 معانٍ)، عن (10)، على (9)، إلى (8)، حتى (4 أنواع)، قد (6)، الهمزة (2+8 خروجات)، أو (12 معنى)، هل، لو (5)، إذا (3+خروجات)
  • Also: مذ/منذ (حرف جر vs اسم vs ظرف)، ربّ (أحكام + حذف بعد واو/فاء/بل)، ما الزائدة بعد حروف الجر (كافة vs غير كافة)
  • You need to determine verb transitivity (لازم/متعدٍّ)
  • The text lacks tashkeel and is ambiguous
  • You need to determine scope/boundaries of nested clauses

Language and Style

• All grammatical terminology in Arabic (النحو العربي التقليدي)
• Brief explanatory notes may be in Arabic or English depending on user's language
• Use the traditional grammar school (مدرسة البصرة/الكوفة) conventions, defaulting to the Basran school where they differ
• Be precise: distinguish between الإعراب الظاهر / التقديري / المحلي
• For beginners: add brief explanations of WHY each case applies