Plan: Policy-to-Rules Traceability Pipeline

On this page

Status

Step Description Status

1

Write ADR-011 (policy-to-rules traceability pipeline)

Done (2026-04-09)

2

Create canopy-policy crate (citation schema types, workflow template types, validation functions)

Done (2026-04-09) — 4 unit tests

3

Create rulesets/georgia/citations.toml with PAMMS-verified citations for all corrected values

Done (2026-04-09) — 51 citations. 84 keys remaining (surfaced by policy audit).

4

Fix jurisdiction.toml values against PAMMS source of truth

Done (2026-04-09) — 15+ SNAP fixes, TANF income methodology fix, Medicaid Pathways/PeachCare fixes

5

Implement cargo xtask policy audit (CI-integrated completeness/consistency/staleness check)

Done (2026-04-09)

6

Implement cargo xtask policy sync-cache (clone/pull PAMMS source repos)

Done (2026-04-09)

7

Create AsciiDoc plan file + update nav

Done (2026-04-09)

8

Fill remaining 84 citation gaps (incremental)

Done (2026-04-09) — 150/150 keys cited, zero gaps remaining

9

Workflow guidance templates for SNAP operations

Done (2026-04-09) — 9 templates in rulesets/georgia/workflows/ (SNAP intake/renewal/expedited/ABAWD/change + TANF intake/work-plan/sanction + cross-program referral)

ADR: ADR-011
Branch: feature/policy-to-rules-pipeline

Context

A comparison of Georgia’s jurisdiction.toml against PAMMS (Policy and Manual Management System — the Georgia DHS authoritative policy manual) revealed 15+ wrong/missing SNAP values, a fundamentally wrong TANF income methodology, and incorrect Medicaid thresholds.

PAMMS is backed by AsciiDoc source repos on GitLab (gadhs/pamms-sources/dfcs-{snap,tanf,medicaid}). We have full API access to read the source files directly.

ADR-011 establishes a four-layer architecture:

  1. Citation manifests — citations.toml traces every jurisdiction.toml value to its authoritative source

  2. Policy source adapters — PolicySource trait abstracts jurisdiction-specific policy systems

  3. Drift detection tooling — cargo xtask policy audit (CI) and drift (developer)

  4. Workflow guidance templates — optional, informational caseworker step guidance

Key Corrections Applied

SNAP (PAMMS dfcs-snap, MT-84, eff. Oct/Nov 2025)

  • H/C SUA: $432 → $405 (PAMMS 3617)

  • Telephone SUA: $53 → $47 (PAMMS 3617)

  • Added LSUA: $358 (was missing)

  • Dependent care caps removed (Georgia has no caps per PAMMS 3615)

  • Minimum benefit: $23 → $24 (PAMMS Appendix A)

  • Added excess shelter cap: $744 (PAMMS 3617)

  • Added homeless shelter deduction: $199 (PAMMS 3618)

  • Added Standard Medical Deduction: $161 (PAMMS 3614)

  • Added BBCE elderly/disabled 200% FPL screening (PAMMS 3210)

  • Added ABAWD age range 18-65, cert period 4 months, Senior SNAP 36 months

TANF (PAMMS dfcs-tanf, MT 82, eff. March 2026)

  • Income test: FPL-based → Standard of Need (PAMMS 1501) — fundamental methodology fix

  • Added GIC/SON/Family Maximum tables by AU size 1-11 (PAMMS Appendix A)

  • Earned income disregard: 20% → $250 flat (PAMMS 1615)

  • Removed nonexistent elderly asset limit

  • Added minimum benefit threshold ($10), GRG 160% FPL, detailed sanctions schedule

Medicaid (PAMMS dfcs-medicaid)

  • PeachCare: 252% → 247% FPL (PAMMS 2194)

  • Pathways: disabled → enabled (100% FPL, 80 hrs/month) (PAMMS 2195)

  • Added PeachCare premium schedule (6 tiers)

  • Added parent/caretaker 35% FPL

Deliverables

  • docs/modules/ROOT/pages/adrs/adr-011-policy-to-rules-pipeline.adoc — ADR

  • crates/canopy-policy/ — Citation + workflow schema crate (4 unit tests)

  • rulesets/georgia/citations.toml — 51 PAMMS-traced citations

  • rulesets/georgia/jurisdiction.toml — All corrected values

  • xtask/src/cmd/policy.rs — audit and sync-cache subcommands

Edit this page · default