This directory begins the modern HCMD Tutorial, rebuilt from a clean slate.The previous tutorial has been preserved under HCMD-Tutorial-Legacy/ as a historical snapshot of the early HCMD era.
HCMD has evolved significantly since that time.The modern tutorial reflects the corrected architecture:
-
Meaning Layer
-
STS (Structured Task Specification)
-
PSC (Pseudo‑Structural Code)
-
Implementation
-
HMD (Hierarchical Meaning Document)
-
Language Portability Principle
-
Two‑Copilot Model
-
Deterministic Pipeline
The legacy tutorial predates these corrections and is archived for reference only.
The folder HCMD-Tutorial-Legacy/ contains:
- the original Acts 1–4
- early conceptual notes
- pre‑HMD terminology
- pre‑PSC correction
- pre‑Two‑Copilot model explanations
- early examples and environment notes
It represents the first generation of HCMD thinking.It is preserved for historical continuity and for readers who want to see how HCMD developed over time.
The modern HCMD Tutorial begins with InjectML, a compact demonstration of the full HCMD pipeline:
- deterministic Meaning → STS → PSC → Implementation
- language‑agnostic structure
- reproducible regeneration
- PSC‑correct and STS‑correct
- ideal for teaching the architecture cleanly
InjectML is the recommended starting point for all new readers.
EntropyML is an optional second example that applies HCMD to a conceptual modeling domain.It demonstrates:
- abstract Meaning modeling
- structural decomposition through PSC
- HMD as a unified semantic‑structural artifact
- interpretability of conceptual systems under HCMD
EntropyML is not required for beginners but is valuable for readers exploring HCMD’s expressive range.
This root directory will gradually be filled with:
- a new HCMD Tutorial Overview
- updated terminology
- modern examples
- structured Acts aligned with the corrected architecture
- references for HMD, AML, PSC, STS, and the Two‑Copilot Model
The tutorial will grow in parallel with the evolution of HCMD itself.