Rules As Code - Energy Saving Scheme
Partner
Background
Our partners sought to evaluate if the Rules as Code model (RaC) and the multidisciplinary Better Rules methodology for co-drafting would improve the process of drafting policy rules and delivering digital services.
THE ASK
Forthcoming legislation for the Energy Security Safeguard (ESS) presents a unique challenge for our partners in the Sustainability Programs Branch (SPB). The ESS is made up of a complex set of legislation, previously defined in a 120 page policy document, which also change annually as new energy saving technology makes it way to market.
Our partners in SPB sought to evaluate if the Rules as Code model and the multidisciplinary Better Rules methodology would improve the process of drafting policy rules and delivering digital services for the ESS. Across NSW Government, RaC had previously been implemented as a successful proof of concept for comparatively simple use cases. This project would be groundbreaking given the complexity of the overarching legislation.
The Fellows were tasked with delivering solutions suitable for reuse across NSW, building capability by co-drafting policy as code with non-technical roles in SPB, and making strategic recommendations for future delivery informed by their learnings.
OUR APPROACH
We embedded our team of three Fellows into the Department for a six month engagement to work alongside policy roles in co-drafting complex requirements into code, build a tech stack to support services delivery, champion new processes and deliver a roadmap for future RaC work.
The Fellows utilised Human-centred Design and Agile delivery to build prototypes and evaluate the Better Rules methodology. In addition to comprehensive user research, they also introduced a new technique called Variable Mapping - a design facilitation that helps reduce complexity during the development of coded rules.
The Fellows introduced a new multidisciplinary policy-making process by working alongside Policy Officers from the Department to both translate rules into code, but also to set up a co-drafting process for future changes. By working in the open the Fellows were able to transfer technical knowledge to the team, define new practices, deliver a roadmap and prioritisation framework for future RaC work and provide the Department with knowledge of how to hire for, manage and run RaC projects.
SCOPE
In six months the Fellows:
Investigated ways to digitally deliver the Energy Security Safeguard using RaC
Investigated ways to improve the policy development processes
Demonstrate the viability of Open Government delivery
Conducted discovery research on internal processes and with external stakeholders
Built a ‘Rules Dashboard’ for the Safeguard and future use cases
Built an API for the Safeguard’s energy savings and future use cases
Evaluated and reflected on the ‘Better Rules’ process
Delivered a comprehensive Roadmap for future RaC projects
Provided the Department with knowledge of who to hire for future RaC work
Empowered the Department to manage projects and build capability through experimentation
SOLUTIONS
The Fellows produced three major solutions throughout their work, that will be useful for the Energy Security Safeguard and beyond...
The ‘Variable Mapping’ facilitation was created by the Fellows and meets a need that was not previously being addressed in RaC work in NSW.
The Rules Dashboard is a web application that helps visualise the structure and complexity of a coded ruleset.
The team built an Rules Calculation API that provides a user-friendly way for policy makers to run calculations and view documentation for rules defined in the OpenFisca platform.
VARIABLE MAPPING
A method of mapping created by the Fellows that acts as a middle ground between the rules and code.
It enables the team to look at parts of the rule from the perspective of Inputs, through some Logic or Calculation, to Outputs.
This technique meets a visualisation need that was not previously being addressed in RaC work.
THE RULES DASHBOARD
The Dashboard is a frontend single-page web application built using React to help communicate the contents and structure of a complex, coded ruleset.
It has proven especially useful for policy-makers, as it allows them to see the rules and experiment with different scenarios and compare different rule versions, without needing to interact with the code.
The Dashboard will promote consistent rule creation methods and tools across the Department and allows for transparency on historical and current rules.
The Rules Dashboard codebase is available on Github.
RULES CALCULATION API
Overview
A REST-ful API for performing calculations on our coded rules
Self-documenting
“Handrails included” - built in validation and suggestions
What is its value?
Ensures provenance of calculation methods
Make compliance easier & reduces barriers to entry for new participants
The Fellows built a user-friendly API wrapper for the OpenFisca RaC framework. OpenFisca is a rules engine designed for complex policy situations ie. where inputs and calculations methodologies change over time. The benefits include:
Recording the relationships between OpenFisca variables, and allows frontend applications to make generalised queries with respect to those relationships.
Providing a REST-ful API service for performing OpenFisca calculations which has input-validation and user-friendly error messages;
Self-documenting by way of auto-generated Swagger documentation
THE ROADMAP
Outlines learnings from the Fellowship and stakeholders interviews.
Details, assesses and recommends ‘project ideas’ to pursue.
Informs the Department’s strategy with RaC for the next 10 years.
Synthesised learnings from research and stakeholder interviews.
Detailed 11 potential ‘project ideas’ for the Department to pursue.
Rated them based on six assessment criteria.
Recommended a staged project delivery schedule.
RE-USE
By releasing their work as Open Source, the team have left a legacy for Rules as Code practitioners to utilise and have provided a useful starting point for future work in NSW and beyond.
The API solution has been released as a template for anyone else working with OpenFisca to leverage in their own project
Problems the team solved while building the Dashboard were used to improve how ReactJS components are supported by the NSW State Design System.
LEARN MORE ABOUT THE PROJECT VIA THE LINKS AND VIDEO BELOW:
This presentation by our Fellows highlights how to make rules simple, adaptable and digital ready.
Read more of our Case Studies to dig deeper into the work we've done.