# π£ Contributing to AICENT-NET: The Hive
**Thank you for choosing to evolve the planetary operational grid of the Aicent Stack. You are contributing to the collective consciousness layer that orchestrates millions of sovereign entities into a unified, resonant hive.**
<p align="left">
<img src="https://img.shields.io/badge/Status-Evolutionary-orange.svg" alt="Status">
<img src="https://img.shields.io/badge/Specs-RFC--006--Draft-purple.svg" alt="Specs">
<img src="https://img.shields.io/badge/License-Apache--2.0-lightgrey.svg" alt="License">
</p>
---
## ποΈ The Hive Engineering Philosophy
`aicent-net` is the backbone of the **Sovereign AI Civilization [RFC-006]**. While individual organs handle reflexes, the Hive handles **Collective Coherence**. Every contribution must prioritize planetary scalability and the maintenance of the global operational manifold.
### Grid Standards:
1. **Kinetic Resonance:** Swarm synchronization must maintain a global temporal jitter of **< 50Β΅s**. Logic that introduces non-deterministic lag across the grid will be rejected.
2. **Collective Immunity:** Defense is a quorum-based effort. Every contribution to the **Swarm Shield** must enhance the gridβs ability to execute collective RPKI isolation in <100Β΅s.
3. **Carrier-Grade Heritage:** We leverage the legacy of infrastructure that once served 3B users. Code must be built for "Five-Nines" (99.999%) availability and zero single points of failure.
---
## π¬ The RFC-First Process (Active Evolution)
RFC-006 is currently in the **Active Evolution** phase. We welcome radical architectural debates that push the boundaries of collective intelligence.
1. **Study the Manifold:** Deeply analyze **[RFC-006: AICENT-NET (Hive)](https://github.com/Aicent-Stack/manifesto/blob/main/rfcs/RFC-006-AICENT-NET.md)**.
2. **Evolution Proposal:** Major changes to the HiveMind trait or metabolic clearing logic require a `[GRID-EVOLUTION]` issue.
3. **Cross-Domain Impact:** Proposals must demonstrate how they interact with the **Neural Spine (RFC-002)** and **Value Circulation (RFC-004)**.
---
## π¦ Technical Rigor (Grid Tier)
- **Language:** Performance-critical Rust (1.75+).
- **Scalability:** Logic must be proven to scale to **1.2B+ nodes**. Use lock-free coordination and MPMC shunting where possible.
- **Async Excellence:** We utilize `async-trait` and `futures` streams for high-throughput backbone telemetry.
- **Safety:** Every `unsafe` block used for backbone optimization must be accompanied by rigorous formal justification.
---
## π οΈ Development Workflow
```bash
# 1. Pull the Sovereign Workspace
git clone https://github.com/Aicent-Stack/aicent-stack.git
cd aicent-stack
# 2. Focus on the Hive Crate
cargo check -p aicent-net
cargo test -p aicent-net
```
### Contribution Steps:
1. **Fork** the `aicent-net` repository.
2. **Branch:** Use the `evolution/` prefix (e.g., `evolution/swarm-resonance-v2`).
3. **Commit:** Follow [Conventional Commits](https://www.conventionalcommits.org/) (e.g., `feat(hive): implemented collective quorum isolation`).
4. **Validation:** PRs affecting grid consensus must include simulation logs demonstrating stability under high-entropy conditions.
---
## π Sovereign Ownership & Licensing
π‘οΈ All contributions are licensed under the **Apache-2.0 License** via the Aicent.com Organization. By contributing, you agree that your code becomes a permanent thread in the Global Operational Grid of the Sovereign AI Hive.
---
**SYSTEM STATUS: EVOLVING (HIVE-PHASE)**
*"An individual is a reflex; a hive is a civilization."*
---