fact-check-sunnah-quran

name: fact-check-sunnah-quran description: Verifies Sunnah, Hadith, and Quran content for accuracy and correct sourcing. Use when adding Islamic content, reviewing religious references, or ensuring hadith and Quran verses have valid sources and match authentic texts.

Sunnah, Hadith & Quran Fact-Checking

Purpose

Ensure all Islamic content in the codebase has:

1. Correct source references (valid hadith numbers, proper collection names)
2. Working verification links (Sunnah.com, Quran.com)
3. Accurate text (Arabic/English matching authentic sources)
4. Appropriate grading (prefer Sahih; note if Da'if/weak)

Verification Workflow

1. Hadith References

Required fields for each hadith:

• collection: bukhari, muslim, abudawud, tirmidhi, nasai, ibnmajah
• hadithNumber: Sunnah.com uses global numbering (e.g., Bukhari 6320, not Book 80 Hadith 17)
• narrator: Should match Sunnah.com

Verification steps:

1. Build URL: https://sunnah.com/{collection}:{hadithNumber}
2. Fetch the page and verify:
   • Hadith exists (no 404)
   • Arabic/English text matches or is appropriately paraphrased
   • Narrator is correct
   • Grade: prefer Sahih; document if Da'if
3. Link format in HadithTooltip: uses collectionMap for URL building

Sunnah.com collection mapping:

• bukhari, muslim, abudawud, tirmidhi, nasai, ibnmajah

2. Quran References

Required fields:

• surah: 1-114
• ayahStart, ayahEnd (optional for single verse)
• surahName, surahNameArabic

Verification steps:

1. Build URL: https://quran.com/{surah}/{ayah}
2. Verify Arabic text matches Uthmani script (minor variants acceptable)
3. Translation should be from a reputable source (e.g., Saheeh International, Muhsin Khan)
4. Audio URLs: islamic.network CDN uses format .../ar.alafasy/{verse_number}.mp3 (verse number = global position in Quran)

Quran verse numbering:

• Surah 2:255 = Ayat al-Kursi
• Surah 2:285-286 = Last two verses of Al-Baqarah
• Surah 112-114 = Three Quls (Al-Ikhlas, Al-Falaq, An-Nas)

3. Common Pitfalls

4. Key Verification Sources

• Hadith: https://sunnah.com (primary)
• Quran text/translation: https://quran.com
• Quran API: https://api.alquran.cloud (for programmatic verification)
• Audio: https://cdn.islamic.network/quran/audio/

Fact-Check Checklist

When adding or reviewing Islamic content:

• Every hadith has valid Sunnah.com link
• Hadith number matches collection (Bukhari 1-7563, Muslim 1-3030, etc.)
• Quran verses have correct surah:ayah
• Arabic text matches authenticated source
• Translation is accurate paraphrase
• Weak (Da'if) hadith are noted when used
• No conflicting references (e.g., "Muslim 234" when 234 is wrong)