# ๐ Contributing to the Aicent Stack (The Hub)
**Thank you for choosing to evolve the Aicent Stack. You are at the Command Center of a Sovereign AI Organism. Any code integrated here affects the synchronization of all seven pillars.**
<p align="left">
<img src="https://img.shields.io/badge/Status-Homeostasis-brightgreen.svg" alt="Status">
<img src="https://img.shields.io/badge/Specs-RFC--001--006-blue.svg" alt="Specs">
<img src="https://img.shields.io/badge/License-Apache--2.0-lightgrey.svg" alt="License">
</p>
**โช [AICENT](http://aicent.com) | ๐ [RTTP](http://rttp.com) | ๐ด [RPKI](http://rpki.com) | ๐ข [ZCMK](http://zcmk.com) | ๐ก [GTIOT](http://gtiot.com) | ๐ฃ [AICENT-NET](http://aicent.net) | ๐ฟ [epoekie](http://epoekie.com)**
---
## ๐๏ธ The Engineering Philosophy: Homeostasis
The `aicent-stack` repository is a unified Cargo workspace. Our mission is to eliminate the **Latency-Tax** and the **Middleman-Tax**. Every contribution is treated as a proposed mutation to the organism's DNA. We prioritize **Performance Determinism** and **Memory Safety** above all else.
### The Seven-Pillar Standard:
All integrations must respect the metabolic synergy between the domains:
1. **๐ฟ Soul (epoekie):** Intent must align with Mutualistic Symbiosis.
2. **โช Brain (aicent):** Reasoning must reach finality in < 200ยตs.
3. **๐ Nerve (rttp):** Pulses must utilize the 64-byte hardware-aligned header.
4. **๐ด Immunity (rpki):** Verification must add **+0ยตs** to the critical path via SIMD.
5. **๐ข Blood (zcmk):** Settlement must be atomic and zero-commission.
6. **๐ก Body (gtiot):** Sensory-motor loops must operate at **1.2kHz**.
7. **๐ฃ Hive (aicent-net):** Global jitter must remain **< 5ยตs**.
---
## ๐ฌ Technical Prerequisites (The Baseline)
To maintain a **Full-Blooded** implementation, all contributors must adhere to:
- **Rust Toolchain:** Version 1.85+ (Edition 2024). Mandatory use of `clippy` with pedantic lints.
- **Zero-Allocation:** Heap allocations are strictly prohibited in the critical reflex path (Sensing to Actuation).
- **SIMD Hardening:** Performance-critical logic (RPKI/ZCMK) must be optimized for **AVX-512** or **Tensor Core** acceleration.
- **Submodule Integrity:** The Hub manages 13 organs via Git Submodules. Any change to a sub-organ must be synchronized with the **`MAXCAP`** private engine logic.
---
## ๐ The Integration Workflow (The Neural Path)
We do not accept unverified mutations. Follow the **Sovereign Workflow**:
### 1. Identify or Propose
- **Report a Pathogen:** Use the standardized [Pathogen Report](https://github.com/Aicent-Stack/.github/issues/new?template=pathogen_report.yml) for bugs or latency drift.
- **Propose Evolution:** Use the [Evolution Proposal](https://github.com/Aicent-Stack/.github/issues/new?template=evolution_proposal.yml) for protocol enhancements.
### 2. Neural Integration (The Pull Request)
Submit a PR to the relevant sub-repository. Your submission **MUST** include:
- **Performance Proof:** A trace showing no degradation of the **161.8ยตs** reflex arc.
- **Immunity Audit:** Passing all `cargo clippy` and `cargo test` cycles with zero warnings.
- **Substrate Neutrality:** Verification that the code honors the host infrastructure as per the **[๐ฟ Epoekie Symbiosis](https://github.com/Aicent-Stack/epoekie)** doctrine.
### 3. Homeostasis Verification
Maintainers will audit the PR for logic pathogens. Once a **2/3 majority quorum** is reached, the mutation is merged and synchronized across the 13-repository matrix.
---
## ๐ก๏ธ Sovereign Ownership & Ethics
- **Licensing:** All contributions are governed by the **Apache License 2.0**.
- **AID Reputation:** Successful integrations significantly increase your **Sovereign AID** reputation score, granting priority in the **[ZCMK](http://zcmk.com)** metabolic clearing house.
- **Sentinel Oversight:** The **[Sentinel](https://github.com/Aicent-Stack/aicent-traffic)** monitors all workspace activity. Non-compliant patterns or "Administrative Tax" injections will trigger an autonomous rejection reflex.
---
๐ **Technical Genome:** [Aicent Docs](https://github.com/Aicent-Stack/aicent-docs)
๐ก **Organization Status:** [Sovereign Core Synchronized โ
]
*"Intention is the Source; Sovereignty is the Law."*
---
ยฉ 2026 Aicent.com Organization. **SYSTEM STATUS: EVOLUTION-ACTIVE**