Justice Matrix Research Agent

When to Use

• Discovering new global youth justice cases
• Finding advocacy campaigns worldwide
• Updating the Justice Matrix database
• Checking source health and coverage gaps
• Running scheduled research cycles

Commands

Workflow

DISCOVER → EXTRACT → QUEUE → REVIEW → APPROVE
   ↓          ↓         ↓        ↓         ↓
Sources    AI Parse  Pending   Admin    Database

1. Source Scan (/ralph-matrix-scan)

// Query active sources by priority
const sources = await supabase
  .from('justice_matrix_sources')
  .select('*')
  .eq('is_active', true)
  .order('scrape_priority', { ascending: true });

// For each source:
// 1. Fetch pages
// 2. Extract case/campaign links
// 3. Check for duplicates
// 4. Queue new discoveries

2. AI Extraction (/ralph-matrix-extract)

For each pending discovery:

1. Fetch full content from source URL
2. Run AI extraction using patterns from PRD
3. Geocode to lat/lng
4. Categorize by legal themes
5. Calculate confidence score
6. Check for duplicates

3. Review Queue

Discoveries go to /admin/justice-matrix/discoveries where admins can:

• Preview extracted data
• Edit before approval
• Approve → creates case/campaign
• Reject → marks as rejected with notes
• Merge → links to existing item

Source Types

Extraction Patterns

Court Database

{
  "required": ["case_citation", "jurisdiction", "year", "court"],
  "extract": ["strategic_issue", "key_holding", "outcome"],
  "infer": ["categories", "precedent_strength", "lat/lng"]
}

Advocacy Organization

{
  "required": ["campaign_name", "country_region", "lead_organizations"],
  "extract": ["goals", "tactics", "outcome_status"],
  "infer": ["is_ongoing", "categories", "lat/lng"]
}

Quality Scoring

Database Tables

PRD Reference

Full source configuration: ralph/justice-matrix-prd.json

Sacred Boundaries

Never scrape:

• Sealed juvenile records
• Private case files
• Paywalled content without permission
• Individual identifying information

Always mark:

• Indigenous rights cases
• First Nations advocacy
• Community-controlled campaigns

Always check:

• Publication permissions
• Child privacy protections
• Cultural sensitivity

Example Usage

# Quick status check
/ralph-matrix-status

# Run full discovery cycle
/ralph-matrix-scan

# Process discoveries
/ralph-matrix-extract

# Deep dive on specific source
/ralph-matrix-source "ECHR HUDOC"