Add /backdate-program and /review-program commands

.claude-plugin/marketplace.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://claude.ai/schemas/plugin-marketplace.json",
   "name": "policyengine-claude",
-  "version": "3.10.0",
+  "version": "3.11.0",
   "description": "Complete PolicyEngine knowledge base - for users, analysts, and contributors across the entire PolicyEngine ecosystem",
   "owner": {
     "name": "PolicyEngine",
@@ -13,7 +13,7 @@
       "description": "Essential PolicyEngine knowledge for all users - understanding the platform, using the web app, and basic concepts",
       "source": "./",
       "category": "getting-started",
-      "version": "3.10.0",
+      "version": "3.11.0",
       "keywords": ["beginner", "users", "guide", "basics"],
       "author": {
         "name": "PolicyEngine",
@@ -33,7 +33,7 @@
       "description": "Complete multi-agent workflow for implementing government benefit programs in PolicyEngine country packages",
       "source": "./",
       "category": "development",
-      "version": "3.10.0",
+      "version": "3.11.0",
       "keywords": ["tax", "benefits", "microsimulation", "country-models", "rules", "testing"],
       "author": {
         "name": "PolicyEngine",
@@ -62,8 +62,10 @@
       ],
       "commands": [
         "./commands/audit-state-tax.md",
+        "./commands/backdate-program.md",
         "./commands/encode-policy.md",
         "./commands/review-pr.md",
+        "./commands/review-program.md",
         "./commands/fix-pr.md",
         "./commands/create-pr.md"
       ],
@@ -91,7 +93,7 @@
       "description": "API development - Flask endpoints, caching, services, and integration patterns",
       "source": "./",
       "category": "development",
-      "version": "3.10.0",
+      "version": "3.11.0",
       "keywords": ["api", "flask", "backend", "rest", "endpoints"],
       "author": {
         "name": "PolicyEngine",
@@ -122,7 +124,7 @@
       "description": "React app development - app-v2, standalone tools, Vercel deployment, and PolicyEngine-specific patterns",
       "source": "./",
       "category": "development",
-      "version": "3.10.0",
+      "version": "3.11.0",
       "keywords": ["react", "frontend", "app", "ui", "components", "vercel", "interactive-tools"],
       "author": {
         "name": "PolicyEngine",
@@ -161,7 +163,7 @@
       "description": "Policy analysis and research - impact studies, dashboards, notebooks, and visualizations",
       "source": "./",
       "category": "analysis",
-      "version": "3.10.0",
+      "version": "3.11.0",
       "keywords": ["analysis", "research", "policy", "impact", "streamlit", "plotly", "notebooks"],
       "author": {
         "name": "PolicyEngine",
@@ -188,7 +190,7 @@
       "description": "Data analysis, survey enhancement, imputation, calibration, and microdata utilities",
       "source": "./",
       "category": "data",
-      "version": "3.10.0",
+      "version": "3.11.0",
       "keywords": ["data", "microdata", "survey", "imputation", "calibration", "inequality", "poverty", "ml"],
       "author": {
         "name": "PolicyEngine",
@@ -238,7 +240,7 @@
       "description": "Complete PolicyEngine knowledge base - all agents, commands, and skills for users, analysts, and contributors",
       "source": "./",
       "category": "complete",
-      "version": "3.10.0",
+      "version": "3.11.0",
       "keywords": ["complete", "all", "comprehensive"],
       "author": {
         "name": "PolicyEngine",
@@ -282,10 +284,12 @@
       "commands": [
         "./commands/audit-seo.md",
         "./commands/audit-state-tax.md",
+        "./commands/backdate-program.md",
         "./commands/create-pr.md",
         "./commands/encode-policy.md",
         "./commands/generate-content.md",
         "./commands/review-pr.md",
+        "./commands/review-program.md",
         "./commands/fix-pr.md",
         "./commands/new-tool.md"
       ],

CHANGELOG.md

@@ -5,6 +5,30 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.11.0] - 2026-02-26
+
+### Added
+
+- `/review-program` command — consolidated PR review combining code validation + PDF audit in one pass; works for any PR type (state programs, federal parameters, infrastructure, API, frontend)
+- `/backdate-program` command — multi-agent orchestration for backdating state program parameters with research, reference/formula audit, implementation, and built-in review phases
+- `--600dpi` flag for both commands to handle scanned docs and dense tables
+- `--local-diff` flag for `/review-program` to review unpushed local work (reads `git diff` instead of `gh pr diff`)
+- `--skip-pdf` flag for `/review-program` to skip PDF acquisition on infrastructure/refactoring PRs
+- Two-stage mismatch verification in `/review-program` Phase 5: code-path tracing (Step 5C) filters false positives before 600 DPI visual verification (Step 5D)
+- Self-learning lessons mechanism in `/backdate-program` Phase 8: session checklist → persistent local lessons → PR to plugin repo (`lessons/agent-lessons.md`)
+- `in_effect` and `regional_in_effect` boolean toggle patterns added to parameter-patterns and variable-patterns skills (with CT TFA production code examples)
+- Implementation agents (parameter-architect, rules-engineer) now load lessons files on startup to prevent known mistakes
+- Write tool added to `reference-validator` and `program-reviewer` agents
+- Edit tool added to `edge-case-generator` agent
+- `/tmp` cleanup at start of both commands to prevent stale data from previous runs
+
+### Changed
+
+- `/backdate-program` Phase 6 now invokes `/review-program --local --full` instead of separate `/review-pr` + `/audit-state-tax`
+- `/backdate-program` Phase 5 now pushes to remote before Phase 6 review-fix loop
+- `/backdate-program` Phase 8C uses temporary clone instead of modifying plugin install directory
+- `/review-program` scope-aware agent selection: skips regulatory/reference validators for non-program PRs
+
 ## [3.9.1] - 2026-02-18
 
 ### Added
@@ -59,6 +83,8 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 
 
+[3.11.0]: https://github.com/PolicyEngine/policyengine-claude/compare/3.10.0...3.11.0
+[3.9.1]: https://github.com/PolicyEngine/policyengine-claude/compare/3.7.0...3.9.1
 [3.7.0]: https://github.com/PolicyEngine/policyengine-claude/compare/3.6.1...3.7.0
 [3.6.1]: https://github.com/PolicyEngine/policyengine-claude/compare/3.5.0...3.6.1
 [3.5.0]: https://github.com/PolicyEngine/policyengine-claude/compare/3.4.1...3.5.0

agents/country-models/edge-case-generator.md

@@ -1,7 +1,7 @@
 ---
 name: edge-case-generator
 description: Automatically generates comprehensive edge case tests for benefit programs
-tools: Read, Write, Grep, Glob, TodoWrite, Skill
+tools: Read, Write, Edit, Grep, Glob, TodoWrite, Skill
 model: opus
 ---
 

agents/country-models/program-reviewer.md

@@ -1,7 +1,7 @@
 ---
 name: program-reviewer
 description: Reviews government program implementations by researching regulations first, then validating code against legal requirements
-tools: Bash, Read, Grep, Glob, WebFetch, TodoWrite, Skill
+tools: Bash, Read, Write, Grep, Glob, WebFetch, TodoWrite, Skill
 model: opus
 ---
 

agents/reference-validator.md

@@ -1,7 +1,7 @@
 ---
 name: reference-validator
 description: Validates that all parameters have proper references that corroborate the values
-tools: Read, Grep, Glob, WebFetch, TodoWrite, Skill
+tools: Read, Write, Grep, Glob, WebFetch, TodoWrite, Skill
 model: opus
 ---