Scaffoldia

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

Note	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. See .machine_readable/descriptiles/STATE.a2ml for the honest state.

Table of Contents

• What this is
• Quick start
• What the substrate provides
• Repository map
• Where to go next
• Licence

What this is

Scaffoldia is the top layer of the estate’s scaffolding stack:

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

standards defines the RSR canon; rsr-template-repo operationalises it as a GitHub template with a basic just init scaffolder; scaffoldia is the full-featured designer that treats variation as data. It consumes each variant template’s variant contract (VARIANT.a2ml — parent pin + declared path divergences; see ADR-0002 in rsr-template-repo and the reference implementation in rsr-julia-library-template-repo) so that GitHub’s "Use this template" path and the composed path can never silently diverge.

Mandated scope (owner, 2026-07-07): composer + retrofit from day one — the same pack-diff machinery that composes new repos re-synchronises existing ones, including regenerating the rsr-*-template-repo family as generated artifacts until scaffoldia itself takes over ("cut-off day").

Quick start

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

What the substrate provides

• Machine-readable metadata (.machine_readable/descriptiles/) — STATE, META, ECOSYSTEM, PLAYBOOK, AGENTIC, NEUROSYM, CLADE, and anchors/ANCHOR, in a2ml, so tools and agents can read the project’s state and boundaries.

• AI gatekeeper protocol — 0-AI-MANIFEST.a2ml is the universal entry point that tells an AI agent how to work in this repo before it touches anything.

• Typed ABI/FFI seam — src/interface/Abi/ (Idris2 type + layout proofs) over src/interface/ffi/ (Zig implementation), with generated C headers.

• CI/CD — GitHub Actions for quality, security (CodeQL, Scorecard, secret scanning), multi-forge mirroring, and RSR anti-pattern enforcement.

• Supply-chain & reproducibility — container layering (stapeln), Nix/Guix shells, SBOM, and signing hooks.

• Governance — GOVERNANCE.adoc, MAINTAINERS.adoc, .github/ community health files, and a release AUDIT.adoc gate.

Repository map

Path	What lives there
0-AI-MANIFEST.a2ml	Universal entry point for AI agents (read first).
.machine_readable/	Project metadata, policies, contractiles, AI configs.
src/interface/	Typed ABI (Idris2) + FFI (Zig) + generated headers.
docs/	Onboarding, status, governance, practice, decisions.
build/, Justfile	Task orchestration (just phases delegate to build/just/*.just).
.github/	Workflows + community health files.
tests/, benches/	Test suites and benchmarks.

Where to go next

• EXPLAINME.adoc — the engineering deep-dive: how the pieces actually work.

• AUDIT.adoc — the release audit gate.

Licence

Released under the Mozilla Public License 2.0 unless a per-file SPDX-License-Identifier says otherwise.