docs/introduction.md

Nepal Justice Weaver

---

Making the three core features (Law Explanation via RAG, Bias-Free Letter Generation, and Bias Auditing via EquityLens) independent yet interconnected creates a flexible, user-friendly platform. Users can access any feature alone or let the AI guide them through a seamless flow (e.g., explanation → detect need for letter → generate bias-free version).

This modular approach strengthens the hackathon MVP: It's easier to build/test separately, but the connections make it feel intelligent and impactful.

Key Real-World Context (for Authentic Demo):

• Nepal's citizenship laws (Constitution Article 11, Citizenship Act 2006 with amendments) still have subtle gender biases: Easier via father's lineage; mothers often need extra declarations if father is "unidentified."
• Common bureaucratic need: Formal applications/letters to District Administration Offices (DAO) for citizenship certificates.
• Templates: Often include placeholders for "father's name," which can be biased—our tool can flag and rewrite to "parent's name" or neutral alternatives.

Three Independent Modes + Smart Connections

1. Mode 1: Bias Auditing Only

   • User uploads an existing document (PDF/Word/Docx, e.g., a drafted letter or policy).
   • AI scans for biases (gender, socioeconomic, etc.—tuned for Nepal contexts like paternal assumptions).
   • Outputs: Highlighted report, bias score, explanations, and suggested rewrites.
   • Interactive Twist: "Bias detected! Do you want a bias-free updated version?" → If yes → Generate revised document (using generation module).

2. Mode 2: Letter Generation Only

   • User selects a template (e.g., "Citizenship Application," "Complaint to DAO") or describes need.
   • Inputs personal details (name, situation).
   • AI fills template → Automatically runs bias audit → Outputs a guaranteed bias-free letter (with fixes applied).
   • Download as Docx/PDF.

3. Mode 3: Law Explanation Only (RAG Standalone)

   • User describes situation in natural language (e.g., "I need citizenship for my child but no father" in English (for now)).
   • AI retrieves relevant laws (from our vector DB of Constitution, Citizenship Act, Muluki Civil Code snippets).
   • Explains in simple, plain language.
   • No proactive linking here unless needed.

Smart Connections (Conversational Flow):

• The app uses a chat-like interface to detect intent and offer cross-feature help.
• Example Full Flow (Citizenship Scenario):
  1. User: "I need citizenship but no father" → Mode 3: Explains law (e.g., "Per Nepal Constitution Article 11 and recent amendments, a child can get citizenship via mother's lineage with declarations if father unidentified. You may need to submit an application to DAO with birth certificate and affidavit.").
  2. AI proactively: "This often requires a formal application letter to the District Administration Office. Would you like me to generate one for you?"
  3. If yes → Switch to Mode 2: Ask for details (child's name, mother's details, district) → Generate letter using template.
  4. Auto-run Mode 1: Audit for biases (e.g., flag any "father required" fields) → Apply fixes → "Here's your bias-free letter, rewritten to use neutral language."

This makes it feel like a helpful AI assistant, not just separate tools!