The Ihsan Agile Guide: Embedding Islamic Values in Agile Delivery

Ihsan Agile is an open-source Islamic Agile framework designed to be used modularly, overlaying existing Agile methods (Scrum, Kanban, SAFe) with principles drawn from The Qur'an and Sunnah. Teams may engage with individual practices, reflections, or roles without adopting the framework as a whole. It embeds niyyah (intention), iḥsān (excellence with God-consciousness), shūrā (consultation), and amānah (trust) into team workflows and product decisions, ensuring that Islamic values can become operational in everyday delivery practices. This framework helps Muslim-led teams align operational decisions with Islamic ethics through two complementary roles: Ihsan Agile Facilitator (IAF): Embeds ethical consciousness into how teams work, enriching Sprint Planning with Niyyah Check-ins, Retrospectives with Muhāsabah reflection, and Definition of Done with ethical completeness criteria. Ihsan Agile Product Steward (IAPS): Extends Islamic values into what teams build and how technical decisions are made, reframing "technical debt" as "technical disclosure," ensuring genuine stakeholder consultation (shūrā), prioritising public benefit (maṣlaḥah), and maintaining transparent stewardship (amānah) throughout the product lifecycle. New in Version 1.1: Ihsan Agile Product Steward (IAPS) role addressing critical gaps in conventional product ownership Technical Uncertainty Register (TUR) transforming hidden technical constraints into disclosed commitments that build stakeholder trust Gharar Assessment Checklist evaluating when technical shortcuts require stakeholder disclosure and consent Critical analysis showing how conventional technical debt frameworks create gharar (harmful uncertainty) through non-disclosure and normalise riba-based thinking through interest metaphors Practical guidance on technical disclosure as trust-building: teams take shortcuts for legitimate reasons; the question is whether those shortcuts remain hidden liabilities or become transparent realities Stakeholder Barakah Reviews ensuring genuine consultation with those affected by technical decisions Implementation guidance for Scrum, Kanban, and SAFe with phased adoption pathways Concrete worked scenarios and ready-to-use templates for TUR, Gharar Assessments, Ethical Definitions of Done, and Stakeholder Barakah Reviews May our systems be honest about their limits, not just efficient in their outputs.