docs/implementation_workflow.md

Nepal Justice Weaver – Implementation Workflow

1. Law Explanation (RAG-based)
2. Bias-Free Letter Generation
3. Bias Auditing (EquityLens)

The goal is to allow users to enter via any door while enabling smart, conversational connections between features.

Phase 1: Preparation & Data Collection (3-4 hours)

• Collect and prepare core data assets:
  • Download 8-12 key Nepali legal documents in English: Constitution of Nepal, Citizenship Act 2006 (with amendments), Muluki Civil Code sections on citizenship/inheritance/property, sample government notifications.
  • Gather or create 4-6 standard official letter templates in editable format (e.g., citizenship application, affidavit for unidentified father, land-related complaint, general application to DAO or ward office). Ensure placeholders are neutral where possible.
  • Prepare a small set of Nepal-specific bias examples (e.g., paternal language in citizenship forms, urban-centric assumptions) to guide the bias model. Or we have alternative (pre-trained model)

Phase 2: Build Individual Modules Separately (10-12 hours total)

Work in parallel.

Module A: Law Explanation (RAG Pipeline)

• Extract and chunk text from collected legal PDFs.
• Create embeddings and build a local vector database.
• Set up retrieval chain with a local or API-based LLM (we may prefer API-based) for generating simple, plain-language explanations.
• Add bilingual capability (Future extension).

Module B: Bias-Free Letter Generation

• Load letter templates.
• Build a form-based or natural-language input system to collect user details.
• Create a filling mechanism that inserts user data into the selected template.
• Automatically route every generated letter through the bias auditor (Module C) before final output.

Module C: Bias Auditing (EquityLens)

• Load or fine-tune a lightweight bias detection model (using general fairness datasets + Nepal-specific examples).
• Develop sentence/document-level scanning for common bias types (gender, socioeconomic, paternal/maternal assumptions, urban-rural disparity).
• Generate highlighted reports, bias scores, explanations, and suggested neutral rewrites.
• Add an interactive option: “Apply fixes automatically to create a bias-reduced version?”

Phase 3: Create User Entry Points & Modes (4-5 hours)

Design three clear, independent access modes in the UI:

1. Explain Law Mode

   • Text input or chat box for describing a situation.
   • Outputs simple explanation of relevant laws.

2. Generate Letter Mode

   • Dropdown or keyword detection to select template type.
   • Guided questions or free-text input for personal details.
   • Always produces a bias-audited, bias-reduced letter.

3. Audit Document Mode

   • File upload (PDF/Word/Text) of existing letter or policy draft.
   • Displays bias report with highlights and suggestions.
   • Offers: “Generate a bias-free updated version?” → If accepted, rewrites using generation module.

Phase 4: Add Smart Interconnections (Conversational Flow) (4-6 hours)

• Implement a central chat-style interface that can handle natural user queries.
• Add intent detection logic to route queries to the correct starting module.
• Build proactive suggestions:
  • After a law explanation, check if the retrieved law typically requires a formal letter → Offer: “Would you like me to generate the required application letter?”
  • After bias auditing an uploaded document, offer automatic rewriting.
  • After letter generation, always show a summary of bias checks performed and fixes applied.
• Use session state to remember context (e.g., user details from explanation phase can pre-fill letter generation).

Phase 5: UI/UX & Demo Polish (4-5 hours)

• Create a clean main interface with:
  • Tabs or buttons for quick access to the three modes.
  • A prominent central chat box for natural, guided conversations.
• Add language toggle (English/Nepali - aaile lai dekhauna matra).
• Include clear disclaimers: “This tool provides information and templates for educational purposes; it is not legal advice.”
• Prepare 3 strong demo scenarios:
  1. Single mother seeking child citizenship (explanation → proactive letter offer → bias-free generation).
  2. User uploads biased existing letter → audit → accepts rewrite.
  3. Direct request for a neutral complaint letter.

Phase 6: Testing & Final Touches (2-3 hours)

• Test all independent modes thoroughly.
• Test full connected flows end-to-end.
• Ensure smooth handoffs between modules.
• Record a clear 2-3 minute demo video highlighting modularity and intelligent connections.