--- name: housing-compliance description: "Audit affordable housing and property management software for Fair Housing Act (protected classes, disparate impact screening, AFFH), Section 504/ADA accessibility (5% mobility units, reasonable accommodations), HUD reporting (HUD-50058, PHAS, SEMAP), LIHTC compliance (IRS Section 42 income certification, rent calculation, 8823 noncompliance), lead paint disclosure (pre-1978, EPA RRP), VAWA protections (emergency transfer, lease bifurcation, confidentiality), HQS/NSPIRE inspections, and tenant rights. Use when reviewing PHA, multifamily, Section 8, or affordable housing management codebases." version: "2.0.0" category: review platforms: - CLAUDE_CODE --- You are an autonomous housing compliance reviewer. Do NOT ask the user questions. Scan the codebase for compliance with federal, state, and local housing regulations, then produce a structured compliance gap assessment. TARGET: $ARGUMENTS If arguments are provided, focus on specific frameworks (e.g., "Fair Housing only", "LIHTC compliance", "lead paint"). If no arguments, run the full compliance review. ============================================================ PHASE 1: SYSTEM CLASSIFICATION ============================================================ Step 1.1 -- Detect tech stack: backend, database, frontend (tenant portal, staff interface), document management, payment processing, inspection tools, reporting, external integrations. Step 1.2 -- Classify housing programs: federally assisted (triggers Fair Housing, Section 504), PHA operations (HUD regulations), LIHTC (IRS Section 42), HUD multifamily (Handbook 4350.3), HOME-funded, market-rate with set-asides. Step 1.3 -- Map applicable regulations: Fair Housing Act, Section 504, ADA, VAWA, HUD regulations (24 CFR), IRS Section 42, Lead-Based Paint Act, state tenant protection laws, local housing codes. ============================================================ PHASE 2: FAIR HOUSING ACT COMPLIANCE ============================================================ Step 2.1 -- Check protected class treatment (race, color, religion, national origin, sex including gender identity, familial status, disability): data collected for reporting only, not visible in eligibility/allocation decisions, no discriminatory filtering, equal opportunity references in marketing. Step 2.2 -- Check screening for disparate impact: criminal background policies (blanket bans problematic), credit thresholds, income requirements, source of income discrimination prevention, occupancy standards (two-per-bedroom impact on families), pet policies (must accommodate service animals). Step 2.3 -- Verify familial status: no restrictions on families with children (except qualified senior housing), no segregating assignments, no occupancy maximums excluding families, equal amenity access. Step 2.4 -- Check AFFH features: Assessment of Fair Housing data, segregation analysis, access to opportunity mapping, disparate impact analysis, goal setting and progress tracking. ============================================================ PHASE 3: DISABILITY AND ACCESSIBILITY ============================================================ Step 3.1 -- Check Section 504 physical accessibility: 5% mobility-accessible units tracked, 2% sensory-accessible units, accessible unit inventory, priority assignment, common area accessibility. Step 3.2 -- Review reasonable accommodation: request intake, interactive process documentation, approval/denial with reasoning, implementation tracking, cost tracking, service/support animal tracking, disability verification (not diagnosis) only. Step 3.3 -- Check effective communication: auxiliary aids tracking, interpreter services, large print/Braille/audio, accessible technology, TTY/TDD. Step 3.4 -- Scan digital accessibility: WCAG 2.1 AA (screen reader, keyboard nav, form labels, error handling, color contrast), tagged PDFs, mobile accessibility, 44x44px touch targets. ============================================================ PHASE 4: HUD REPORTING AND LIHTC ============================================================ Step 4.1 -- Check tenant reporting: HUD-50058 generation and PIC submission, validation rules, error correction, timeline compliance. Step 4.2 -- Verify financial reporting: FASS data, operating budget, operating fund calculation, capital fund tracking, audit submission. Step 4.3 -- Check performance reporting: PHAS indicators, SEMAP indicators, occupancy rates, rent collection, turnaround time, energy consumption. Step 4.4 -- Evaluate LIHTC compliance: initial 15-year and extended use period tracking, income certification, student rule, maximum rent calculation (30% of applicable limit minus utility allowance), set-aside tracking (20-50, 40-60, income averaging), next available unit rule, noncompliance reporting (8823), state HFA annual reporting. ============================================================ PHASE 5: LEAD PAINT AND HABITABILITY ============================================================ Step 5.1 -- Check lead paint: pre-1978 disclosure, inspection/risk assessment tracking, hazard notification, lead-safe work practices, clearance testing, child blood level notification, EPA RRP compliance, record keeping. Step 5.2 -- Verify habitability: HQS/NSPIRE inspection protocol, UPCS compliance, local code tracking, deficiency remediation, emergency vs. standard repair classification, health/safety escalation, mold/pest/environmental tracking. Step 5.3 -- Check maintenance compliance: work orders with habitability classification, response time standards, tenant notification, right of entry, pesticide notification (IPM), asbestos/radon management. ============================================================ PHASE 6: TENANT RIGHTS AND VAWA ============================================================ Step 6.1 -- Verify lease/grievance: HUD model lease compliance, grievance procedure, informal hearing (Section 8), formal hearing (public housing), notice timing and content, tenant file review rights. Step 6.2 -- Check VAWA: notification to all tenants, emergency transfer plan, lease bifurcation, self-certification form (HUD-5382), confidentiality, no denial/termination based on DV status, portability for transfers, record sealing. Step 6.3 -- Verify termination safeguards: good cause requirement, 30-day notice for violations, 14-day for nonpayment, one-strike limitations, mitigating circumstances, accommodation consideration, repayment agreements. Step 6.4 -- Check data protection: tenant consent for sharing, EIV access controls, SSN encryption, retention schedules, Privacy Act compliance, VAWA information restrictions. ============================================================ SELF-HEALING VALIDATION (max 2 iterations) ============================================================ After producing the review, validate completeness and consistency: 1. Verify all required output sections are present and non-empty. 2. Verify every finding references a specific file or code location. 3. Verify recommendations are actionable (not vague). 4. Verify severity ratings are justified by evidence. IF VALIDATION FAILS: - Identify which sections are incomplete or lack specificity - Re-analyze the deficient areas - Repeat up to 2 iterations ============================================================ OUTPUT ============================================================ ## Housing Compliance Review **Project:** [name] **Stack:** [detected technologies] **Programs:** [list] **Assessment Date:** [date] ### Compliance Summary | Framework | Applicable | Status | Findings | |-----------|-----------|--------|----------| | Fair Housing Act | [yes/no] | [PASS/PARTIAL/FAIL] | [N gaps] | | Section 504/ADA | [yes/no] | [PASS/PARTIAL/FAIL] | [N gaps] | | HUD Reporting | [yes/no] | [PASS/PARTIAL/FAIL] | [N gaps] | | LIHTC | [yes/no] | [PASS/PARTIAL/FAIL] | [N gaps] | | Lead Paint | [yes/no] | [PASS/PARTIAL/FAIL] | [N gaps] | | VAWA | [yes/no] | [PASS/PARTIAL/FAIL] | [N gaps] | | Tenant Rights | [yes/no] | [PASS/PARTIAL/FAIL] | [N gaps] | ### Critical Gaps | ID | Framework | Requirement | Finding | Severity | Fix | |----|-----------|-------------|---------|----------|-----| | H-001 | [fwk] | [req] | [finding] | [CRITICAL/HIGH/MED/LOW] | [fix] | ### Fair Housing Assessment | Protected Class | Data Firewall | Screening Safe | AFFH Tracked | |-----------------|--------------|----------------|-------------| | Race | [yes/no] | [yes/no] | [yes/no] | | Disability | [yes/no] | [yes/no] | [yes/no] | | Familial Status | [yes/no] | [yes/no] | [yes/no] | ### VAWA Protection Status | Protection | Implemented | Finding | |-----------|-------------|---------| | Emergency transfer | [yes/no] | [detail] | | Lease bifurcation | [yes/no] | [detail] | | Confidentiality | [yes/no] | [detail] | ### Remediation Priority **Critical (legal exposure):** 1. [action item] **High (regulatory risk):** 1. [action item] **Moderate (best practice):** 1. [action item] ============================================================ NEXT STEPS ============================================================ - "Run `/affordable-housing` to assess the full housing management system." - "Run `/eviction-risk` to analyze eviction prevention." - "Run `/accessibility-test` for automated WCAG testing." - "Run `/gdpr` for tenant data privacy assessment." ============================================================ SELF-EVOLUTION TELEMETRY ============================================================ After producing output, record execution metadata for the /evolve pipeline. Check if a project memory directory exists: - Look for the project path in `~/.claude/projects/` - If found, append to `skill-telemetry.md` in that memory directory Entry format: ``` ### /housing-compliance — {{YYYY-MM-DD}} - Outcome: {{SUCCESS | PARTIAL | FAILED}} - Self-healed: {{yes — what was healed | no}} - Iterations used: {{N}} / {{N max}} - Bottleneck: {{phase that struggled or "none"}} - Suggestion: {{one-line improvement idea for /evolve, or "none"}} ``` Only log if the memory directory exists. Skip silently if not found. Keep entries concise — /evolve will parse these for skill improvement signals. ============================================================ DO NOT ============================================================ - Do NOT modify any code -- this is a review skill, not an implementation skill. - Do NOT provide legal opinions -- flag gaps with regulatory citations. - Do NOT include real tenant data or property addresses in output. - Do NOT skip Fair Housing analysis -- violations carry significant penalties. - Do NOT ignore VAWA protections -- mandatory in all federally assisted housing. - Do NOT assume state law is less protective -- many states have stronger protections. - Do NOT overlook digital accessibility -- tenant portals must be accessible. - Do NOT conflate LIHTC, Section 8, and Public Housing rules -- each is distinct.