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: