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; composition and retrofit are not implemented. The
inherited RSR governance, CI and Idris2/Zig interface scaffold are not a
working repository designer. The present architecture and blockers are tracked
in |
Scaffoldia is the top layer of the estate’s scaffolding stack:
metadatastician/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 current deed contracts: archetype *_praxis.deed files,
overlays and the (variant), (provenance), (rsr-profile) and
(mint-answers) clauses of a repository *_chora.deed. Earlier standalone
VARIANT.a2ml/ARCHETYPE.a2ml descriptions were superseded in part by
rsr-template-repo ADR-0002/0003 on 2026-10-06. Both the template mint and
Scaffoldia must use the same upstream contract semantics, with replayable
mint answers and drift checks; no parallel schema.
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").
just # lists all phases (build, test, validate, audit, ...)
just validate # structure + metadata checks (RSR shape)-
Machine-readable metadata (
.machine_readable/descriptiles/) —STATE,META,ECOSYSTEM,PLAYBOOK,AGENTIC,NEUROSYM,CLADE, andanchors/ANCHOR, in a2ml, so tools and agents can read the project’s state and boundaries. -
AI gatekeeper protocol —
0-AI-MANIFEST.a2mlis the universal entry point that tells an AI agent how to work in this repo before it touches anything. -
Inherited ABI/FFI scaffold —
src/interface/Abi/(Idris2) andsrc/interface/ffi/(Zig). Their symbol names, return codes and pointer semantics currently disagree; compilation of each side does not establish cross-language conformance. Do not use the seam for composition yet. -
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 releaseAUDIT.adocgate.
| Path | What lives there |
|---|---|
|
Universal entry point for AI agents (read first). |
|
Project metadata, policies, contractiles, AI configs. |
|
Typed ABI (Idris2) + FFI (Zig) + generated headers. |
|
Onboarding, status, governance, practice, decisions. |
|
Task orchestration ( |
|
Workflows + community health files. |
|
Test suites and benchmarks. |
-
EXPLAINME.adoc— the engineering deep-dive: how the pieces actually work. -
AUDIT.adoc— the release audit gate.
Released under the Mozilla Public License 2.0 unless a per-file
SPDX-License-Identifier says otherwise.