SCAFFOLD.
Stop writing code. Start dictating Architectural Reality.
A deterministic, indentation-based grammar for manifesting infrastructure.
The Anatomy
of a Blueprint.
A .scaffold file is a living constitution. It defines the geometry of your project using strict indentation. It understands variables, logic gates, and deep file manipulation natively.
1# --- I. THE GNOSTIC VARIABLES ---2$$ project_name = "Nova-Core"3$$ use_docker = true45# --- II. THE SCRIPTURE OF FORM ---6src/7 api/8 routes.py :: "from fastapi import APIRouter"9 models.py << ./templates/base_model.py10 11 # Logic Gates dictate topological reality12 @if {{ use_docker }}:13 Dockerfile :: "FROM python:3.11-slim"The Sacred Sigils.
Variable Definition
Declares a variable. Injects Gnostic state into the Alchemical reactor for transmutation downstream.
Inline Inscription
Manifests a file and injects the provided string directly into its soul. Supports triple-quotes for multi-line bodies.
Celestial Seed
Copies the soul of an external file (a template) into the new physical coordinate.
Symbolic Link
Forges an OS-level symlink, bridging two coordinates in spacetime.
Structural Mixin
Defines a reusable block of architecture that can be summoned later with '%% use'.
Gnostic Inhalation
Inhales variables and macros from another .scaffold file or a remote SCAF-Hub repository.
The Composable
Multiverse.
Scaffold is not a flat file generator. It is a hierarchical architecture language. We distinguish between importing the Mind and including the Matter.
@import (The Mind)
Surgically extracts variables, traits, and macros from a target without creating any files. Perfect for Global Law files (e.g. std.sec).
@include (The Matter)
A total physical manifestation. Evaluates the target scripture and creates its files, automatically indenting them to match the call-site.
1# Inhale the Laws of Security (Variables only)2@import std.sec as security34src/5 # Manifest an entire database structure inside 'src/'6 # It inherits the 4-space indentation automatically!7 @include modules/database.scaffold8 9 config.py :: "ALGO = '{{ security.auth_algo }}'"