OKF-DWP

Independent experimental publication. Not an official DWP service, benefits advice or an entitlement calculator.

View this version’s Markdown source

On this page

Stakeholder needs and evaluation journeys

Purpose and status

This is the evaluation design for the next stage of the independent DWP knowledge-framework exemplar. It adds five projected personas, six user stories and six proposed evaluation questions in knowledge/evaluation-journeys.yamlld. It extends the initial three personas, four stories and eight questions.

These are project-authored requirements and test designs. They have not been validated through user research or approved by policy, legal, operational or fraud and error specialists. No new evaluation outcomes are claimed here. The existing deterministic retrieval checks measure a narrower capability.

Staff needs below are de-identified paraphrases of owner-supplied correspondence. The correspondence, contact details and quotations are not published. A reference to an earlier Markdown plan appeared in the correspondence, but that plan was not supplied: its detailed requirements and acceptance criteria remain unknown.

What the contributions establish

ID Origin Need to retain Consequence for the exemplar
ST01 Staff contribution Treat operational guidance and legislation as distinct sources; investigate ambiguity. Show the source type and each interpretative step. Record unresolved differences for specialist review. The reported operational use of DMG is not a declaration that guidance overrides law.
ST02 Staff contribution Explore a rules engine built from the guidance. Start with one evidence-backed rule candidate whose assumptions, exceptions, dates and tests can be reviewed. A source graph alone does not meet this need.
ST03 Staff contribution Account for fraud, error and evidence requirements beyond policy interpretation. Keep a separate requirement category and ownership route. Do not infer evidence collection or risk rules from a policy passage alone.
ST04 Staff contribution Examine adviser material, case law and weaknesses in benefit calculators. Record what each source or tool can evidence and compare only controlled, synthetic scenarios. A disagreement does not establish which tool is wrong.
OW01 Owner request Expand personas, journeys and questions for extensive evaluation. Create a traceable case matrix with positive cases, negative controls and recorded outcomes. The six cases below are a seed set.
OW02 Owner request Develop application and change-of-circumstances journeys. Design two distinct synthetic journeys with an assisted route; establish official service boundaries before operational implementation.
OW03 Owner request Extend to the full DMG by 24 September 2026; consider ADM and Universal Credit. Use separate coverage and freshness records for each source family and retain the Pension Credit pilot as a reviewed vertical slice.
MP01 Quoted model proposal in the supplied correspondence An evidence → proposition → rule → executable rule pipeline, changesets and review gates. Evaluate this as a candidate method. It is not an agreed architecture or a completed capability.

The quoted model's technology choices and effort estimates are not adopted as staff-approved requirements. The corpus census and validation receipts in this repository are the evidence for work actually completed.

Projected personas and journeys

Each persona below is a hypothesis for research and evaluation, not a description of an identified person. The existing welfare rights adviser is reused for J04.

Journey Persona and goal Need IDs Bundle story and question
J01 Policy and legislation reviewer: trace an interpretation to its sources and identify unresolved ambiguity. ST01, OW01 story/policy-law-trace · question/stage2-001
J02 Rules architect: inspect a candidate rule's complete evidence and test chain before implementation. ST02, MP01, OW01 story/rule-candidate-review · question/stage2-002
J03 Evidence assurance reviewer: distinguish policy facts from additional operational evidence requirements. ST03, OW01 story/evidence-requirements · question/stage2-003
J04 Welfare rights adviser: compare source coverage and calculator behaviour without assuming equivalence. ST04, OW01 story/adviser-comparison · question/stage2-004
J05 Applicant or change reporter: understand the next step in an application or a separate report-of-change scenario. OW02, OW01 story/apply-and-report-change · question/stage2-005
J06 Assisted support practitioner: help someone find and understand source evidence using an accessible route. OW02, OW01 story/assisted-discovery · question/stage2-006

Proposed evaluation cases

Every case uses invented scenarios and no claimant personal data. A chapter or page listed below is a discovery starting point, not an assertion that it contains a complete answer or an operational requirement. The bundle's references edges are navigation links; they do not mean that a source legally authorises a rule.

J01: Trace policy and legislation

J02: Review a candidate rule before implementation

J03: Separate policy and evidence requirements

J04: Compare adviser sources and calculators

J05: Apply and report a change

J06: Assisted and accessible discovery

Record outcomes without conflating tests

Keep separate measures for retrieval, citation accuracy, interpretation, relationship correctness, temporal reasoning, refusal of unsupported claims, accessibility and end-to-end task completion. Source acquisition counts do not measure legal coverage or correct interpretation.

For each executed case, record:

Use not-run, passed, failed or blocked for execution outcomes, separately from not-reviewed, changes-required or approved for human review. A static YAML-LD or link check must not change a proposed behavioural case to passed. The six new question records are currently tagged not-executed.

What the 24 September milestone should evidence

The owner has requested wider coverage by 24 September 2026. This document sets review criteria for that milestone, not an assurance that full legal reasoning or an operational engine will be complete by then.

Workstream Demonstrable outcome Boundary to retain
Full DMG collection A dated census, explicit exclusions, provenance-bearing chapter records and coverage measures; a prioritised semantic map with unresolved relationships visible. Full document coverage is distinct from complete concept modelling, interpretation or review.
Pension Credit pilot One bounded concept and relationship path that specialists can inspect, with the six proposed journeys exercised where evidence is available. Unexecuted, blocked and unreviewed cases remain visible.
Advice for decision making Separate discovery and source-family records, plus explicit cross-guide questions for review. Do not treat ADM and DMG as interchangeable or merge identically named concepts without scope evidence.
Universal Credit eligibility A dated citizen-facing source reference and a proposed service-discovery journey. A public overview is not a complete decision rule set and cannot silently substitute for Pension Credit guidance.
Legislation and case law A source identity and version strategy, with verified pilot references and a record of gaps. A provision URL or case link does not establish applicability, precedence or complete legal coverage.
CPAG Clearly identified public navigation and catalogue evidence. The captured contents do not supply substantive legal interpretation or permission to acquire subscriber text.

The next research discussion should confirm the pilot rule family, the intended benefits and jurisdictions, policy and legal review ownership, operational evidence requirements and the missing original plan. Independent source, modelling and evaluation work can proceed while those decisions are obtained.