derived -> made
authorThomas Walker Lynch <eknp9n@reasoningtechnology.com>
Fri, 21 Nov 2025 11:35:26 +0000 (11:35 +0000)
committerThomas Walker Lynch <eknp9n@reasoningtechnology.com>
Fri, 21 Nov 2025 11:35:26 +0000 (11:35 +0000)
developer/derived/.gitkeep [new file with mode: 0644]
document/Harmony/00_Project_Structure.org
document/Harmony/01_Workflow_and_Build_Contract.org
release/loadable/.gitkeep [deleted file]
release/local_build/.gitignore [deleted file]
release/made_tracked/.gitkeep [new file with mode: 0644]
release/made_untracked/.gitignore [new file with mode: 0644]

diff --git a/developer/derived/.gitkeep b/developer/derived/.gitkeep
new file mode 100644 (file)
index 0000000..e69de29
index 568e798..1f7e0a0 100644 (file)
@@ -9,9 +9,9 @@ The Harmony skeleton is **Prescriptive**; it defines the authoritative rules for
 * 1. Core Prescriptive Invariants
 The separation is based on **Provenance (Origin)** and **Transience (State)**.
 
-** Provenance: Authored vs. Derived
+** Provenance: Authored vs. Made
 - **Authored** (The Artist): Trees holding human-written intent. Tools must treat as *read-only*.
-- **Derived** (The Factory): Trees holding machine-generated content. All writes happen here.
+- **Made** (The Factory): Trees holding machine-generated content (output of a process).
 
 ** Property Schema (The Semantic Path)
 Directory names are properties bestowed upon their contents. The path is a descriptive sentence:
@@ -23,24 +23,26 @@ Directory names are properties bestowed upon their contents. The path is a descr
 - **Invariant:** Primary Logic Source.
 - **Contents:** All human-written source code (C, Python, etc.).
 
-** =developer/loadable/=
-- **Invariant:** Architecture-Agnostic Entry Points (Shared Capability).
-- **Contents:** Shared scripts, wrappers, and symlinks to authored code (e.g., Python entry points).
+** =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**.
 
 ** =developer/scratchpad/=
 - **Invariant:** Transient Workspace.
-- **Contents:** Intermediate files, object files, dependency files. The entire contents are permanently Git-ignored.
+- **Contents:** Intermediate files, object files, dependency files.
+
+** =developer/scratchpad/made/=
+- **Invariant:** Machine-Made Binaries (Intermediate).
+- **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)
 The =$REPO_HOME/release= directory holds candidates for testing and promotion.
 
-** =release/loadable/=
-- **Invariant:** Shared, Agnostic Entry Points.
+** =release/made_tracked/=
+- **Invariant:** Shared, Agnostic Output.
 - **Contents:** Architecture-agnostic final release candidates (TRACKED).
 
-** =release/local_build/=
-- **Invariant:** Local Action Required.
+** =release/made_untracked/=
+- **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).
-
-  
index 78184c2..2fc8f23 100644 (file)
@@ -29,5 +29,5 @@ The release script must promote artifacts to these canonical locations:
 
 | Content Type | Developer Origin | Release Target | Invariant |
 | :--- | :--- | :--- | :--- |
-| **Binaries/Kmod** | scratchpad/loadable | **release/local_build/** | Architecture-Specific (IGNORED) |
-| **Agnostic Scripts** | developer/loadable | **release/loadable/** | Shared, TRACKED |
+| **Binaries/Kmod** | scratchpad/made | **release/made_untracked/** | Architecture-Specific (IGNORED) |
+| **Agnostic Scripts** | developer/made | **release/made_tracked/** | Shared, TRACKED |
diff --git a/release/loadable/.gitkeep b/release/loadable/.gitkeep
deleted file mode 100644 (file)
index e69de29..0000000
diff --git a/release/local_build/.gitignore b/release/local_build/.gitignore
deleted file mode 100644 (file)
index bea49c8..0000000
+++ /dev/null
@@ -1,3 +0,0 @@
-
-*
-!/.gitignore
\ No newline at end of file
diff --git a/release/made_tracked/.gitkeep b/release/made_tracked/.gitkeep
new file mode 100644 (file)
index 0000000..e69de29
diff --git a/release/made_untracked/.gitignore b/release/made_untracked/.gitignore
new file mode 100644 (file)
index 0000000..bea49c8
--- /dev/null
@@ -0,0 +1,3 @@
+
+*
+!/.gitignore
\ No newline at end of file