Welcome to the Rules as Code Hackathon starter repository!
This template helps teams explore how pension lump-sum decisions can be modeled, explained, and made transparent using code.
Rules as Code is an approach where legislation, policies, or administrative rules are written in both human-readable and machine-executable formats. The goal is to improve clarity, consistency, and accessibility of public services.
| Folder/File | Description |
|---|---|
data/Hackathon_profiles.yaml |
Fictional pension profiles for testing your solution |
rules/ |
Place your rule logic here (calculations, decision trees, etc.) |
examples/ |
Example scenarios and questions to explore |
Participants will build tools that help citizens understand their pension lump-sum options. The focus is on:
- Explainability – Can a user understand why a recommendation is made?
- Transparency – Are the rules and assumptions clearly documented?
- Accessibility – Can non-technical users benefit from the tool?
- Click "Use this template" on GitHub to create your own copy
- Explore the sample profiles in
data/Hackathon_profiles.yaml - Add your rule logic in the
rules/folder - Document your assumptions and approach
- Build a prototype (CLI, web app, notebook, etc.)
- Assumptions are allowed – Real pension rules are complex. Document any simplifications you make.
- Focus on explainability – Your solution should help users understand their options, not just compute numbers.
- Mixed teams welcome – This challenge is designed for developers, policy experts, designers, and domain specialists working together.
- Keep it simple – A clear, working prototype is better than an over-engineered solution.
⚠️ This is a hackathon challenge only.The profiles in this repository are fictional. Any calculations or advice produced by solutions built on this template are non-binding and should not be used for real financial decisions.
This project is open source under the MIT License.
Good luck, and happy hacking!