EDORA Learn β Pipelines
Risk Reassessment & Level Changes (Dynamic Supervision)
Pipeline 06
Transparency note: reassessment cohorts can be small in short intervals, and tool updates or threshold changes create series breaks; we pool where needed and version-tag all results.
Overview
Supervision and services adjust over time as youth circumstances change. Jurisdictions schedule periodicreassessmentsβor trigger them after key events (violations, program completion, step-down requests). Scores inform movement to higher or lower supervision levels, service intensity, or placement type. This page outlines the observable elements of reassessment and how decisions are implemented and recorded.
What We Track
Cadence & Triggers
- Routine intervals configured (e.g., 60β90 days) with due-date tracking
- Event-based triggers captured
- Violation or serious incident
- Milestone completion (program/education)
- Transfer (placement β community, officer change)
Tool Versioning
- Instrument name & version logged (effective dates)
- Scoring thresholds / cut points recorded
- Changes to items or weights noted (series-break marker)
Decision Rules
- Mapped criteria for step-up/step-down
- Minimum time-in-level required before change (document exceptions)
- Required conditions verified
- School attendance / credits on track
- Program engagement / dosage delivered
- No recent violations within lookback window
Overrides & Documentation
- Professional-judgment departures logged with rationale
- Approval pathway captured (approver, timestamp)
- Conditions attached to new level (contact cadence, ATD changes)
Equity & Stability
- Time-to-step-down and override rates by subgroup (race/ethnicity, geography, gender)
- Short-window score stability checks to detect measurement noise
Typical Flow
- Identify trigger (scheduled interval or event) and queue reassessment
- Set due date; pause/resume if hearing or placement change intervenes
- Re-score with current tool version
- Record date, assessor, missing items, and any ancillary info (school, BH)
- Apply rules for step-up/step-down based on score and plan progress
- Verify minimum time-in-level; check required conditions met
- Document decision including any override and conditions for new level
- Capture approver, start date for new cadence, ATD/service adjustments
- Monitor effects on contacts, services, and incidents; schedule next reassessment
- Track early signal changes (attendance, alerts) post-level change
Fields
Field | Type | Required | Codeset | Description |
---|---|---|---|---|
pipeline_place_id | uuid | β | β | Unique identifier for this reassessment record. |
pipeline_stage_id | enum | β | stages.yml#stage_key(8)
| One of the 8 canonical stages. |
pipeline_place_key | enum | β | pipeline_places.yml#place_key(45)
| Canonical key for this place (maps to route/slug). |
youth_id | string | β | β | Salted/hashed or state UID. No plaintext PII. |
staff_id | string | β | Staff conducting or validating reassessment. | |
occurred_datetime | datetime | β | β | Timestamp when reassessment was administered/scored. |
jurisdiction_code | string | β | β | County/parish/circuit or standardized local code. |
legal_case_id | string | β | Case/docket identifier if applicable. | |
source_system | string | β | β | Origin system name. |
source_file | string | β | Source batch/file id if flatfile. | |
extract_run_id | string | β | ETL run id for lineage. | |
series_break_flag | boolean | β | Series break (tool revision, weight changes). | |
series_break_reason | enum | series_breaks.yml#reason(4)
| Reason for series break (tool_revision, policy_change, etc.). | |
reassessment_trigger_code | enum | β | reassessment_triggers.yml#trigger(6)
| scheduled_interval, violation_event, program_completion, placement_change, officer_change, other_event. |
reassessment_due_date | date | β | Due date for reassessment completion. | |
trigger_event_id | string | β | Identifier of triggering event, if applicable. | |
instrument_key | enum | β | instruments.yml#instrument_keyβ οΈ using instruments.yml#risk_tool_name(2)
| Canonical risk/needs instrument (e.g., YLS, SAVRY, etc.). |
instrument_version | string | β | β | Version string/number for tool versioning. |
item_count_total | integer | β | Total number of scored items for this version. | |
item_count_missing | integer | β | Count of items skipped or missing. | |
score_raw_total | number | β | Raw summed score. | |
score_category_code | enum | score_categories.yml#category(6)
| Standardized category (low, moderate, high). | |
cutpoint_set_key | enum | cutpoint_sets.yml#set_key(2)
| Threshold set used for categorization. | |
prior_supervision_level_code | enum | supervision_levels.yml#level(4)
| Level before reassessment. | |
recommended_supervision_level_code | enum | β | supervision_levels.yml#level(4)
| Level suggested by the tool. |
override_flag | boolean | β | Override of recommended level applied. | |
override_reason_code | enum | overrides.yml#reason(4)
| Reason for override (clinical_judgment, safety_exception, staffing_capacity, other). | |
override_approver_staff_id | string | β | Staff ID of approver for override. | |
final_supervision_level_code | enum | β | supervision_levels.yml#level(4)
| Level ultimately assigned after approval. |
effective_start_datetime | datetime | β | Start of new supervision level period. | |
effective_end_datetime | datetime | β | End date/time of this supervision level (if superseded). | |
conditions_verified_flag | boolean | β | All required step-up/step-down conditions verified true. | |
required_conditions_met_codes | array<string> | reassessment_conditions.yml#condition(7)
| List of verified conditions (school_attendance, program_engagement, no_recent_violations, etc.); semicolon-delimited. | |
exception_documented_flag | boolean | β | Exception documented where minimum time-in-level not met. | |
approver_staff_id | string | β | Staff approving reassessment outcome. | |
approval_datetime | datetime | β | When reassessment/level change approved. | |
decision_notes_id | string | β | Link or ID of stored rationale/progress note. | |
subgroup_code | enum | subgroup_categories.yml#group(5)
| Race/ethnicity/gender/rurality subgroup code for equity tracking. | |
short_window_stability_flag | boolean | β | Indicates unstable score change within short window. | |
Download CSVwhat_we_track.csv |
Data & Methods
Reassessment indicators use supervision- or placement-based denominators with episode timelines. Time-to-step-down is measured from eligibility to decision; stability is summarized via consecutive score differences. All results are tagged with tool version and threshold set. When instruments or cut points change, we mark series breaks. Small-n suppression follows Suppression & Small-n. For context on instruments and planning, see Risk Assessment Tools and Case Planning & Service Matching. Cross-site comparisons rely on harmonized level definitions per Cross-Jurisdiction Comparability.