.
authorThomas Walker Lynch <eknp9n@reasoningtechnology.com>
Fri, 21 Nov 2025 11:49:56 +0000 (11:49 +0000)
committerThomas Walker Lynch <eknp9n@reasoningtechnology.com>
Fri, 21 Nov 2025 11:49:56 +0000 (11:49 +0000)
document/Harmony/00_Project_Structure.org

index a53103b..3a358d2 100644 (file)
@@ -8,16 +8,16 @@ The Harmony skeleton is **Prescriptive**; it defines the authoritative rules for
 
 * 1. Core Prescriptive Invariants
 
-** The Aphorism
-The project's philosophy is rooted in this fundamental distinction:
-- **God, Artists, and SQL programs create things.**
-- **Factories (Build Tools) make things.**
+** The Foundational Principle: Create vs. Make
+The project's philosophy is rooted in this semantic distinction, which governs all directory naming:
+- **CREATE:** The act of originating intent. This power belongs only to **God, Artists, and SQL programs.**
+- **MAKE:** The act of assembling materials into a product. This is performed by **Factories (Build Tools)**.
 
 The directory structure enforces this semantic separation.
 
 ** Provenance: Authored vs. Made
-- **Authored** (The Artist): Trees holding human-written intent. Tools must treat as *read-only*.
-- **Made** (The Factory): Trees holding machine-generated content (output of a process).
+- **Authored** (The Artist): Trees holding human-written intent (CREATE). Tools must treat as *read-only*.
+- **Made** (The Factory): Trees holding machine-generated content (MAKE).
 
 ** Property Schema (The Semantic Path)
 Directory names are properties bestowed upon their contents. The path is a descriptive sentence:
@@ -52,3 +52,4 @@ The =$REPO_HOME/release= directory holds candidates for testing and promotion.
 - **Invariant:** Local Action Required / Machine-Specific Output.
 - **Rule:** This directory is empty but **TRACKED** (by a committed =.gitignore=) to signal that a **local build must be performed** post-clone to populate it with executables.
 - **Contents:** Architecture-specific binaries (IGNORED).
+