Architectural Blueprint And Strategic Implementation For The Who Cares Wizard On 2Ia - Source Excerpt 03 - Recommended routing algorithm

Back to Architectural Blueprint And Strategic Implementation For The Who Cares Wizard On 2Ia

Summary

This source excerpt begins near Recommended routing algorithm and preserves the surrounding evidence from 2IA.org/agent-file-handoff/Archive/2026-05-17-who-cares-wizard/Architectural Blueprint and Strategic Implementation for the Who Cares Wizard on 2ia.org.md.

**Source path:** 2IA.org/agent-file-handoff/Archive/2026-05-17-who-cares-wizard/Architectural Blueprint and Strategic Implementation for the Who Cares Wizard on 2ia.org.md

| Grievance group | Layer one question | Layer two question | Layer three question | Layer four question | Branching logic and route |
|---|---|---|---|---|---|
| Immediate danger and abuse | “Is anyone in danger right now?” | If yes: “Which is closest: self-harm, partner/family violence, sexual assault, trafficking, child in danger, or medical emergency?” | “Can you safely call, text, or chat?” | “What country are you in, and do you need language or accessibility support?” | If “right now,” bypass ordinary flow. Show crisis options first; ask only location, safe channel, language, and accessibility. |
| Housing and utilities | “Is your main issue housing, homelessness, or utility bills?” | “Which fits best: no safe place tonight, eviction/foreclosure, landlord problem, discrimination/accessibility, or utility shutoff?” | “How soon is the deadline or loss of housing/service: tonight, within 3 days, within 30 days, later?” | “Do you want shelter, legal rights help, negotiation help, or payment assistance?” | Shelter tonight routes to emergency shelter/homeless assistance. Rights disputes route to housing counselor, fair-housing regulator, and legal aid. Utility cutoff routes to assistance programs first. |
| Health, disability, and caregiving | “Is this mainly about mental health, treatment access, disability accommodation, or caregiving?” | “Which fits best: emotional crisis, finding treatment, disability access, eldercare, long-term care, or caregiver burnout?” | “Is anyone at risk without help in the next 72 hours?” | “Would you rather talk to someone now, get a service locator, or understand your rights?” | Crisis goes to hotline first. Service navigation goes to treatment or eldercare locators. Rights disputes route to accommodation or civil-rights channels. |
| Work, money, debt, and benefits | “Is this mainly a work problem, a money/debt problem, or a benefits problem?” | If work: “Unsafe conditions, pay/wage issue, retaliation, discrimination, or union/collective issue?” If money: “Medical debt, scam, credit/reporting problem, tax issue, or general hardship?” | “When did this happen, and is there a hearing, complaint deadline, or shutoff date?” | “Do you want to file a report, get free legal help, dispute a debt, or find benefits?” | Unsafe work routes to labor safety. Discrimination routes to equal-opportunity channels. Debt and scams route to consumer regulators. Benefit eligibility routes to government finders and legal aid if denial is involved. |
| Children, youth, and family | “Is this about a child, youth, foster care, or family support?” | “Which fits best: suspected abuse/neglect, foster care or youth transition, parenting support, or another family problem?” | “Is a child in immediate danger right now?” | “Do you need to make a report, find support, or understand the system?” | Immediate danger interrupts to emergency/child protection. Non-emergency concerns route to state reporting numbers, child-abuse hotline, or child-welfare information and support. |
| Discrimination, immigration, and legal status | “Is this about discrimination, disability rights, immigration status, or legal representation?” | “Which best describes it: race/national origin/religion/sex/disability discrimination, immigration scam, asylum/refugee help, detention concern, or need a lawyer?” | “What country and state/province are involved?” | “Do you want to report the issue, find legal help, or understand your rights first?” | Rights violations route to the local or national civil-rights pathway. Immigration-specific questions trigger a legal-status prompt and lawyer/UNHCR route instead of general advice. |
| Community, environment, disaster, and public services | “Is this about a place, a public service, or a community problem?” | “Which fits best: pollution/environment, disaster recovery, unsafe infrastructure, or a complaint about a public agency or local service?” | “Is the risk immediate to health or safety?” | “Do you want to report a violation, find recovery help, or contact local government?” | Environmental hazards route to the regulator reporting path. Disaster needs route to assistance locators. Agency/service complaints route to government complaint finders and local officials. |

### Recommended routing algorithm

The routing algorithm should not be a black box. It should be understandable enough to explain to users *why a route was chosen*. I recommend a weighted model with **hard overrides**:

- **Safety override** if risk is immediate.
- **Deadline override** if a complaint, hearing, shutoff, eviction, or benefit-termination date is near.
- **Issue match** as the strongest ordinary factor.
- **Jurisdiction match** next.
- **Language and accessibility match** after that.
- **Preferred channel** and **user goal** after that.

A practical scoring model is:

- Issue match: 40
- Jurisdiction and coverage: 20
- Urgency and service hours: 15
- Demographic or cultural competence: 10
- Modality fit: 10
- Language/accessibility fit: 5

If the top two routes are close, the interface should show a **primary route** and a clearly labeled **also consider** secondary route.

When a locale is known, date capture becomes critical. In the United States, for example, OSHA notes that safety and health complaints relating to incidents older than six months will not result in violations, the EEOC says many employment-discrimination charges must be filed within 180 days or 300 days where state or local law overlaps, and HUD’s Fair Housing process says allegations under the Fair Housing Act should be filed within one year of the last discriminatory act. Those examples show why the wizard should ask for **incident date** very early once a rights-enforcement path becomes likely. citeturn5search0turn5search13turn21search11

## Resource mapping and escalation model

### Routing rules and criteria

The next table translates answers into target groups and concrete actions. This is the operational heart of the wizard.

| Category | Key answer pattern | Primary target group | Secondary target group | Routing rule |
|---|---|---|---|---|
| Immediate danger | “Yes, right now”; active self-harm; violent incident; child in danger; trafficking confinement; overdose or acute medical threat | Emergency services or immediate crisis line | Specialist survivor or child-protection line | Ask nothing except safe channel, location, language, and accessibility. Show emergency path first. |
| Safety, but not immediate | Fear of escalation, but no active incident | Survivor advocate or crisis counselor | Local shelter/safety planning service | Offer safety-planning content, quick exit, and hotline/chat/text route without requiring account creation. |
| Housing loss tonight or within days | No safe place tonight; eviction hearing soon; utilities ending now | Shelter or emergency housing path | Housing counselor and legal aid | Put shelter and emergency assistance first; rights information second. |
| Housing discrimination or inaccessible housing | Protected-class or disability-access issue in housing | Fair-housing regulator or disability-rights route | Legal aid and housing counselor | Ask incident date, protected ground, and location before filing guidance. |
| Workplace safety | Unsafe conditions, hazard, retaliation for safety complaint | Labor safety regulator | Legal aid or worker center | Collect employer/worksite essentials only; preserve anonymous-report option where supported. |
| Job discrimination or harassment | Protected-trait discrimination, harassment, retaliation | Employment discrimination agency | Legal aid | Ask employment type, date, and protected basis before filing guidance. |
| Consumer debt or scam | Medical debt, financial product dispute, fraud, identity issue | Consumer regulator | Legal aid or ombuds | Prioritize formal complaint channels and dispute steps before general education. |
| Benefits or tax hardship | Benefit denial, eligibility confusion, tax problem causing hardship | Official benefits/tax assistance | Legal aid | Ask program name, denial date, and deadline; route to agency plus advocate when available. |
| Child abuse or neglect | Suspicion of abuse, neglect, or immediate child safety issue | Child-protection reporting route | Child-abuse hotline and family support | Separate “make a report now” from “I need to understand what to do.” |
| Immigration or refugee help | Asylum, detention, status uncertainty, immigration scam | Qualified legal representation or UNHCR route | Civil-rights or consumer-fraud path | Do not provide granular legal strategy without jurisdiction; prioritize legal help and anti-scam warnings. |
| Environmental or public-service complaint | Pollution, illegal dumping, hazardous public condition, disaster need | Regulator or emergency-management route | Local government complaint path | Ask whether the user wants to report a violation, get recovery help, or contact public officials. |