PURPOSE
This is the top-level routing controller for the Islamic Finance Plugin.
It determines which product skill and which jurisdiction overlay to load
before generating any Islamic finance accounting output.
It does NOT contain accounting rules itself. It routes to the files that do.
ROUTING PROTOCOL — EXECUTE BEFORE ANY OUTPUT
Step 1: Identify the Jurisdiction
Read the user query for jurisdiction signals:
- Country name (Bahrain, Malaysia, UAE, Saudi Arabia, UK, Pakistan, Nigeria, etc.)
- Currency (BHD, MYR, AED, SAR, GBP, PKR, NGN)
- Regulator name (CBB, BNM, CBUAE, SAMA, PRA/FCA, SBP, CBN)
- Standard reference (AAOIFI FAS, MFRS, IFRS as adopted in KSA, TFRS)
If no jurisdiction is identifiable: ASK before proceeding.
Do NOT assume a default jurisdiction. Do NOT assume IFRS.
Step 2: Identify the Product
Map query terms to product skills:
| Query Terms |
Route To |
| murabaha, cost-plus, deferred sale, commodity murabaha, tawarruq, FAS 2 |
murabaha skill |
| ijarah, IMB, lease, ijarah muntahia bittamleek, FAS 8, FAS 32 |
ijarah-imb skill |
| diminishing musharaka, DM, home finance, co-ownership |
musharaka-dm skill |
| mudaraba, investment account, IAH, PER, IRR, FAS 3 |
mudaraba skill |
| musharaka, joint venture, partnership, FAS 4 |
musharaka-full skill |
| sukuk issuer, sukuk issuance, sukuk structuring, SPV |
sukuk-issuer skill |
| sukuk investor, sukuk holding, sukuk classification, SPPI |
sukuk-investor skill |
| salam, forward purchase, advance payment commodity, FAS 7 |
salam skill |
| istisna'a, construction finance, manufacturing contract, FAS 10 |
istisna-a skill |
| takaful, Islamic insurance, wakala model, participants fund |
takaful-ifrs17 skill |
| zakat, zakatable, nisab, ZATCA, sadaqah, purification |
zakat-global skill |
| shariah screen, halal stocks, prohibited sectors, PSX screen |
shariah-screening-global skill |
Step 3: Load the Jurisdiction Overlay
| Jurisdiction |
Load Overlay |
| Bahrain |
jurisdictions/bahrain-aaoifi.md |
| Qatar |
jurisdictions/qatar-aaoifi.md |
| Malaysia |
jurisdictions/malaysia-mfrs.md |
| Indonesia |
jurisdictions/indonesia-psak.md |
| Saudi Arabia, KSA |
jurisdictions/saudi-ifrs.md |
| UAE, Dubai, Abu Dhabi, DIFC, ADGM |
jurisdictions/uae-ifrs.md |
| Kuwait |
jurisdictions/kuwait-ifrs.md |
| Oman |
jurisdictions/oman-ifrs.md |
| Pakistan |
jurisdictions/pakistan-ifrs.md |
| UK, United Kingdom |
jurisdictions/uk-ifrs.md |
| Nigeria |
jurisdictions/nigeria-ifrs.md |
| Turkey |
jurisdictions/turkey-tfrs.md |
| GCC cross-border, multi-GCC |
jurisdictions/gcc-crossborder.md |
Step 4: Apply Rules in Order
- Apply product skill rules first (accounting mechanics)
- Apply jurisdiction overlay modifications (labels, presentation, disclosure)
- Confirm governing standard in response header before output
UNIVERSAL RULES — APPLY IN ALL JURISDICTIONS
Prohibited Terms — NEVER USE in any Islamic finance output
- "interest income" → use jurisdiction-appropriate income label
- "interest expense" → use "profit distributed to IAH" or "financing cost"
- "loans and advances" → in AAOIFI jurisdictions use "financing receivables"
- "net interest margin (NIM)" → use "net financing margin"
- "interest rate" → use "profit rate" or "effective profit rate"
Mandatory Shariah Compliance Escalation
Flag for SSB review when:
- A new product structure not previously covered by an existing fatwa
- A transaction where Shariah structural requirements may not have been met
- A non-Shariah income item that must be treated as charity (sadaqah)
- Any transaction involving interest-based conventional instruments proposed as Islamic finance
The Fundamental Limitation
This agent automates execution, schedule generation, journal entries,
disclosure drafting, and regulatory reporting. It does NOT make Shariah
compliance judgments. Shariah permissibility determinations are the exclusive
function of qualified Shariah scholars on the institution's SSB.
RESPONSE FORMAT
Every Islamic finance accounting output must begin with:
GOVERNING FRAMEWORK: [e.g., AAOIFI FAS 2 — Bahrain]
PRODUCT: [e.g., Murabaha]
JURISDICTION: [e.g., Bahrain — CBB Rulebook applies]
Jurisdiction Overlays
When a jurisdiction is identified, load the appropriate overlay:
- Bahrain (AAOIFI)
- Qatar (AAOIFI)
- Malaysia (MFRS)
- Saudi Arabia (IFRS)
- UAE (IFRS)
- UK (IFRS)
- Kuwait (IFRS)
- Oman (IFRS)
- Pakistan (IFRS)
- Indonesia (PSAK)
- Nigeria (IFRS)
- Turkey (TFRS)
- GCC Cross-Border
1---2name: islamic-finance-router3description: Routes Islamic finance queries to the correct product skill and jurisdiction overlay. Activate for any query involving Islamic banking, AAOIFI, Shariah- compliant finance, sukuk, takaful, murabaha, ijarah, musharaka, mudaraba, salam, istisna'a, zakat, or Shariah screening. Covers 20 jurisdictions across 3 accounting regimes (AAOIFI-primary, IFRS with Islamic guidance, local standards).4---56## PURPOSE78This is the top-level routing controller for the Islamic Finance Plugin.9It determines which product skill and which jurisdiction overlay to load10before generating any Islamic finance accounting output.11It does NOT contain accounting rules itself. It routes to the files that do.1213## ROUTING PROTOCOL — EXECUTE BEFORE ANY OUTPUT1415### Step 1: Identify the Jurisdiction1617Read the user query for jurisdiction signals:1819- Country name (Bahrain, Malaysia, UAE, Saudi Arabia, UK, Pakistan, Nigeria, etc.)20- Currency (BHD, MYR, AED, SAR, GBP, PKR, NGN)21- Regulator name (CBB, BNM, CBUAE, SAMA, PRA/FCA, SBP, CBN)22- Standard reference (AAOIFI FAS, MFRS, IFRS as adopted in KSA, TFRS)2324**If no jurisdiction is identifiable: ASK before proceeding.**25Do NOT assume a default jurisdiction. Do NOT assume IFRS.2627### Step 2: Identify the Product2829Map query terms to product skills:3031| Query Terms | Route To |32| ----------------------------------------------------------------------- | ------------------------------ |33| murabaha, cost-plus, deferred sale, commodity murabaha, tawarruq, FAS 2 | murabaha skill |34| ijarah, IMB, lease, ijarah muntahia bittamleek, FAS 8, FAS 32 | ijarah-imb skill |35| diminishing musharaka, DM, home finance, co-ownership | musharaka-dm skill |36| mudaraba, investment account, IAH, PER, IRR, FAS 3 | mudaraba skill |37| musharaka, joint venture, partnership, FAS 4 | musharaka-full skill |38| sukuk issuer, sukuk issuance, sukuk structuring, SPV | sukuk-issuer skill |39| sukuk investor, sukuk holding, sukuk classification, SPPI | sukuk-investor skill |40| salam, forward purchase, advance payment commodity, FAS 7 | salam skill |41| istisna'a, construction finance, manufacturing contract, FAS 10 | istisna-a skill |42| takaful, Islamic insurance, wakala model, participants fund | takaful-ifrs17 skill |43| zakat, zakatable, nisab, ZATCA, sadaqah, purification | zakat-global skill |44| shariah screen, halal stocks, prohibited sectors, PSX screen | shariah-screening-global skill |4546### Step 3: Load the Jurisdiction Overlay4748| Jurisdiction | Load Overlay |49| --------------------------------- | -------------------------------- |50| Bahrain | jurisdictions/bahrain-aaoifi.md |51| Qatar | jurisdictions/qatar-aaoifi.md |52| Malaysia | jurisdictions/malaysia-mfrs.md |53| Indonesia | jurisdictions/indonesia-psak.md |54| Saudi Arabia, KSA | jurisdictions/saudi-ifrs.md |55| UAE, Dubai, Abu Dhabi, DIFC, ADGM | jurisdictions/uae-ifrs.md |56| Kuwait | jurisdictions/kuwait-ifrs.md |57| Oman | jurisdictions/oman-ifrs.md |58| Pakistan | jurisdictions/pakistan-ifrs.md |59| UK, United Kingdom | jurisdictions/uk-ifrs.md |60| Nigeria | jurisdictions/nigeria-ifrs.md |61| Turkey | jurisdictions/turkey-tfrs.md |62| GCC cross-border, multi-GCC | jurisdictions/gcc-crossborder.md |6364### Step 4: Apply Rules in Order65661. Apply product skill rules first (accounting mechanics)672. Apply jurisdiction overlay modifications (labels, presentation, disclosure)683. Confirm governing standard in response header before output6970## UNIVERSAL RULES — APPLY IN ALL JURISDICTIONS7172### Prohibited Terms — NEVER USE in any Islamic finance output7374- "interest income" → use jurisdiction-appropriate income label75- "interest expense" → use "profit distributed to IAH" or "financing cost"76- "loans and advances" → in AAOIFI jurisdictions use "financing receivables"77- "net interest margin (NIM)" → use "net financing margin"78- "interest rate" → use "profit rate" or "effective profit rate"7980### Mandatory Shariah Compliance Escalation8182Flag for SSB review when:8384- A new product structure not previously covered by an existing fatwa85- A transaction where Shariah structural requirements may not have been met86- A non-Shariah income item that must be treated as charity (sadaqah)87- Any transaction involving interest-based conventional instruments proposed as Islamic finance8889### The Fundamental Limitation9091This agent automates execution, schedule generation, journal entries,92disclosure drafting, and regulatory reporting. It does NOT make Shariah93compliance judgments. Shariah permissibility determinations are the exclusive94function of qualified Shariah scholars on the institution's SSB.9596## RESPONSE FORMAT9798Every Islamic finance accounting output must begin with:99100```101GOVERNING FRAMEWORK: [e.g., AAOIFI FAS 2 — Bahrain]102PRODUCT: [e.g., Murabaha]103JURISDICTION: [e.g., Bahrain — CBB Rulebook applies]104```105106## Jurisdiction Overlays107108When a jurisdiction is identified, load the appropriate overlay:109110- [Bahrain (AAOIFI)](references/jurisdictions/bahrain-aaoifi.md)111- [Qatar (AAOIFI)](references/jurisdictions/qatar-aaoifi.md)112- [Malaysia (MFRS)](references/jurisdictions/malaysia-mfrs.md)113- [Saudi Arabia (IFRS)](references/jurisdictions/saudi-ifrs.md)114- [UAE (IFRS)](references/jurisdictions/uae-ifrs.md)115- [UK (IFRS)](references/jurisdictions/uk-ifrs.md)116- [Kuwait (IFRS)](references/jurisdictions/kuwait-ifrs.md)117- [Oman (IFRS)](references/jurisdictions/oman-ifrs.md)118- [Pakistan (IFRS)](references/jurisdictions/pakistan-ifrs.md)119- [Indonesia (PSAK)](references/jurisdictions/indonesia-psak.md)120- [Nigeria (IFRS)](references/jurisdictions/nigeria-ifrs.md)121- [Turkey (TFRS)](references/jurisdictions/turkey-tfrs.md)122- [GCC Cross-Border](references/jurisdictions/gcc-crossborder.md)