Abdus-Samad Ahmed Yaqeen · Application
Yaqeen Institute · AI & Creative Technology Engineer

A lot of this was built after the children went to sleep.

I'm Abdus-Samad. I'm a doctor, I'm in the final leg of a bachelor's in Ḥanafī fiqh at WISE University in Jordan, and I teach Islamic studies in my community, from Tuḥfat al-Mulūk to al-Ṭaḥāwiyyah. Most importantly, I'm a dedicated father, willing to work relentlessly to build what my family and community need. This is my application in two parts. Part 1 is the work. Part 2 is what I think Yaqeen and I could do with it.

The ledger
15 April – 8 November 2026
3,648
commits across ten repositories. 1,137 of them landed between 9pm and 3am
2,199
classical Ḥanafī texts from my teacher's private library, brought off his laptop and onto the web
~900
medical-fiqh questions on shifa.ac, and growing
86
children's stories I've written and fact-checked myself. Nowhere near finished.
8
learning games that drill the words a child has just read
200
families in London reading with Arabic Book Club

Counted from the git history on my laptop. The commit total also includes GP Trainer, an AI examiner for GP exam practice, which I've left out of this page to keep it about the tradition.

Part 1 · The work

Four rooms, one tradition.

Yaqeen asked for two or three things I've built. I've grouped mine by the room they get used in, because that's honestly how I think about them: the same body of knowledge, carried one step further from the scholar's desk each time.

First the library, then the classroom, then the clinic. Last, the bedroom, which is where Part 2 begins.

Library Classroom Clinic Bedroom
01
Room 01 · The library

Fiqh Revival & al-Mawsūʿah al-Ḥanafiyyah

الموسوعة الحنفية
?The problem

The Ḥanafī library is enormous, and most of it lives in desktop software from another era or in scanned PDFs. You can't read it properly on a phone, you can't search across the commentaries, and you can't easily see why a ruling is what it is.

✎What I built
  • Fiqh Revival, a reader-first library for classical texts on the web, with a native iPad app, built first around the texts I teach: Tuḥfat al-Mulūk, al-Qudūrī and al-Ṭaḥāwiyyah. Arabic first with the translation beside it, tools for teachers, and an AI study companion that retrieves from the texts and is fenced off from issuing fatwas.
  • al-Mawsūʿah al-Ḥanafiyyah for Android, an offline reader for mawsua.com: full-text Arabic search, a real page curl on foldables, highlights and voice notes, export to Markdown and PDF, read-aloud. Sixty-one commits in three days, guarded by a hundred screenshot tests.
  • Maktaba Ḥanafiyya: my teacher Shaykh Ṣalāḥ's own customised build of al-Maktaba al-Shāmila, into which he had added over 1,000 books from his private collection, scanned and OCR'd. It lived on his laptop. With his permission I brought all 2,199 books out and rebuilt them for the web, with corpus-wide Arabic search that normalises spelling and diacritics, so the world can share them.
  • Translation swarms for al-Ghaznawī's Sharḥ al-Ṭaḥāwiyya and for my teacher's notes on al-Qudūrī. I know where AI goes wrong and hallucinates, so the pipeline is built around it: small batches of three sections per agent, a controlled glossary, a validator that rejects any batch whose tags drift, and the Arabic always kept beside the English so every line can be checked.
  • The Qudūrī graph, which pins every masʾalah to the ʿillah, maʿnā and qāʿidah behind it. Hover the diagram to walk a chain.
✓What changed

A scholar's private library that existed on one laptop is now open to anyone. And a student on the Tube with no signal can open Mukhtaṣar al-Qudūrī, search every commentary for مسح الرأس, and follow a ruling back to the principle that produced it.

Next.jsSupabase / PostgresSwiftUI + GRDBKotlin + ComposeSQLite FTS5 + trigramCloudflare R2Python ETLClaude agent swarms
Qāʿidah · legal maxim
العبادات مبناها على التوقيفActs of worship are founded on textual prescription.QAW-008
المشقة تجلب التيسيرHardship brings ease.QAW-009
Maʿnā · underlying meaning
الفرض يثبت بالتواتر والمشاهيرIntegrals are only established by definitive proof.MAN-005
ʿIllah · operative cause
الفرض هو ماهية العملThe farḍ are the integrals of a deed.ILL-008
Masʾalah · ruling
الفرض ما لا يصح الوضوء بدونهThe farḍ is that without which wuḍūʾ is not valid.TAH-001
فرض الوضوء غسل الأعضاء الثلاثة ومسح الرأسQiyās: wash three limbs, wipe the head.TAH-002
الاستحسان: مسح الخفينIstiḥsān: wiping over leather socks.TAH-003
Real chains from Kitāb al-Ṭahārah, translated and tagged by the swarm. Skip-level links are allowed.
Search screen Notes and highlights Library home in dark mode
Two-page spread of Mukhtaṣar al-Qudūrī with a page mid-curl on a foldable phone
al-Mawsūʿah on a Galaxy Z Fold: unfold it and you get a two-page spread with a page you can drag.
02
Room 02 · The classroom

A slide workflow for teaching al-Qudūrī

مختصر القدوري · كتاب الطهارة
?The problem

I teach Tuḥfat al-Mulūk, al-Qudūrī and al-Ṭaḥāwiyyah in my community, through a Foundations Programme for university students and the FrontRunners Development Programme for high-school students. Building slides by hand took longer than preparing the lesson, the diagrams kept drifting into decoration, and PowerPoint kept mangling the Arabic.

✎What I built
  • A playbook and a builder that turn a chapter exported from Fiqh Revival into a complete teaching deck, exportable to PowerPoint.
  • A fixed grammar for every deck: chapter map, a dark divider for each part, the matn inside an arch with its translation beside it, then one to three commentary slides.
  • The commentary slide is chosen by the shape of the argument. A qiyās with an istiḥsān exception gets an arrow from one to the other. Grades of ruling get coloured rows. A list of farāʾiḍ gets numbered cards.
  • Matn, āyāt and aḥādīth always go on the slide verbatim in Arabic, with their references. Nothing is paraphrased.
✓What changed

Every chapter now comes out in the same visual language. My students, from university down to high school, learn the colours once, and after that they can read the structure of an argument before they've read a word of it.

A diagram must be useful and meaningful. No diagrams for the sake of diagrams.Rule 1 of the playbook
RULING 2 · 3
Wiping over leather socks
الاستحسان: مسح الخفين
Qiyās · base rulingThe obligatory acts of wuḍūʾ are washing the three limbs and wiping the head.
Basis · the texts{يَا أَيُّهَا الَّذِينَ آمَنُوا إِذَا قُمْتُمْ إِلَى الصَّلَاةِ فَاغْسِلُوا وُجُوهَكُمْ وَأَيْدِيَكُمْ إِلَى الْمَرَافِقِ وَامْسَحُوا بِرُءُوسِكُمْ وَأَرْجُلَكُمْ إِلَى الْكَعْبَيْنِ}[المائدة: 6]
Istiḥsān · the exceptionWiping over the leather socks.
Basis · the texts«حدثني سبعون رجلاً من أصحاب النبيّ ﷺ أنَّهم رأوه يمسح على الخُفين»أخرجه العيني في البناية 1: 554
PrincipleHardship brings ease.
Rebuilt here in HTML from the deck's grammar, with the playbook's colours. Tap a colour.
Slide: Intention, three views Slide: Combing the beard Slide: The ritual bath, where we are
Three slides from the real Ṭahārah deck.
03
Room 03 · The clinic

shifa.ac

المجمع الفقهي الطبي الدولي

This is where my two lives meet. I practise medicine, I'm finishing a bachelor's in Ḥanafī fiqh at WISE University in Jordan, and I study under Shaykh Ṣalāḥ Abū al-Ḥājj. shifa.ac is what happens when you stop treating those as separate jobs.

?The problem

A patient wondering whether an MRI breaks their fast searches at midnight and lands on a forum. Doctors meet new cases with nothing reviewed to point to in English. The scholarship exists; it just isn't where anxious people look.

✎What I built
  • A bilingual Arabic and English fatwa portal and journal for the International Medical Fiqh Institute.
  • One box. Type a question in either language. A retrieval-only assistant looks for the closest published, reviewed answer. If there isn't one, the same box becomes a submission to the panel, already filled in.
  • About 900 questions are in so far, each indexed whether it's answered yet or not, so the site is useful and findable before the panel has finished.
  • Every answer carries the scholar who drafted it, the reviewer who signed it, the date, and its sources. A drafting and review workflow behind it. Built to run on about ten dollars a month.
✓What changed

Nobody hits a dead end, and nobody is ever handed a machine-written ruling.

Next.jsSupabase + pgvectorAI GatewayRTL / LTR parityi18nPlaywright
shifa.ac
EN · ع
Can I break my fast for an MRI?
Published · reviewed

Can I break my fast for an MRI?

Drafted byA named panel scholar
Reviewed byA named reviewer
Reviewed onThe date it was signed
SourcesCited in the text
Not answered yet

Our panel hasn't answered this one yet.

Send it to them. We've already filled in your question.

Send to the panel →
The ask-or-find flow, mocked up. Answer text is blurred on purpose: rulings are written by people.
~900questions so far
1box to ask or find
2languages, equal
~$10a month to run

The AI finds. It never answers.

04
Room 04 · The bedroom

Arabic Book Club

نادي الكتاب العربي

I made it for my own children. Learn Arabic like it's your ABCs. It's a library of illustrated stories in fully vowelled Arabic, graded so finely that a five-year-old can start at the bottom and, years later, pick up Qaṣaṣ al-Nabiyyīn and read it unaided. The app's real job is to make itself unnecessary.

The shelf

86 stories so far, and nowhere near finished. Here are 24.

Scroll →
?The problem

Muslim children in the West mostly can't read the language of the Qur'an, and the stories they love were written by people who don't share their faith. What exists for them in Arabic is mostly worksheets.

✎What I built
  • A native iPhone and iPad app (Swift 6, offline-first) and a web reader, sharing one backend. Twenty graded levels, tap-any-word glosses, comprehension questions, spaced review.
  • A story pipeline that keeps the Arabic honest: a vocabulary ledger keyed by word sense, recycling floors at every level, and AraMorph morphology to pick the right gloss. On the first live test the naive picker glossed a word as "tongues". The ranker got it right.
  • I fact-check every story myself: the Arabic, the glosses, the Qur'anic references and every Islamic detail, before a child sees it.
  • Illustration to a style bible and character sheets, so Hamza looks like Hamza on every page. No faces for prophets, Ṣaḥābah or Ahl al-Bayt, checked at full size before anything ships.
  • Eight games built on the child's own vocabulary, a Studio where a parent and child write their own story with AI, a print shop that posts books worldwide through Lulu, and black-and-white activity books generated from the same stories.
✓What changed

Two hundred families in London now read with it. Behind them: 1,774 commits across the app and the web, and a shelf that grows every week.

Try it · tap any Arabic word
الْقَمَرُ اخْتَبَأَThe Moon Hid · Level 1
Tap a word to see what it means, where it comes from, and where it appears in the Qur'an.
The real text and word data from the book, including the AraMorph-matched glosses.
The reader
Review & games
Word Worm
Dino Run
Word Invaders
Root Runner
Picture Pop
Word Pilot
Word Stack
Match Pairs
On paper

The same stories, off the screen

A bookstore with its own basket and checkout. Stripe takes the payment, Lulu's print API prints and posts the book anywhere in the world, and nobody ever sees a third-party storefront.

Activity books

Colour, line, dots

Every story can be re-drawn as line art and dot-to-dot pages, then bound into a black-and-white activity book. The editor lets me swap any drawing I don't like.

Studio

Your child's own book

A parent and child type an idea in English. It comes back as an illustrated story in Arabic, saved to the family's shelf. Anything shared beyond the family goes through human moderation first.

Full-colour page: a little monkey on a bridge over the Thames The same scene as a colouring page Printed cover of Animal Adventures
The Little Monkey in London, in colour and as an activity page. Right: the printed Animal Adventures collection.
Still room 04 · After lights out

Teaching the library to move.

  1. The problem

    Children watch before they read.

    An animation studio costs more than any Muslim charity I know can spend. Off-the-shelf AI video wanders off-model, invents text, and gets faces wrong, which for us isn't a style problem. It's a red line.

  2. 01 · Motion

    Veo 3.1 animates our own art.

    Every shot starts from an illustration that's already been approved. Because the first frame is our picture, Raʿd stays Raʿd. Veo never writes text and never speaks.

  3. 02 · Voice

    The lines are read, not written.

    Chirp 3 HD voices the Arabic, each character cast to the same voice the app uses. The English narration is my own cloned voice on ElevenLabs. Every Arabic word on screen is copied verbatim from the book's source file.

  4. 03 · Music

    A cappella, checked by ear.

    Lyria writes wordless beds, men's voices only. I listen to every take for instruments before it goes anywhere near a cut.

  5. 04 · The cut

    Remotion puts it together.

    Arabic pops in word by word with the English underneath, the cut is mastered to −14 LUFS for Reels and Shorts, and a budget guard reads the spend log before every single Veo call.

  6. What changed
    $0.60per four-second shot

    The Raʿd films so far took 23 takes and $15.80 of Veo time, every take logged with its prompt, model and cost. The animation is the cheap part. The engineering behind it isn't, and that bill is further down.

Part 2 · The proposal

The smallest circle.

Conviction Circles is a lovely idea: a halaqa in a box, so any group of adults can talk about their faith properly without a scholar in the room.

There's a smaller circle than that, and it meets more often.

It meets every night. It has two members, and one of them is six.

It's bedtime. And in a lot of Muslim homes in the West, someone else is telling the story.

Yaqeen, today → the home, every night

Conviction CirclesArabic Book Club

  • Adultsa parent and a child
  • Once a weekevery single night
  • A kit and a facilitatora story, a voice, a lamp
The revival of the home

A circle meets once a week. A home meets every day.

07:15
Before school

The learning app

Ten minutes of Word Worm over breakfast, using the words from last night's book. It feels like a game because it is one.

16:30
After school

The activity book

The same story in black and white, with a dot-to-dot and a pencil. No screen, and the characters are already friends.

Dot-to-dot activity page
18:00
Screen time

Animated stories

Instead of whatever autoplay picks: Raʿd, who gets his strength from remembering Allah rather than from a radioactive spider.

Raʿd, the hero of the animated series
19:30
Bedtime

Bedtime stories & books

A printed book, a parent's voice, and a boy waiting for the moon. This is the circle the rest of the day is building towards.

A girl at a window at night looking at the crescent moon
Sat
The weekend

Studio

Your child invents a story. It comes back illustrated and in Arabic, and it goes on the shelf next to the others. Pride in who you are starts with seeing yourself in a book.

Illustration of a monkey in London with Big Ben and a red bus
Why now

Ten years ago this needed a studio. Now it needs a stubborn parent and a laptop.

Every part of what you've just scrolled through used to be its own profession: illustrator, animator, voice actor, Arabic editor, app developer, printer. AI has folded most of it into one pipeline that one person can run.

It isn't free. The last month of AI engineering alone came to about $3,000 at API list prices. But that's one person and a team of agents doing what used to take a studio, so the scarce thing now is judgement: knowing what a six-year-old will love, what a scholar will sign, and what a machine must never be allowed to do. That last part matters more than the rest put together, so I wrote it into the code.

~$3,000AI engineering in the last 30 days at API prices, covered by my Claude Max plan
~$10,000the whole build since April, estimated
$0.60per four-second Veo shot
1person, directing a lot of agents

The real bill

Claude Code$2,750 – $3,1109 Oct – 9 Nov · Opus 5.5, Sonnet 5.5, Fable 5.1 · 8.3 billion cached tokens read, 24.7 million written · local transcripts priced at API list rates
Codex≈ $12523 Oct – 8 Nov · GPT-6.1 · 648 million input tokens, 1.3 million output · local session logs
Veo 3.1$15.8023 takes for the Raʿd films, each logged by the budget guard
Whole build≈ $10,000Estimate: the logged month scaled by commits (3,648 in total, 1,109 in that month). Claude Code only keeps 30 days of history.
Actually paidA flat Claude Max subscription, plus ChatGPT Plus for CodexAlhamdulillah. The per-token figures above are what the same work costs on the API, which is the honest number for a team to budget against at scale.
Not countedCursor, voice, images, hosting, print proofsPaid, but not in these logs

What the machines aren't allowed to do

01 ✕Put Arabic on screen. Every word comes from a reviewed source file, or from a real recording of the app.
02 ✕Draw the face of a prophet, a Companion, or one of the Ahl al-Bayt.
03 ✕Write text into a video, or speak in one.
04 ✕Add instruments to the music.
05 ✕Answer a fiqh question. On shifa.ac the assistant finds published answers. People write them.
06 ✕Spend past the budget. A guard checks the log before every paid call.
The proposal

Conviction CirclesArabic Book Club

The circle, moved home.

Yaqeen's brief for Part 2 asks me to pick one existing Yaqeen series and one place where AI or creative technology could make it better. I picked Conviction Circles, and I'd go further than improving it: take the circle out of the meeting room and put it in the home, every night, with Arabic Book Club as the vehicle.

01The challenge

The children aren't in the room.

Conviction Circles gathers adults in a room once a week, with a kit. Their children aren't in that room. They're at home, and at home the stories come from somewhere else: YouTube at breakfast, Netflix after school, a library book at bedtime. Those stories are beautifully made, which is exactly the problem.

Muslim parents in the West feel it as a quiet cultural crusade being fought in their own living rooms. A weekly circle can't win that on its own. The home needs something every day, and something better to hand a child at half past seven.

02The solution

Replace the circle with the home.

Arabic Book Club becomes Yaqeen's circle for families. Every theme Yaqeen researches becomes a set, scaled down to the size of a child:

BEDTIMEA storyIllustrated, Arabic and English, at three reading levels
SCREEN TIMEA shortTwo minutes of animation from the same art
AFTER SCHOOLAn activity bookLine art and dot-to-dots of the story, printable
DINNERThree questionsFor the parent to ask, so the conversation happens at home

No room to book and no facilitator to train. The circle meets every night, a parent leads it, and it sits on the same shelf as everything else the child already reads, plays and watches. When Yaqeen publishes on tawakkul, that week a six-year-old meets a boy who waits patiently for the moon.

03Tools & approach

The ABC pipeline, pointed at Yaqeen's research.

Nothing here needs inventing. It's the pipeline that already makes ABC, with two scholar gates added (◆).

Yaqeen paperThe Circle's source research
Scholar briefOne page: the idea, what must be true, what must never be said
Story draftsClaude inside the ABC story builder: vocabulary ledger, AraMorph, validators
IllustrationImage model held to a style bible and character sheets
Motion & voiceVeo 3.1 from approved art, Chirp / ElevenLabs, Lyria a cappella
Cut & printRemotion, line-art generator, Lulu print API
Scholar sign-offThe finished set, reviewed as one
ShipABC app and web, print, YouTube
04Quality & accuracy

Two signatures, and rules enforced in code.

Today I fact-check every story myself, line by line. At Yaqeen's scale that becomes two signatures. A scholar approves the one-page brief before a single image is generated. The same scholar approves the finished set before it ships. Between those two signatures the machines work inside the six rules above, enforced by validators and guards rather than a style guide someone might forget to read.

Every take is kept with its prompt, model, cost and date, so we can always show where a frame came from. That's provenance as a habit, not a feature request.

05Measuring success

Five numbers, one of which matters most.

SpeedDays from paper to family edition. The target is the same week as the adult kit, not the months a children's book normally takes.
CostCost per finished set: video, voice, images and engineering, at API prices. I already log every Veo take and can price every agent run from its logs; the same ledger extends to everything else.
AccuracyFirst-time approval rate at both scholar gates. If it drops, the brief template or the rules need work, not the scholars.
ReachFamilies reading each Yaqeen theme the week it comes out, and how many come back the week after.
The oneNights per week a child reads with a parent, straight from the reading streaks ABC already records.
The ask

200 homes in London. Now everywhere else.

I've built the library, the films, the games, the print shop and the pipeline that feeds them, on my own, alongside medicine. It runs. What it doesn't have is what Yaqeen has: scholars who can sign every script, a name parents already trust, and a community in cities I'll never visit. Put those together and any Muslim child who wants one gets a bedtime story that makes them proud of who they are.

200homes · London
From far enough away, a home reading at bedtime looks a lot like a star.
الْقَمَرُ ظَهَرَ!
The moon came out!

In that first book, a cloud covers the moon. Hamza is sad, and he waits. Then the moon comes out, and he thanks Allah for it.

A lot of Muslim homes in the West are somewhere in the middle of that story. The light is still there. Something big is in front of it.

I've spent this year building the thing that moves the cloud, seeking help in Allah. I'd like to spend the next few doing it with Yaqeen.

Abdus-Samad Ahmed
Doctor · Ḥanafī fiqh student, WISE University · teacher · father