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

index 3a358d2..8d950bf 100644 (file)
@@ -10,7 +10,7 @@ The Harmony skeleton is **Prescriptive**; it defines the authoritative rules for
 
 ** 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.**
+- **CREATE:** The act of originating intent. This power belongs only to **God, Artists, and SQL programs.** To avoid confusion we make use of the synonym **authored**.
 - **MAKE:** The act of assembling materials into a product. This is performed by **Factories (Build Tools)**.
 
 The directory structure enforces this semantic separation.
@@ -31,7 +31,9 @@ Directory names are properties bestowed upon their contents. The path is a descr
 
 ** =developer/made/=
 - **Invariant:** Architecture-Agnostic Output.
-- **Contents:** Symlinks to authored code (e.g., Python entry points) that are the **result of a setup process**, files for the OS loader, in general things generated by programs.
+
+- **Contents:** Intended to hold compiled programs and links back into authored interpreted programs. As a general rule, if the contents of a "made"
+  directory is deleted, it can be regenerated.
 
 ** =developer/scratchpad/=
 - **Invariant:** Transient Workspace.