🌙 Ramadan Wellbeing Advisor agent

An easily configurable and customizable country-agnostic configuration template to build and deploy a Ramadan Wellbeing Advisor Copilot Agent.

What this repo gives you

• A reusable agent instruction template with country placeholders
• Per-country knowledge source files (add as many as you need)
• Starter prompts + prompt-of-the-day scaffolding
• Demo walkthrough + post-Ramadan repurpose guidance

🎯 Goals

• Drive Copilot Agent awareness and adoption using a seasonal, culturally relevant scenario
• Help users stay productive during shorter Ramadan working hours
• Support wellbeing routines aligned with fasting (timings, recipes, exercise, charity, events)

📦 Repo structure

agent-config/        # agent name/description/instructions/guardrails
knowledge-sources/   # per-country source allowlists (Qatar/Saudi/UAE examples + template)
prompts/             # starter prompts, prompt-of-the-day framework
docs/                # configuration & demo walkthrough
presentations/       # optional slide assets (add your PPTX here)

🚀 Quick start guidance

1. Copy knowledge-sources/country-template.md to knowledge-sources/<country>.md and fill it.
2. Update agent-config/agent-description.md and agent-config/agent-instructions.md placeholders.
3. Paste the knowledge allowlist into your agent’s Knowledge settings.
4. Add starter prompts from prompts/starter-prompts.md.

🛡️ Guardrails (non-negotiable)

• Use only approved knowledge sources in the allowlist
• Do not provide medical diagnosis; redirect to a professional where needed
• Do not answer religious rulings (Quran/Hadith/fatwa). Redirect to the official religious authority site for the user’s country.

🗓️ Ramadan dates

This template uses placeholders:

• {RAMADAN_START_DATE} → e.g., 18-Feb-2026
• {RAMADAN_END_DATE} → e.g., 17-Mar-2026

🤝 Contributing

See CONTRIBUTING.md.

📄 License

MIT (see LICENSE).