Skip to content

Latest commit

 

History

70 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Scaffoldia

OpenSSF Best Practices License: MPL-2.0 Green Web

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 docs/architecture/TOPOLOGY.adoc, docs/status/ROADMAP.adoc, and .machine_readable/descriptiles/STATE.a2ml. The composer design is a proposal, not an accepted engine decision (ADR-0002).

What this is

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").

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.

  • Inherited ABI/FFI scaffold — src/interface/Abi/ (Idris2) and src/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 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.

Releases

Sponsor this project

Packages

Used by

Contributors

Languages