almustafa-ai/hausa-prompt-engineering

Curated Hausa prompt engineering examples with before/after analysis, linguistic reasoning, and cultural context — by a 15-year professional Hausa translator # 🌍 Hausa Prompt Engineering ### A professional linguist's guide to crafting better AI prompts in Hausa *By Almustafa Emanuel Joseph-Alo — 15+ years professional Hausa translator & localiser* --- ## Why This Repository Exists Most AI models struggle with Hausa — not because the technology cannot handle it, but because the people designing prompts for Hausa do not speak it professionally. Hausa is spoken by **70+ million people** across Nigeria, Niger, Ghana, Sudan, and the diaspora. It has complex morphology, tonal distinctions that change meaning entirely, strict register differences between formal and colloquial usage, and deep cultural context that no machine has yet learned on its own. This repository documents **what works, what fails, and why** — from the perspective of someone who has spent 15 years working with Hausa professionally as a translator, localiser, and language specialist. Every prompt example here is: - Tested against a live AI model - Analysed linguistically for what changed and why - Grounded in real professional translation experience - Useful to NLP researchers, AI developers, and prompt engineers working with Hausa --- ## How to Read Each Example Every prompt example follows this structure: - Domain — the real-world context (formal writing, education, health, etc.) - Goal — what we are trying to get the AI to produce - Bad prompt — the vague or naive version most people would write - Bad output — what the AI actually returns (and why it fails) - Refined prompt — the improved version with linguistic reasoning applied - Refined output — the significantly better result - What changed — the linguistic and cultural reasoning behind the improvement --- ## Prompt Examples --- ### 001 — Formal Letter Writing in Hausa **Domain:** Administrative and government correspondence **Goal:** Generate a formal letter in Hausa appropriate for a Northern Nigerian government context --- **❌ Bad Prompt:** ``` Write …