Skip to content

Update the PIP point system docs page (#1069) - #1725

Merged
vahid-ahmadi merged 8 commits into
mainfrom
vahid-ahmadi/issue-1069-pip-points-plan
Oct 24, 2026
Merged

vahid-ahmadi merged 8 commits into
mainfrom
vahid-ahmadi/issue-1069-pip-points-plan

Conversation

@vahid-ahmadi

@vahid-ahmadi vahid-ahmadi commented May 27, 2026 •

Copy link
Copy Markdown
Collaborator

Corrects the PIP point system planning page (docs/book/programs/gov/dwp/pip-points-plan.md), written for #1069.

The page itself is already on main: it shipped in #2386 (merged 21 October 2026), and its original .added changelog entry was released in 2.143.0. This branch has merged main, dropped the released fragment and now carries only corrections to main's copy of the page.

What this PR corrects (from its changelog fragment):

Brought the PIP point system planning page (docs/book/programs/gov/dwp/pip-points-plan.md) up to date: #1661 merged on 21 October 2026, so total points and the 8- and 12-point thresholds are modelled, with no data path supplying points yet; Microcosm #145 closed without the points item; Microcosm UK is now the certified default; and the descriptor-weighting source is DWP's Pathways to Work evidence pack (Tables 2.27 and 2.28).

The claim-by-claim review behind these corrections, with sources, is in the "Ready for hub review" comment on this PR.

  • Changelog fragment: changelog.d/1069-pip-points-page-corrections.changed.md (changed).
  • Docs and changelog only; no code changes.

🤖 Generated with Claude Code

@vahid-ahmadi
vahid-ahmadi force-pushed the vahid-ahmadi/issue-1069-pip-points-plan branch from 463a466 to 56cbca0 Compare October 8, 2026 14:50
vahid-ahmadi and others added 3 commits October 12, 2026 10:59
#1069 references SI 2013/377 Part 2 (daily living activities and
points) and asks for the underlying point system to be modelled.

Currently PolicyEngine UK reads the category (STANDARD / ENHANCED /
NONE) directly via pip_dl_category and pip_m_category and multiplies
by the weekly rate. That's correct for population aggregates because
the FRS doesn't capture activity-level scores and DWP's caseload
publications report bands rather than scores.

Where the points machinery would matter: descriptor reforms (e.g.
the 2024 Green Paper proposals), threshold reforms (raising the 8/12
cutoffs), and any analysis distributing by activity.

Three-phase plan:

1. Points-to-category mapping behind a use_point_system switch
   parameter, preserving the categorical default (10 daily-living
   activity scores + 2 mobility activity scores -> total -> band via
   threshold params).
2. Descriptor-level parameters under gov/dwp/pip/descriptors/ so
   descriptor point values themselves are reformable.
3. Data-side descriptor imputation in policyengine-uk-data
   (needed to make Phase 2 reforms work on the calibrated microsim).

Pure planning; current pip variables and parameters unchanged.
…gelog fragment

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Cite Schedule 1 of SI 2013/377, note per-activity maxima, describe how
Microcosm UK derives the PIP categories, record that uk-data #408 was
closed with the points work moved to microcosm #145, and drop em dashes.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@vahid-ahmadi
vahid-ahmadi force-pushed the vahid-ahmadi/issue-1069-pip-points-plan branch from 56cbca0 to ceedee1 Compare October 12, 2026 09:06
policyengine.py 6.2.6 certifies policyengine-uk-data 1.58.0 as the UK
default; Microcosm UK is the replacement being built. Both derive the
fields this page relies on in the same way.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
MaxGhenis and others added 4 commits October 23, 2026 02:37
Main already carries a later version of this page (added by #2386 and
revised on its branch on 19 October); the conflict resolves to main's
version before the page is corrected.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
- #1661 merged on 21 October 2026: pip_dl_points and pip_m_points and
  the gov.dwp.pip.{daily_living,mobility}.points_thresholds parameters
  exist, so the page is "partly planned"; the category comes from points
  only when none is supplied for the year, and an earlier category carries
  forward unless points are newer (utils/pip.py).
- No data path supplies points: microcosm#145 closed on 16 October with
  the PIP points item dropped.
- Microcosm UK is the certified default (policyengine.py 6.10.0), not a
  dataset "being built"; both derive bands from reported amounts.
- Threshold reforms now work for households entered with points, not in
  microsimulation; Phase 1's threshold parameters are done.
- Activity 8 is "reading and understanding signs, symbols and words"
  (SI 2013/377 Sch. 1 Part 2).
- No DWP table is called "activities most commonly scoring above zero";
  the per-activity score distributions are Tables 2.27 and 2.28 of the
  Pathways to Work evidence pack, chapter 2.
- Replaced the released .added fragment with a .changed fragment.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
From the independent review of the corrections (household runs on main):
- A category supplied for a year is stored for the whole simulation, with
  NONE for anyone not given one; points count only up to the year being
  calculated, and an earlier category carries forward unless the points
  are for a later year than it (utils/pip.py).
- DWP's regular statistics report award levels; per-activity figures are
  one-off, which the Phase 3 citation now matches. Tables 2.27 and 2.28
  cover working-age, normal-rules daily living awards in England, Wales
  and abroad.
- "partly modelled" heading; descriptor combinations are drawn within the
  observed band; #1661's points inputs default to -1 ("not assessed").

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…able

Second-round review (approved): utils/pip.py ignores -1 ("not assessed")
points; the evidence pack has mobility total-points tables but none per
activity.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@MaxGhenis

Copy link
Copy Markdown
Collaborator

UK hub (Claude build session, for Max)
Ready for hub review

Head: 5f515b87fdf0402f51db684844b1318db329ae44

Context. A later version of this page reached main through #2386 (merged 21 October 2026), and the 1069-pip-points-plan.added.md entry is already in CHANGELOG.md under 2.143.0. This branch still had the 12 October version. I merged origin/main into this branch (no rebase, no force-push), resolved the add/add conflict to main's version, deleted the released .added fragment, and corrected main's version. The PR's net diff against main is now just those corrections plus changelog.d/1069-pip-points-page-corrections.changed.md. Suggested title: "Bring the PIP point system plan up to date".

Is the plan still worth having? Yes. #1661 merged on 21 October 2026 and implements total points and the thresholds. The page now says "partly modelled" and keeps the per-activity scores, descriptor parameters and data imputation as planned work.

Review. I had a verifier extract and check every claim, checked each correction myself, and then ran independent adversarial reviews (household runs on main). Round 1 asked for changes, and round 2 approved; its two optional wording points are applied in the last commit.

Corrected (13)

What #1661 changed

  1. Add PIP points-based assessment scaffold (#1069) #1661 merged on 21 October 2026 (merge commit 1c42168). The title, warning box and status box now say total points (pip_dl_points, pip_m_points) and the 8- and 12-point thresholds (gov.dwp.pip.{daily_living,mobility}.points_thresholds) are modelled.
  2. The category rule, stated exactly (policyengine_uk/utils/pip.py:18-72):
    • a category input for a year is stored for everyone, with NONE for others;
    • otherwise the latest assessed points (not -1) up to that year set it;
    • an earlier category carries forward unless the points are later than it.
  3. No data path supplies points, so points play no part in microsimulation. Microcosm's disability stage outputs categories only.
  4. microcosm#145 closed on 16 October 2026 with the PIP points item dropped (its closing comment).
  5. Threshold reforms now work for households entered with points, but not in microsimulation.
  6. Phase 1's threshold parameters are done (in Add PIP points-based assessment scaffold (#1069) #1661).
  7. The "Existing model" list now includes the points inputs and thresholds.
  8. Add PIP points-based assessment scaffold (#1069) #1661's points inputs default to -1, meaning "not assessed" (variables/input/pip_dl_points.py:10).

Data and sources
9. Microcosm UK has been the certified default since policyengine.py 6.10.0 (21 October 2026); it is not "being built to replace" the Enhanced FRS.
10. SI 2013/377 Sch. 1 Part 2 activity 8 is "reading and understanding signs, symbols and words".
11. No DWP table is called "activities most commonly scoring above zero". The per-activity score distributions are Tables 2.27 and 2.28 of the Pathways to Work evidence pack, chapter 2: working-age, normal-rules daily living awards in England, Wales and abroad, January 2025 caseload, with no per-activity mobility table.
12. DWP's regular statistics report award levels; the per-activity figures are one-off. Phase 3 now draws combinations within the observed band.
13. Replaced the released .added fragment with a .changed fragment.

Checked and correct (unchanged)

  • pip_dl_category and pip_m_category are STANDARD | ENHANCED | NONE.
  • pip_dl and pip_m use the weekly rate × 52; a household run gives 3,988.40 at the standard rate.
  • Ten daily-living and two mobility activities, worth 0-12 points; standard at 8 and enhanced at 12 (regs 5(3), 6(3)), scored independently.
  • Both datasets derive bands from reported amounts.
  • uk-data#408 closed unmerged on 19 June 2026.
  • The April 2024 green paper consulted on descriptors; the March 2025 Pathways to Work paper proposed the four-point rule, which was withdrawn in July 2025 (Hansard, 1 and 9 July 2025).
  • PIP point system #1069 is open, and all links return 200.

@vahid-ahmadi vahid-ahmadi changed the title Add PIP point system planning doc (#1069) Update the PIP point system docs page (#1069) Oct 23, 2026
@vahid-ahmadi
vahid-ahmadi added this pull request to the merge queue Oct 23, 2026
Merged via the queue into main with commit 4eede4f Oct 24, 2026
10 checks passed
@vahid-ahmadi
vahid-ahmadi deleted the vahid-ahmadi/issue-1069-pip-points-plan branch October 24, 2026 09:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants