RSR Template Repository

Table of Contents

• 1. Overview
• 2. Quick Start
• 3. What’s Included
• 4. Justfile Features
  • 4.1. Key Recipes
• 5. Directory Structure
• 6. RSR Compliance
  • 6.1. Language Tiers
  • 6.2. Required Files
  • 6.3. Prohibited
• 7. STATE.scm
• 8. Badge Schema
• 9. Ecosystem Integration
• 10. License
• 11. Links

1. Overview

The canonical template for RSR (Rhodium Standard Repository) projects.

This repository provides the standardized structure, configuration, and tooling for all 139 repos in the hyperpolymath ecosystem. Use it to:

• Bootstrap new projects with RSR compliance

• Reference the standard directory structure

• Copy configuration templates (justfile, STATE.scm, etc.)

2. Quick Start

# Clone the template
git clone https://github.com/hyperpolymath/RSR-template-repo my-project
cd my-project

# Remove template git history
rm -rf .git
git init

# Customize
sed -i 's/RSR-template-repo/my-project/g' justfile guix.scm README.adoc

# Enter development environment
guix shell -D -f guix.scm

# Validate compliance
just validate-rsr

3. What’s Included

File/Directory	Purpose
.editorconfig	Editor configuration (indent, charset)
.gitignore	Standard ignore patterns
.guix-channel	Guix channel definition
.well-known/	RFC-compliant metadata (security.txt, ai.txt, humans.txt)
docs/	Documentation directory
guix.scm	Guix package definition
justfile	Task runner with 50+ recipes
LICENSE.txt	AGPL + Palimpsest dual license
README.adoc	This file
RSR_COMPLIANCE.adoc	Compliance tracking
STATE.scm	Project state checkpoint

4. Justfile Features

The template justfile provides:

• ~10 billion recipe combinations via matrix recipes

• Cookbook generation: just cookbook → docs/just-cookbook.adoc

• Man page generation: just man → docs/man/project.1

• RSR validation: just validate-rsr

• STATE.scm management: just state-touch, just state-phase

• Container support: just container-build, just container-push

• CI matrix: just ci-matrix [stage] [depth]

4.1. Key Recipes

just                # Show all recipes
just help <recipe>  # Detailed help
just info           # Project info
just combinations   # Show matrix options

just build          # Build (debug)
just test           # Run tests
just quality        # Format + lint + test
just ci             # Full CI pipeline

just validate       # RSR + STATE validation
just docs           # Generate all docs
just cookbook       # Generate justfile docs

just guix-shell     # Guix dev environment
just container-build # Build container

5. Directory Structure

project/
├── .editorconfig          # Editor settings
├── .gitignore             # Git ignore
├── .guix-channel          # Guix channel
├── .well-known/           # RFC metadata
│   ├── ai.txt
│   ├── humans.txt
│   └── security.txt
├── config/                # Nickel configs (optional)
├── docs/                  # Documentation
│   ├── generated/
│   ├── man/
│   └── just-cookbook.adoc
├── guix.scm               # Guix package
├── justfile               # Task runner
├── LICENSE.txt            # Dual license
├── README.adoc            # Overview
├── RSR_COMPLIANCE.adoc    # Compliance
├── src/                   # Source code
├── STATE.scm              # State checkpoint
└── tests/                 # Tests

6. RSR Compliance

6.1. Language Tiers

• Tier 1 (Gold): Rust, Elixir, Zig, Ada, Haskell, ReScript

• Tier 2 (Silver): Nickel, Racket, Guile Scheme, Nix

• Infrastructure: Guix channels, derivations

6.2. Required Files

• .editorconfig

• .gitignore

• justfile

• README.adoc

• RSR_COMPLIANCE.adoc

• LICENSE.txt (AGPL + Palimpsest)

• .well-known/security.txt

• .well-known/ai.txt

• .well-known/humans.txt

• guix.scm OR flake.nix

6.3. Prohibited

• Python outside salt/ directory

• TypeScript/JavaScript (use ReScript)

• CUE (use Guile/Nickel)

• Dockerfile (use Containerfile)

7. STATE.scm

The STATE.scm file tracks project state:

(define state
  `((metadata
     (project . "my-project")
     (updated . "2025-12-10"))
    (position
     (phase . implementation)  ; design|implementation|testing|maintenance|archived
     (maturity . beta))        ; experimental|alpha|beta|production|lts
    (ecosystem
     (part-of . ("RSR Framework"))
     (depends-on . ()))))

8. Badge Schema

Generate badges from STATE.scm:

just badges standard

See docs/BADGE_SCHEMA.adoc for the full badge taxonomy.

9. Ecosystem Integration

This template is part of:

• STATE.scm Ecosystem: Conversation checkpoints

• RSR Framework: Repository standards

• Consent-Aware-HTTP: .well-known compliance

10. License

SPDX-License-Identifier: AGPL-3.0-or-later OR LicenseRef-Palimpsest-0.5

11. Links

• elegant-STATE - STATE.scm tooling

• conative-gating - Policy enforcement

• Rhodium Standard - RSR documentation