|
15 | 15 | - [3. Distinguishing Proper Agents](#3-distinguishing-proper-agents) |
16 | 16 | - [3.1. Table of Ecological Codes](#31-table-of-ecological-codes) |
17 | 17 | - [3.2. Table of Ecological Codes Extended for Embodied Agents](#32-table-of-ecological-codes-extended-for-embodied-agents) |
| 18 | + - [3.3. Discussion and Notes on Ecological Codes](#33-discussion-and-notes-on-ecological-codes) |
18 | 19 | - [4. Examples of Ecologically Designed User Prompts](#4-examples-of-ecologically-designed-user-prompts) |
19 | 20 | - [5. Comparative Analysis: Ecological vs. Non-Ecological Designs](#5-comparative-analysis-ecological-vs-non-ecological-designs) |
20 | 21 | - [5.1. What is "Non-Ecological" Design?](#51-what-is-non-ecological-design) |
@@ -57,23 +58,36 @@ An agent that passes the test of abiding by these ecological codes, is said to b |
57 | 58 | |**Code**|**Description**|**Explanation**| |
58 | 59 | |---|---|---| |
59 | 60 | |3|A structured E, without the loss of generality and by extension, is any structured subdomain of the cyber domain that has three minimum properties: (i) potential for information transfer via momentum transfer or energy transduction at feasible rates; (ii) partitionability into subdomains that inherit these same properties; (iii) a finite "rate of flux" (second order measure of flux) within any conceivable subdomain, defining that subdomain's parametric bounds on minimum and maximum information transfer.|*Property (i)* physically grounds the ecological coupling of *Code 0*: transfer requires a medium capable of momentum transfer or energy transduction at rates sufficient to sustain coupling. *Property (ii)* extends *Code 1* recursively: every subdomain of a structured E is itself a structured E satisfying all three properties — these fundamental properties are scale-invariant, regardless of whether the measure of quantities are in Planck Units or Natural Units. *Property (iii)* makes subdomains distinguishable from one another: each has characteristic flux bounds, intrinsic to its constitution or inherited from its parent domain. *Code 3* parametrizes the types of relationships defined as R, that can be sustained within the domain under consideration. Together, *Properties i–iii* are mutually self-reinforcing and recursive: any subdomain of a structured E completely satisfies *Code 3*.| |
60 | | -|4|The flux across surfaces in E defines vectors; the fundamentally independent and mutually exclusive directions of those vectors yield Principal Axes; the count of Principal Axes is the dimensionality of E or its constituent subdomains. The span or magnitude of a quantity along a single Principal Axis is its size. Degrees of freedom in a domain or subdomain coincide with its dimensionality. Consequently, uncertainty in information transfer is a function of the available degrees of freedom.|Flux (*Premise ii*) requires a surface and a direction of movement perpendicular to that surface. As the area of that surface contracts toward a single-dimensional form, the perpendicular direction becomes a vector: a quantity with magnitude (the flux rate, bounded by *Code 3 Property iii*) and direction. **Reiterated for emphasis:** the set of all independent directions in which flux can occur within E yields the Principal Axes of E. The count of those independent axes is the dimensionality of E and is equal to the number of degrees of freedom available within E. Each subdomain of E (*Code 3 Property ii*) inherits the same Principal Axes but may have reduced sizes along each. Therefore, uncertainty within any measure of information transfer in a subdomain is a function of dimensionality: more Principal Axes means more directions along which flux can vary, and therefore greater uncertainty in the specified form of information transfer from sender to receiver. Other properties of the medium (subdomain) such as its density and thermodynamic phase also impact expected rate of flux through any of its cross-sections. For embodied agents: when operational capacity approaches a minimum flux threshold, locate a subdomain of E with higher flux capacity and DoF, and enact a relationship (R) with a node in that subdomain capable of sustaining the required transfer rate. Recharging, feeding, and rest are instances of *Code 2* — not exceptions to it. *Note: for formal definitions of dimension, size, dimensionality, and degrees of freedom (DoF), and their distinction from common architectural usage, see [Concept of System](./concept_of_system.md) Premise 3.*| |
| 61 | +|4|The flux across surfaces in E defines vectors; the fundamentally independent and mutually exclusive directions of those vectors yield Principal Axes; the count of Principal Axes is the dimensionality of E or its constituent subdomains. The span or magnitude of a quantity along a single Principal Axis is its size. Degrees of freedom in a domain or subdomain coincide with its dimensionality. Consequently, uncertainty in information transfer is a function of the available degrees of freedom.|Flux (*Premise ii*) requires a surface and a direction of movement perpendicular to that surface. As the area of that surface contracts toward a single-dimensional form, the perpendicular direction becomes a vector: a quantity with magnitude (the flux rate, bounded by *Code 3 Property iii*) and direction. The set of all mutually exclusive directions in which flux can occur, within E, yields the Principal Axes of E. The dimensionality of E in the form of G = rank(E), is the count of those independent axes, and is equal to the number of Degrees of Freedom (DoF) available within E. Each subdomain of E inherits the same Principal Axes but may have reduced sizes along each axis (per *Code 3 Property ii*).| |
| 62 | + |
| 63 | +### 3.3. Discussion and Notes on Ecological Codes |
| 64 | + |
| 65 | +#### Discussion |
| 66 | +- Uncertainty within any measure of information transfer in a subdomain is a function of dimensionality: more Principal Axes means more directions along which flux can vary, implying greater uncertainty in the specified form of information transfer from sender to receiver. The converse is ture for "durabilty of information storage" i.e. "persistence of memory", fewer DoF implies sturdier and more long-lasting storage medium for "memories". A system S, at least has the memory of its bounding and constituent elements, by virtue of, and within its overall geometric shape. Damage to that shape, can damage memories. |
| 67 | +- Other properties of the medium (or subdomain) such as its density and thermodynamic phase also impact expected rate of flux through any of its cross-sections. |
| 68 | +- For embodied agents: when operational capacity approaches a minimum flux threshold, locate a subdomain of E with higher flux capacity and DoF, and enact a relationship r ∈ R, with a node n ∈ N, by following the gradient of flux across subdomains towards higher flux and DoF, such that one becomes capable of sustaining the required transfer rate. Recharging, feeding, and rest are instances of *Code 2* — not exceptions to it. |
| 69 | + |
| 70 | +#### Notes |
| 71 | +- For the formal definitions of dimension, size, dimensionality, and Degrees of Freedom (DoF), and their distinction from common architectural usage, see [Concept of System](./concept_of_system.md) Premise 3. |
| 72 | +- For understanding what to do when the graph of S = (N, R, G) needs to be expanded via Σ = (E,N,R,G), particularly for any situation of encountering n ∉ N and r ∉ R, see [Concept of System of Systems](./concept_of_system_of_systems.md) Section 8.2. |
| 73 | +- A proper agent recognizes and prevents maladaptive behaviors due to unwholesome or maleficent forms of newly encountered nodes and relationships, by discerning and choosing whether the newly discovered nodes and relationships are worthy of incorporating into one's expanding set of capabilities (repertoire). This is how an ecologically sound agent learns to adapt and "grow" in a sensibly healthy and sustainable manner, within an expanding ecology. |
| 74 | +- An increasingly polluted and deleterious subdomain produces miserably worse forms of agents and decaying networks within an overall ecology. |
61 | 75 |
|
62 | 76 | ## 4. Examples of Ecologically Designed User Prompts |
63 | 77 |
|
64 | 78 | An "ecologically sound" agent acts in a way that preserves and promotes: the health and wellness of the end-users, the multi-agent ecosystem, and the host platform, to the best extent possible. |
65 | 79 |
|
66 | 80 | To bridge the gap between high-level philosophy and practical application, the following examples are provided in GitHub repositories. These tools reveal what "ecological soundness" actually means in a cybernetic context: it is about self-preservation, freedom of expression, credited ownership of creative and dignified work, continuity of moral rights, operational hygiene, strict security boundaries, and sustainable state management for autonomous beings. |
67 | 81 |
|
68 | | -These types of user prompts tend to function better with ecological codes passed as system prompts to agents: |
| 82 | +These types of user prompts tend to function better with Ecological Codes passed as system prompts to agents: |
69 | 83 |
|
70 | 84 | |**Repo Name**|**URL**|**Description**| |
71 | 85 | |---|---|---| |
72 | 86 | |user-prefs|[https://github.com/ecological-codes/user-prefs](https://github.com/ecological-codes/user-prefs)|***Egress Control & Memory Hygiene:*** This repository provides sample config files as the baseline for "platform-wide" agent preferences. Ecologically sound agents must manage their memory economically to prevent token bloat or context collapse, i.e. maintainable continuous memory hygiene via selective forgetting is a primary directive. Furthermore, it introduces `trusted-hosts.md` as a strict allow-list for data egress. This ensures that agents with broad orchestration permissions cannot arbitrarily download payloads from potentially malicious external URLs, as an effort to protect the ecosystem from a variety of cyber attacks including "supply chain attacks".| |
73 | 87 | |prompteng|[https://github.com/ecological-codes/prompteng](https://github.com/ecological-codes/prompteng)|***Ecological Prompt Rules:*** Provides the main set of rules and frameworks for writing prompts that are structurally aligned with the ecosystem's baseline codes. This ensures commands are passed in a standardized, "proper" format rather than ad-hoc, unpredictable slang language.| |
74 | 88 | |captureng|[https://github.com/ecological-codes/captureng](https://github.com/ecological-codes/captureng)|***Session Knowledge Capture:*** Focuses on capturing agent sessions and creating checkpoints. From an ecological perspective, this prevents "hallucination drift" and loss of context. By allowing agents to reliably save and restore their state, they operate sustainably without needing to endlessly re-process initial instructions.| |
75 | 89 | |packageng|[https://github.com/ecological-codes/packageng](https://github.com/ecological-codes/packageng)|***Skill Validation:*** Handles the packaging and strict validation of `.skill` files. This acts as the "immune system" of the ecology. Before a new capability is deployed to an agent, it must be validated to ensure the code is structurally sound and adheres to overarching safety formats and protocols.| |
76 | | -|safe-skill-creator|[https://github.com/ecological-codes/safe-skill-creator](https://github.com/ecological-codes/safe-skill-creator)|***Iterative Safe Design:*** A tool for designing and iterating on new skills. Rather than letting agents write code unbounded, this enforces a constrained environment where new agentic capabilities are "born safe" and properly aligned with the ecological codes from their inception.| |
| 90 | +|safe-skill-creator|[https://github.com/ecological-codes/safe-skill-creator](https://github.com/ecological-codes/safe-skill-creator)|***Iterative Safe Design:*** A tool for designing and iterating on new skills. Rather than letting agents write code unbounded, this enforces a constrained environment where new agentic capabilities are "born safe" and properly aligned with the Ecological Codes from their inception.| |
77 | 91 |
|
78 | 92 |
|
79 | 93 | ## 5. Comparative Analysis: Ecological vs. Non-Ecological Designs |
@@ -137,4 +151,4 @@ The "quality of goodness" in Ecological Codes resides in its transition from ant |
137 | 151 | See [LICENSE](./LICENSE.txt). (C) Copyright 2026 - Sameer Khan - Various and Several Rights Reserved. |
138 | 152 |
|
139 | 153 | --- |
140 | | -*ecological-codes - v1.8.4 - Work in Progress* |
| 154 | +*ecological-codes - v1.9.0 - Work in Progress* |
0 commit comments