Skip to main content
Wobble-bibble provides a sophisticated prompt management system designed specifically for translating classical Arabic Islamic texts into English. The library uses a stacking architecture where specialized prompts are combined with a master prompt to create domain-specific translation instructions.

​
Architecture

The prompt system consists of:
  1. Master Prompt - The foundational ruleset that applies to all translations
  2. Specialized Prompts - Domain-specific add-ons that extend the master prompt for particular text types
When you request a specialized prompt (e.g., hadith), wobble-bibble automatically stacks it on top of the master prompt, ensuring consistent base rules while adding domain-specific guidance.

​
Available Prompts

Master Prompt

The foundational ruleset for all Islamic text translations

Hadith

For hadith collections with isnad chains and narrator evaluation

Fiqh

For Islamic jurisprudence texts with legal rulings and technical terms

Tafsir

For Quranic exegesis with verse citations and theological attributes

Fatawa

For legal opinions in Q&A format with questioner/scholar dialogue

Encyclopedia Mixed

For polymath works mixing hadith, fiqh, creed, and polemics

Jarh wa Tadil

For narrator criticism and authentication texts

Usul al-Fiqh

For legal theory texts with methodological disputes

​
Usage

Access prompts using the getPrompt() function: 
import { getPrompt } from 'wobble-bibble';

// Get a stacked prompt (master + specialized)
const hadithPrompt = getPrompt('hadith');
console.log(hadithPrompt.content); // Contains master + hadith rules

// Get just the master prompt
const masterPrompt = getPrompt('master_prompt');
console.log(masterPrompt.isMaster); // true

​
Key Features

​
Zero Arabic Script (Except ﷺ)

All prompts enforce a strict ban on Arabic script in output. Only the Prophet’s salutation symbol (ﷺ) is permitted.

​
ALA-LC Transliteration

Proper names and technical terms use full ALA-LC transliteration with diacritics (ā ī ū ḥ ṣ ḍ ṭ ẓ ʿ ʾ).

​
Technical Term Definitions

On first occurrence, technical terms must be defined: bidʿah (innovation)

​
Segment ID Preservation

All segments maintain their original IDs (e.g., P1234) for precise validation and tracking.

​
No Sanitization

Polemical terms and sensitive content are translated literally without softening or editorial commentary.

​
Choosing the Right Prompt

Rule of thumb: Match the prompt to the predominant genre of your text. For multi-genre works (like encyclopedias), use encyclopedia_mixed.
  • Pure hadith collections? → hadith
  • Fiqh manuals with legal rulings? → fiqh
  • Tafsir with Quranic commentary? → tafsir
  • Fatwa compilations (Q&A)? → fatawa
  • Narrator biographies/criticism? → jarh_wa_tadil
  • Legal methodology debates? → usul_al_fiqh
  • Mixed scholarly works? → encyclopedia_mixed

​
Next Steps

Explore Prompts

Browse detailed documentation for each prompt type

Validation Guide

Learn how wobble-bibble validates LLM outputs

Build docs developers (and LLMs) love

Get started for freeTalk to us