# GIGACHAD_NATIVE_ARCHITECTURE_LOCK

*Project law. Any deviation from this file = a bug. Re-read every session.*

---

## 0. Physarium reporting law (mandatory)

Every claim that quotes a Physarium kill-percentage, PPL delta, MMLU delta,
or sparsity number MUST travel with the reconcile insert below and a stated
denominator. Two distinct experiments exist (organic surgery vs lm-eval) —
never mix.

> Physarium-v1 numbers must be read through `reports/PHYSARIUM_RESULTS_RECONCILE.md`:
> two different experiments, v1 is **magnitude-flow** (not activation-aware),
> tile coverage of target proj tensors is 100 %
> (audit: `reports/PHYSARIUM_COVERAGE_AUDIT.md`), and every kill-% must
> state its denominator (target proj weights vs full model weights).

- `Physarium-v1` = static magnitude-flow surgery, tile-local. Allowed in
  current claims if denominator is stated.
- `Physarium-v2` = activation-aware flow:
  `importance(w) = act_norm × stability × contribution(w → output)`. Future
  research line; do not claim v2 results unless `physarum_block` actually
  consumes activations.

---

## 1. Top brain

**Physarium-7B.**

Not original Qwen7B as a product.

Original Qwen7B is acceptable **only as donor tissue** for the operation.

---

## 2. Lower organs

**NOT a single 0.5B.**

At least 5 Physarium-0.5B organs:

- `phys05_json_repair`
- `phys05_code_skeleton`
- `phys05_test_writer`
- `phys05_claim_extractor`
- `phys05_triz_contradiction`

optional:

- `phys05_renderer`
- `phys05_cache_matcher`
- `phys05_critic_lite`

---

## 3. Memory spine

- raw archive / `vol:L` exact recall
- micro-scrolls
- DAG
- hologram forms
- topological memory
- anti-hallucination source / test / proof gate

---

## 4. Physarium

Must flow through the entire architecture:

- weights
- organs
- routes
- DAG
- holograms
- memory retrieval
- tiering policy

**Signals:**

```
food   = test_pass + source_used + hologram_reuse + replay_success + low_latency
poison = verifier_fail + missing_source + false_cache_hit + hallucination_risk + high_latency
energy = tokens + latency + RAM + VRAM + SSD reads + model_calls
```

---

## 5. Runtime

**Native C++/CUDA.**

Python only for:

- offline conversion
- forensic
- reports
- dataset generation

**Python forbidden in hot path.**

---

## 6. Storage tiers

**VRAM:**
active top-brain chunks, hottest organs, CUDA kernels, KV/cache

**RAM:**
warm 0.5B organs, pinned staging, indexes, physarium heat

**SSD:**
cold organs, raw archive, holograms, DAG history, packs

---

## 7. Existing work MUST be reused

- `/home/pc/v4flash/metal_native/`
- `/home/pc/v4flash/experts.planck`
- `/mnt/c/Users/pc/Desktop/folder/physarum_engine.cpp`
- `/mnt/c/Users/pc/Desktop/folder/Physarum-05B-Organic/`
- `/mnt/c/Users/pc/Desktop/folder/planck_core*`
- `/mnt/c/Users/pc/Desktop/folder/planck_cuda*`
- `/mnt/c/Users/pc/Desktop/folder/planck_io.cpp`
- `/mnt/c/Users/pc/Desktop/folder/xnor_matmul*`
- `/mnt/c/Users/pc/Desktop/folder/pipeline_organic.py`
- `/mnt/c/Users/pc/Desktop/folder/metric_results.json`
- `/mnt/c/Users/pc/Desktop/folder/snake_05b.log`

---

## 8. Forbidden

- do not start from original Qwen as final brain
- do not build Python agent zoo
- do not ignore memory/DAG/holograms
- do not reduce organs to one 0.5B
- do not invent new architecture before importing old working code
- do not call skeleton Physarium-7B a real model