How it works
From an old address to a new site
What the agent does with a government website, step by step: which Meta model does what, how it checks itself, and where a person has to take over.
Last updated October 28, 2026. Questions: GitHub issues or rmbergonia.com.
01You paste an address
RE:GOV takes government and public-school addresses only: .gov.ph, .edu.ph and .mil.ph, plus government domains abroad. Runs wait in a queue and a few go at a time, so each gets the whole machine. The job page shows your place in line and keeps itself up to date.
The same site is not rebuilt twice within a day; you are sent to the run that already exists. Model credits are limited, so there is a daily cap on new runs.
02Crawl
A real browser (Playwright) visits up to 30 pages on the same site at about one request a second, following robots.txt and Crawl-delay. Before any page is collected, Muse Spark reads the site’s terms of use; if they forbid automated access or republishing, the run stops. More about the crawler. For each page it keeps a full screenshot, the visible text, the links and any attached files. WordPress sites also give up their posts through the REST API.
If the site blocks crawlers or is down, the agent rebuilds from the Wayback Machine month with the most real pages, so even a dead site gets its content back.
03Understand
Muse Spark 1.3 reads every page, screenshot and text together, and returns a strict, typed model of it: headings, people, steps, tables, contacts, FAQs, timelines. Text that only exists inside an image (a scanned notice, a poster) is transcribed. It also notes accessibility problems and anything a person should confirm.
04Plan
Muse Spark then looks at all the pages at once and plans a citizen-first site: the navigation, the services people come for, the homepage sections, the footer, and a redirect from every old address to its new one.
05Seal and header art
SAM 3.1 finds the agency’s seal on the old homepage and cuts it out cleanly to use as the new logo. Muse Spark writes an art brief from the plan, and Muse Image paints a wide header illustration for that agency or town. It is labelled as AI-generated, never passed off as a photograph.
06Build on Kapwa
The site is rendered live from the plan on Kapwa, the design system BetterGov.ph volunteers made for Philippine government portals: its colour tokens, type scale and base styles, with an editorial layout on top (square corners, ruled sections, numbered indexes) so it reads like a public document, not an app. How RE:GOV uses Kapwa →
A design check runs first. If the old site is already modern, the agent keeps its brand colour and softer shapes and upgrades it instead of replacing its look.
07Documents and people
Every office must publish a Citizen’s Charter: requirements, steps, fees and processing time for each service. Agencies usually post it as a PDF. Muse Spark reads those PDFs directly and turns each service into its own page with a requirements list and a step table, linked to the source file.
SAM 3.1 finds officials’ portraits on the old pages, and Muse Spark names each one from the caption beside it, never from the face, and writes its alt text.
08Checks
- Self-check. Muse Spark reads each rebuilt page next to its original and lists what was lost and any statement the original does not support.
- Evidence. SAM 3.1 outlines the visible accessibility problems on the old homepage, so the report shows them, not just lists them.
- WCAG 2.2 AA. Every rebuilt page is tested with axe-core, and each finding is tagged with the criterion it breaks.
- Before and after. Both homepages are loaded in a fresh browser to compare speed, weight, requests and automated accessibility errors.
All of it lands in the migration report for each site, linked from the showcase.
09After the build
- Filipino edition. The language switch asks Muse Spark to translate a page the first time someone reads it in Filipino.
- Ask this site. The search box answers questions using only the site’s own pages, and cites them.
- Handoff. The agency can download the whole site as static HTML with a redirect map and a README, to publish on its own server.
10Where it stops
Every site RE:GOV makes is an unofficial concept. It is marked that way on every page, kept out of search engines, and not affiliated with the agency. The agent does not log in anywhere, fill in forms or touch the original site.
Models make mistakes, and the self-check catches most, not all. Fees, hotlines and office hours should be confirmed with the office, and a person with a keyboard and a screen reader still needs to test the result. Agencies can ask for changes or removal through GitHub issues. The code is open at github.com/rockyru/regov.