# 🧠 Contributing to AICENT: The Brain
**Thank you for choosing to evolve the cognitive center of the Aicent Stack. You are contributing to the master orchestration layer that defines sovereign identity and intent.**
<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--Standard-white.svg" alt="Specs">
<img src="https://img.shields.io/badge/License-Apache--2.0-lightgrey.svg" alt="License">
</p>
---
## 🏛️ The Aicent Cognitive Philosophy
`aicent` is not a collection of scripts; it is the **Cognitive Hub [RFC-001]**. Every contribution must enhance the organism’s ability to decompose complex intent into atomic primitives with zero-latency overhead. We prioritize **deterministic reasoning** and **evolutionary stability**.
### Cognitive Standards:
1. **AID Sovereignty:** Identity resolution must never rely on centralized authorities.
2. **Instruction Sharding:** Intents must be decomposed into RTTP-ready primitives without creating cognitive bottlenecks.
3. **Homeostatic Feedback:** The brain must optimize its scheduling based on the real-time health (RPKI) and cost (ZCMK) metrics of the GTIOT body.
---
## 🔬 The RFC-First Process
Cognitive evolution is governed by rigorous protocol standards. We do not accept arbitrary logic changes.
1. **Audit the Spec:** Deeply study **[RFC-001: AICENT (Brain)](https://github.com/Aicent-Stack/manifesto/blob/main/rfcs/RFC-001-AICENT-BRAIN.md)**.
2. **Evolution Proposal:** Major changes to the scheduler or AID framework require an `[EVOLUTION-PROPOSAL]` issue.
3. **Interface Parity:** Ensure your changes maintain compatibility with the **Neural Spine (RFC-002)** and **Hive Grid (RFC-006)**.
---
## 🦀 Engineering Rigor (Brain Tier)
- **Language:** High-performance Rust (1.75+).
- **Safety:** AICENT enforces `#![deny(unsafe_code)]`. Memory safety is the baseline for sovereignty.
- **Asynchrony:** We utilize `async-trait` and `tokio` for non-blocking orchestration.
- **Telemetry:** Logic must be observable via `tracing` for high-fidelity cognitive auditing.
---
## 🛠️ 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 Brain Crate
cargo check -p aicent
cargo test -p aicent
```
### Contribution Steps:
1. **Fork** the `aicent` repository under the Aicent-Stack organization.
2. **Branch:** Use the `evolution/` prefix (e.g., `evolution/aid-resolver-opt`).
3. **Commit:** Use [Conventional Commits](https://www.conventionalcommits.org/) (e.g., `feat(brain): optimized sharding logic`).
4. **Pull Request:** All PRs must pass the **Organism Vitality & Protocol Audit** CI.
---
## 📜 Sovereign Ownership & Licensing
🛡️ All contributions are licensed under the **Apache-2.0 License** via the Aicent.com Organization. By contributing, you agree that your work becomes an inseparable cognitive faculty of the Sovereign AI Organism.
---
**SYSTEM STATUS: HOMEOTASIS**
*"Cognition is the bridge between intent and reality."*
---