.
authorThomas Walker Lynch <eknp9n@reasoningtechnology.com>
Fri, 21 Nov 2025 11:46:14 +0000 (11:46 +0000)
committerThomas Walker Lynch <eknp9n@reasoningtechnology.com>
Fri, 21 Nov 2025 11:46:14 +0000 (11:46 +0000)
00_Harmony [new file with mode: 0644]
0pus_Harmony [deleted file]
document/Harmony/00_Project_Structure.org

diff --git a/00_Harmony b/00_Harmony
new file mode 100644 (file)
index 0000000..e69de29
diff --git a/0pus_Harmony b/0pus_Harmony
deleted file mode 100644 (file)
index e69de29..0000000
index 1f7e0a0..a53103b 100644 (file)
@@ -7,7 +7,13 @@
 The Harmony skeleton is **Prescriptive**; it defines the authoritative rules for file organization based on fundamental properties (invariants). This system is designed to formalize concepts, eliminate ambiguity, and serve as a central working point for the team.
 
 * 1. Core Prescriptive Invariants
-The separation is based on **Provenance (Origin)** and **Transience (State)**.
+
+** 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 directory structure enforces this semantic separation.
 
 ** Provenance: Authored vs. Made
 - **Authored** (The Artist): Trees holding human-written intent. Tools must treat as *read-only*.
@@ -25,14 +31,14 @@ Directory names are properties bestowed upon their contents. The path is a descr
 
 ** =developer/made/=
 - **Invariant:** Architecture-Agnostic Output.
-- **Contents:** Shared scripts, wrappers, and symlinks to authored code (e.g., Python entry points) that are the **result of a setup process**.
+- **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.
 
 ** =developer/scratchpad/=
 - **Invariant:** Transient Workspace.
 - **Contents:** Intermediate files, object files, dependency files.
 
 ** =developer/scratchpad/made/=
-- **Invariant:** Machine-Made Binaries (Intermediate).
+- **Invariant:** Machine-Made Binaries (Intermediate), generally OS loadable made things that are not to be tracked.
 - **Contents:** Compiled binaries and libraries derived by the build system. The contents of =scratchpad/= are permanently Git-ignored.
 
 * 3. Release Structure (The Central Working Point)