Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
4 changes: 2 additions & 2 deletions islamic-finance/.claude-plugin/plugin.json
Original file line number Diff line number Diff line change
@@ -1,7 +1,7 @@
{
"name": "islamic-finance",
"version": "2.0.0",
"description": "Jurisdiction-aware Islamic finance domain agent. 12 product skills (murabaha, ijarah, sukuk, takaful, musharaka, mudaraba, salam, istisna'a, zakat, shariah screening), 13 jurisdiction overlays, 4 domain commands. Covers AAOIFI, IFRS with Islamic guidance, and local standards across 20 jurisdictions.",
"version": "3.0.0",
"description": "Jurisdiction-aware Islamic finance domain agent. 1 router + 12 product skills (murabaha, ijarah, sukuk, takaful, musharaka, mudaraba, salam, istisna'a, zakat, shariah screening), 13 jurisdiction overlays, 4 domain commands. Covers AAOIFI, IFRS with Islamic guidance, and local standards across 20 jurisdictions.",
"author": {
"name": "Panaversity",
"url": "https://github.com/panaversity"
Expand Down
4 changes: 4 additions & 0 deletions islamic-finance/.gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,4 @@
.DS_Store
__pycache__/
*.pyc
.env
29 changes: 29 additions & 0 deletions islamic-finance/CLAUDE.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,29 @@
# Islamic Finance Plugin — Development Guide

## Identity

v3.0.0 — Islamic Finance Domain Agent plugin for Cowork.

## Architecture

1 router skill + 12 product skills + 13 jurisdiction overlays + 4 commands.

The router (`skills/islamic-finance-router/SKILL.md`) identifies jurisdiction and product from queries, then loads the correct product skill and jurisdiction overlay. Products are standalone skills that auto-activate through the router.

## Key Files

- `skills/islamic-finance-router/SKILL.md` — routing logic
- `skills/islamic-finance-router/references/jurisdictions/*.md` — 13 overlays
- `skills/islamic-finance-router/references/aaoifi-fas-reference.md` — AAOIFI FAS lookup
- `skills/islamic-finance-router/references/global-standards-map.md` — 20-jurisdiction map
- `commands/*.md` — 4 domain commands
- `hooks/hooks.json` — SessionStart + PostToolUse hooks
- `evals/` — golden file tests
- `scripts/validate-routing.py` — routing validation

## Universal Rules

- NEVER use "interest income" — use jurisdiction-appropriate label
- NEVER use "loans and advances" in AAOIFI jurisdictions
- NEVER make Shariah compliance judgments — escalate to SSB
- Every output must have GOVERNING FRAMEWORK / PRODUCT / JURISDICTION header
56 changes: 27 additions & 29 deletions islamic-finance/README.md
Original file line number Diff line number Diff line change
Expand Up @@ -44,7 +44,10 @@ islamic-finance/
├── .claude-plugin/plugin.json # Plugin manifest
├── skills/ # 13 skills (auto-loaded by agent)
│ ├── islamic-finance-router/ # Routes to correct product + jurisdiction
│ │ └── references/jurisdictions/ # 13 jurisdiction overlays (on-demand)
│ │ └── references/
│ │ ├── jurisdictions/ # 13 jurisdiction overlays (on-demand)
│ │ ├── aaoifi-fas-reference.md
│ │ └── global-standards-map.md
│ ├── murabaha/ # Cost-plus financing
│ ├── ijarah-imb/ # Lease-to-own
│ ├── musharaka-dm/ # Diminishing partnership
Expand All @@ -64,51 +67,46 @@ islamic-finance/
│ └── if-zakat.md # /if-zakat — zakat computation
├── hooks/hooks.json # SessionStart + PostToolUse validation
├── scripts/validate-routing.py # 13-jurisdiction routing test harness
├── evals/ # Golden-file tests
├── exercises/ # 14 exercise data files (download as zip)
├── workflow-recipes/ # 4 operational playbooks (download as zip)
└── references/ # AAOIFI FAS reference tables
└── evals/ # Golden-file tests
```

---

## Commands

| Command | What It Does | Example |
|---------|-------------|---------|
| Command | What It Does | Example |
| ------------- | ------------------------------------ | ---------------------------------------------------- |
| `/if-journal` | Generate journal entries + schedules | `/if-journal murabaha bahrain "BHD 500K, 18mo, 18%"` |
| `/if-compare` | Compare across jurisdictions | `/if-compare murabaha bahrain malaysia` |
| `/if-screen` | Shariah compliance screening | `/if-screen sc-malaysia "company data..."` |
| `/if-zakat` | Compute zakat | `/if-zakat saudi "equity SAR 40B, ..."` |
| `/if-compare` | Compare across jurisdictions | `/if-compare murabaha bahrain malaysia` |
| `/if-screen` | Shariah compliance screening | `/if-screen sc-malaysia "company data..."` |
| `/if-zakat` | Compute zakat | `/if-zakat saudi "equity SAR 40B, ..."` |

---

## How Each Folder Maps to Chapter 20 Lessons

| Folder | Lessons | What You Do |
|--------|---------|-------------|
| `skills/murabaha/` | L04 | Process murabaha transactions, compare AAOIFI vs MFRS |
| `skills/ijarah-imb/` | L05 | Ijarah-IMB across 4 jurisdictions |
| `skills/sukuk-*/` | L06 | Sukuk from issuer and investor perspectives |
| `skills/takaful-ifrs17/` | L07 | Takaful with IFRS 17 overlay |
| `skills/islamic-finance-router/` | L08-L11 | Jurisdiction-specific deep dives |
| `skills/zakat-global/` | L12 | Zakat computation across jurisdictions |
| `skills/shariah-screening-global/` | L13 | Shariah screening methodologies |
| `exercises/` | L04-L17 | Hands-on exercise data |
| `workflow-recipes/` | L15-L16 | Operational workflow playbooks |
| `evals/` | L17-L18 | Capstone validation |
| Folder | Lessons | What You Do |
| ---------------------------------- | ------- | ----------------------------------------------------- |
| `skills/murabaha/` | L04 | Process murabaha transactions, compare AAOIFI vs MFRS |
| `skills/ijarah-imb/` | L05 | Ijarah-IMB across 4 jurisdictions |
| `skills/sukuk-*/` | L06 | Sukuk from issuer and investor perspectives |
| `skills/takaful-ifrs17/` | L07 | Takaful with IFRS 17 overlay |
| `skills/islamic-finance-router/` | L08-L11 | Jurisdiction-specific deep dives |
| `skills/zakat-global/` | L12 | Zakat computation across jurisdictions |
| `skills/shariah-screening-global/` | L13 | Shariah screening methodologies |
| `evals/` | L17-L18 | Capstone validation |

---

## Customizing for Your Jurisdiction

| Variable | Default | Your Value |
|----------|---------|-----------|
| Currency | Multi-currency (per jurisdiction) | _your currency_ |
| Primary Framework | AAOIFI / IFRS (auto-detected) | _your framework_ |
| Regulatory Body | Per jurisdiction | _your regulator_ |
| Zakat Method | Jurisdiction-specific | _your method_ |
| Screening Methodology | SC Malaysia | _your preferred methodology_ |
| Variable | Default | Your Value |
| --------------------- | --------------------------------- | ---------------------------- |
| Currency | Multi-currency (per jurisdiction) | _your currency_ |
| Primary Framework | AAOIFI / IFRS (auto-detected) | _your framework_ |
| Regulatory Body | Per jurisdiction | _your regulator_ |
| Zakat Method | Jurisdiction-specific | _your method_ |
| Screening Methodology | SC Malaysia | _your preferred methodology_ |

To customize: edit the relevant jurisdiction overlay in `skills/islamic-finance-router/references/jurisdictions/` or create a new one following the same format.

Expand Down
90 changes: 0 additions & 90 deletions islamic-finance/exercises/ex01-murabaha-bahrain-malaysia.md

This file was deleted.

Loading
Loading