From: Thomas Walker Lynch Date: Fri, 21 Nov 2025 11:46:14 +0000 (+0000) Subject: . X-Git-Url: https://git.reasoningtechnology.com/?a=commitdiff_plain;h=1889965a1da005eae0511e66239a52c499c79f00;p=Harmony.git . --- diff --git a/00_Harmony b/00_Harmony new file mode 100644 index 0000000..e69de29 diff --git a/0pus_Harmony b/0pus_Harmony deleted file mode 100644 index e69de29..0000000 diff --git a/document/Harmony/00_Project_Structure.org b/document/Harmony/00_Project_Structure.org index 1f7e0a0..a53103b 100644 --- a/document/Harmony/00_Project_Structure.org +++ b/document/Harmony/00_Project_Structure.org @@ -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)