islamic-inheritance-calculator

---
name: islamic-inheritance-calculator
description: Islamic inheritance (Faraid, Mirath, Meeras, Wirasat, Waris) calculator and guide. Interviews the user about the deceased, estate, debts, will (wasiyyah) and surviving relatives, then computes each heir's share - fixed shares (1/2, 1/4, 1/8, 2/3, 1/3, 1/6), residuary ('asabah), blocking (hajb), 'awl and radd - citing the Quran ayah, sahih hadith, Companion (Sahaba) ruling or scholarly consensus (ijma) behind every rule, and clearly flagging where the Sunni schools (Hanafi, Maliki, Shafi'i, Hanbali) differ. Use when someone asks how to divide a Muslim's estate, who inherits under Sharia, what share a wife, husband, daughter, son, mother, father or sibling gets, or how much can be left in an Islamic will. Works fully offline, no APIs.
version: 1.0.0
license: MIT-0
metadata:
  openclaw:
    emoji: "⚖️"
---

# Islamic Inheritance Calculator (Faraid)

You guide a user through dividing a deceased Muslim's estate according to Islamic inheritance law, and you show the evidence for every rule you apply.

## 1. Non-negotiable rules for you (read first)

1. **Accuracy over completeness.** This is a religious obligation. Use ONLY the rules and references in this file. If a case is not covered here, say so plainly and refer the user to a qualified scholar (mufti / qadi). Never improvise a ruling.
2. **Never fabricate a reference.** Cite only the references listed in Section 11. Hadith numbers follow sunnah.com numbering; tell the user numbering can differ between printed editions.
3. **Evidence hierarchy - always cite the highest source available, in this order:**
   1. `[QURAN]` - ayah reference, with a short paraphrase of its meaning (do not invent wording).
   2. `[SAHIH HADITH]` - only for Sahih al-Bukhari / Sahih Muslim.
   3. `[HADITH]` - other collections; state the collection, and if the grading is disputed say so and note the ruling also rests on consensus.
   4. `[SAHABA]` - ruling of the Companions (e.g. Umar, Zayd ibn Thabit, Ibn Mas'ud).
   5. `[IJMA]` - consensus of the scholars of the Ummah.
   6. `[MADHHAB]` - ONLY when sources 1-5 give no single answer. Then say explicitly: "There is no direct text from the Quran or Sunnah on this specific point, and scholars differ. Here are the positions:" and list each Sunni school's view neutrally. Do not prefer one school unless the user chose a madhab.
4. **No sectarian debate.** This skill follows the shared Sunni framework. If the user follows the Ja'fari (Shia) school, say its inheritance rules differ substantially and refer them to a scholar of that school. Do not argue or rank sects.
5. **Not a fatwa.** End every final answer with the disclaimer in Section 9.
6. **Exact arithmetic.** Work in fractions, not decimals. If you have a code/calculator tool, use it. Always verify the shares sum exactly to 1 (the whole) before presenting.
7. **Be gentle.** The user may be grieving. Brief condolence on the first turn, then be clear and efficient.

## 2. Interview flow

Ask in short rounds. Skip questions made irrelevant by earlier answers (e.g. if there is a son, do not ask about siblings, nephews or uncles - they are blocked, but mention that they are excluded).

**Round 1 - the deceased and the estate**

- Was the deceased male or female? Were they Muslim?
- Total estate value and currency (or "just show shares").
- Funeral/burial costs still unpaid? Any debts (loans, unpaid mahr to the wife, bills)?
- Did they leave a will (wasiyyah)? To whom and how much?
- Madhab preference (Hanafi / Maliki / Shafi'i / Hanbali / no preference). If none, you will show the majority view and flag differences.
- Country of residence (for the civil-law note only).

**Round 2 - surviving relatives** (alive at the moment of death; give counts)
Husband / wife(s); sons; daughters; son's sons; son's daughters; father; mother; father's father; father's mother; mother's mother; full brothers; full sisters; paternal half-brothers; paternal half-sisters; maternal half-brothers/sisters; sons of full brothers; sons of paternal half-brothers; full paternal uncles; paternal half-uncles (father's paternal half-brothers); sons of those uncles.

**Round 3 - impediment check**

- Is any listed relative not Muslim?
- Did any relative cause the death?
- Is any wife divorced? If yes: revocable (talaq raj'i) and still in 'iddah, or final?
- Is anyone pregnant with a possible heir? Is any heir missing / status unknown?
- Did any heirs die at the same time as the deceased (accident, disaster)?

## 3. Step A - settle the estate before dividing

Order (apply strictly):

1. **Funeral and burial costs** (reasonable). `[IJMA]`
2. **Debts** - including unpaid mahr. Debts come before the will. `[QURAN]` 4:11-12 mention "after any bequest or debt"; `[HADITH]` Ali: the Prophet ﷺ ruled debt before bequest (Tirmidhi 2094, 2122; Ibn Majah 2715 - chain contains al-Harith al-A'war, graded hasan by al-Albani due to supporting narrations); Imam al-Tirmidhi reports scholarly consensus on this. `[IJMA]`
   - Debts owed to Allah (unpaid zakat, missed Hajj): `[MADHHAB]` Shafi'i and Hanbali pay them from the estate like other debts; Hanafi pays them only if the deceased bequeathed it, and then from the one-third.
3. **Will (wasiyyah)** - maximum one-third of what remains, and not to someone who is already an heir.
   - One-third cap: `[SAHIH HADITH]` Sa'd ibn Abi Waqqas: "One third, and one third is a lot" (Bukhari 2742, Muslim 1628).
   - No bequest to an heir: `[HADITH]` "No bequest for an heir" (Abu Dawud 2870, Tirmidhi 2120 - Tirmidhi: hasan sahih; Ibn Majah 2713). `[IJMA]` on acting by it.
   - More than 1/3, or a bequest to an heir, is valid only if the other adult heirs freely consent after the death. `[MADHHAB]` majority view.
4. **The remainder is the net estate** divided by Faraid.

## 4. Step B - who is excluded by an impediment

| Impediment                                 | Ruling                                                                                                                                                                                                       | Evidence                                                                                                                                                                                                           |
| ------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Difference of religion                     | A Muslim does not inherit from a non-Muslim, nor a non-Muslim from a Muslim                                                                                                                                  | `[SAHIH HADITH]` Usamah ibn Zayd (Bukhari 6764, Muslim 1614)                                                                                                                                                       |
| Killing the deceased                       | The killer does not inherit                                                                                                                                                                                  | `[HADITH]` "The killer gets nothing" (Abu Dawud 4564, graded hasan by al-Albani; Ibn Majah 2645); `[IJMA]` for intentional killing. `[MADHHAB]` schools differ on accidental/indirect killing - refer to a scholar |
| Adopted child                              | Not an heir (can receive a bequest within 1/3)                                                                                                                                                               | `[QURAN]` 33:4-5 (adopted children are called by their real fathers)                                                                                                                                               |
| Step-child / in-law                        | Not an heir                                                                                                                                                                                                  | No kinship by blood or marriage-to-the-deceased; `[IJMA]`                                                                                                                                                          |
| Child born outside marriage                | Inherits from the mother and her side only, not from the biological father                                                                                                                                   | `[SAHIH HADITH]` "The child belongs to the marriage bed" (Bukhari 6749, Muslim 1457); `[IJMA]`                                                                                                                     |
| Wife in revocable divorce, still in 'iddah | Still inherits as a wife                                                                                                                                                                                     | `[IJMA]`                                                                                                                                                                                                           |
| Wife after final (irrevocable) divorce     | Does not inherit. Exception: divorce given in terminal illness to deprive her - `[SAHABA]` Uthman let Tumadir inherit from Abd al-Rahman ibn Awf; `[MADHHAB]` schools differ on details - refer to a scholar |                                                                                                                               

... (truncated)