encode-reform

Implementing Reform: $ARGUMENTS

Coordinate a multi-agent workflow to implement a contributed policy reform (proposed bill, policy experiment, or tax change) as a complete, production-ready reform in PolicyEngine US.

GLOBAL RULE — PDF Page Numbers: Every PDF reference href MUST end with #page=XX (the file page number, NOT the printed page number). The ONLY exception is single-page PDFs. This rule applies to ALL agents in ALL phases.

GLOBAL RULE — Reform Skill: Every implementation agent (rules-engineer, test-creator, validator) MUST load /policyengine-reform-patterns in addition to their standard skills. This teaches the factory function pattern, gov/contrib/ paths, in_effect toggle, reforms: test key, and registration in reforms.py.

Arguments

$ARGUMENTS should contain:

• State and bill (required) — e.g., MT HB 268, CT SB-100, SC H.4216
• Or federal reform — e.g., CRFB AGI Surtax, Streamlined EITC
• Options:
  • --skip-review — skip Phase 4 review-fix loop
  • --research-only — stop after Phase 1, produce impl-spec but don't implement

Examples:

/encode-reform MT HB 268
/encode-reform CT SB-100
/encode-reform SC H.4216 --skip-review
/encode-reform CRFB AGI Surtax
/encode-reform KY HB 13 HB 152

---

Constants

ST          = state code from $ARGUMENTS (e.g., "mt", "ct", "ky") or org name for federal (e.g., "crfb")
BILL_ID     = bill identifier (e.g., "hb268", "sb100", "h4216", "agi_surtax")
PREFIX      = /tmp/{ST}-{BILL_ID}

---

Context Window Protection

YOU (the orchestrator) ONLY read SHORT summary files (marked "Short" in the table below). All detailed data flows through disk files between agents. Never read full spec files — delegate that to agents.

Disk File Handoff Table

File	Writer	Reader	Size
{PREFIX}-type-summary.md	bill-analyzer	Orchestrator	Short ≤15
{PREFIX}-bill-analysis.md	bill-analyzer	consolidator	Full
{PREFIX}-bill.pdf	bill-analyzer	prep-bill-pdf	Binary
sources/working_references.md	bill-researcher	consolidator	Full
{PREFIX}-impl-spec.md	consolidator	rules-engineer, test-creator	Full
{PREFIX}-impl-summary.md	consolidator	Orchestrator	Short ≤20
{PREFIX}-checkpoint.md	validator	Orchestrator	Short ≤15
{PREFIX}-test-results.md	ci-fixer	Orchestrator	Short ≤10
{PREFIX}-audit-checkpoint.md	quick-auditor	Orchestrator	Short ≤15
{PREFIX}-checklist.md	review-fixer	next round fixer	Full
{PREFIX}-final-report.md	reporter	Orchestrator	Short ≤25
{PREFIX}-pr-description.md	reporter	gh pr edit	Full