UDSL-v1.0 / README.md
RenMetrix's picture
Metadata and README update
80b61c7 verified
|
raw
history blame
3.9 kB
metadata
license: cc-by-4.0
tags:
  - code
  - agent
  - udsl
  - document-structure
  - document-schema
  - ai-standards
  - llm-framework
  - model-agnostic
  - cross-llm
  - prompt-engineering
  - reasoning-models
  - governance
  - compliance
  - auditability
  - explainability
  - interoperability
  - renmetrix
  - loom-protocol
  - structured-writing
  - ai-governance
  - ai-compliance
  - responsible-ai
  - ai-evaluation
  - ai-validation
  - document-structure-fr
  - document-structure-es
  - document-structure-de

UDSL v1.0 β€” Universal Document Structure Layer

The first AI-native, model-agnostic document structure standard. Version: v1.0 (Public Beta Release) Author: Nathan Lumulisanay β€” RenMetrix β€” LOOM Protocol License: CC-BY-4.0

πŸ“˜ What is UDSL?

UDSL (Universal Document Structure Layer) is a vendor-neutral document architecture that forces large language models (ChatGPT, Claude, Gemini, Perplexity, etc.) to generate:

structurally consistent

explainable

auditable

human-aligned

long-form documents

UDSL replaces ad-hoc prompting with a formal, enforceable structure layer based on:

canonical YAML definitions

reasoning schemas (Toulmin, deductive, inductive)

tone profiles

UX writing rules

terminology maps

🎯 What problem does UDSL solve?

LLMs generate tokens, not documents β€” causing:

structural drift

missing sections

inconsistent tone

weak reasoning

model-to-model variance

UDSL solves this through one unified layer that every model can follow identically.

πŸ“¦ What’s included in v1.0?

This public release contains:

UDSL Core Specification (PDF)

Canonical YAML/MD definitions (structure, reasoning, tone, terminology, UX)

Validator toolkit (schema + scoring model + CLI validator)

Integration profiles for ChatGPT, Claude, Gemini, Perplexity

Example UDSL-compliant documents

Build + integrity scripts (checksums + ZIP builder)

Release notes + checksum file

πŸ“„ How to use UDSL with any LLM

Example prompt:

You are an AI system that MUST follow the UDSL v1.0 standard. doc_type: policy_memo tone_profile: formal_concise reasoning_mode: toulmin audience: board

Follow the canonical outline from UDSL’s structure.yaml. Apply the reasoning rules from reasoning_schemas.yaml. Do NOT invent additional sections.

Works identically in:

ChatGPT

Claude

Gemini

Perplexity

πŸ§ͺ Validator (CLI)

UDSL ships with a minimal validator so anyone can check whether a document meets the standard.

python validator/udsl_validate.py your_document.md

Gives a JSON score for:

structure compliance

reasoning integrity

tone alignment

UX rules

terminology consistency

πŸ”— Links

GitHub (source): https://github.com/nathanlumulisanay-lgtm/udsl

Zenodo DOI (archival release): ➑️ doi.org/10.5281/zenodo.17625481

πŸ“œ Citation Lumulisanay, N. (2025). UDSL β€” Universal Document Structure Layer (v1.0). RenMetrix β€” LOOM Protocol.

🏷 Tags document-structure ai-framework llm-standard reasoning prompt-engineering auditability governance tooling nlp

βœ… 2. VOEG DEZE METADATA TOE (linker kolom)

Klik links op:

βœ” License β†’ cc-by-4.0 βœ” Language β†’ "not applicable" (dit is geen taalmodel) βœ” Base model β†’ none βœ” Pipeline tag β†’ "other" βœ” Tags β†’ plak deze: UDSL document-structure nlp model-agnostic framework llm compliance governance standard auditability reasoning prompt-engineering docs

βœ… 3. Upload de bestanden (heel belangrijk)

Klik bovenaan op Files and versions β†’ Add file β†’ Upload Upload:

Hoofd-bestand

βœ” UDSL_Public_v1.0.zip

Documenten (optioneel maar aan te raden)

βœ” /Docs/UDSL_Core_Spec_v1.0.pdf βœ” /Docs/UDSL_Architecture_arXiv_Ready.pdf βœ” /Docs/UDSL_AI_Usage_Directive_v1.0.pdf βœ” /Docs/UDSL_Specification_v1.0_Expanded.pdf

PNG visualisaties

βœ” udsl_flow_minimal.png βœ” udsl_layers_minimal.png βœ” udsl_reasoning_minimal.png

CITATION

βœ” CITATION.cff