Home

Scaffoldia

Full-featured repository designer for the RSR (Rhodium Standard Repository) estate. It composes spine@pin × variant pack × features × profile into new repositories, and retrofits existing ones.

⚠️ Status: design phase

This repository currently carries the RSR substrate — governance, CI, machine-readable metadata — and the design surface for the composer. The composition engine itself is not built yet.

.machine_readable/descriptiles/STATE.a2ml in the repository is the honest, machine-readable statement of current state; prefer it over any summary, including this page.

Where it sits in the stack

standards → rsr-template-repo → scaffoldia → (designed / retrofitted repos)

• standards defines the RSR canon.
• rsr-template-repo operationalises that canon as a GitHub template with a basic just init scaffolder.
• scaffoldia is the full-featured designer that treats variation as data rather than as forked templates.

Variant contracts

Scaffoldia consumes each variant template's variant contract — VARIANT.a2ml, recording the parent pin plus declared path divergences. The purpose is that GitHub's "Use this template" path and the composed path can never silently diverge.

See ADR-0002 in rsr-template-repo, and the reference implementation in rsr-julia-library-template-repo.

Mandated scope

Ruled by the owner on 2026-07-07: composer and retrofit from day one. The same pack-diff machinery that composes new repositories re-synchronises existing ones — including regenerating the rsr-*-template-repo family as generated artifacts, until scaffoldia itself takes over at "cut-off day".

Quick start

just                     # lists all phases (build, test, validate, audit, ...)
just validate            # structure + metadata checks (RSR shape)

The format is being renamed

The machine-readable files here are written in A2ML, which is being renamed to DEED with extension .deed (ruled final 2026-09-03). A formal DEED grammar is under review as standards#752 and has not yet merged.

No file in this repository has been converted: paths such as STATE.a2ml and VARIANT.a2ml remain current and correct.

Related projects

• standards — the RSR canon and format governance
• rsr-template-repo — the GitHub template layer
• a2ml-ecosystem — format coordination hub
• reposystem — repository system management

Contributing and licence

See CONTRIBUTING.adoc, GOVERNANCE.adoc, SECURITY.adoc and EXPLAINME.adoc.

Code is MPL-2.0; documentation is CC-BY-SA-4.0.