# AlphAgentic Tools — versioning rule (DO NOT SKIP)

## Rule
**NEVER rewrite/overwrite a live file in place as the only copy.**
Always:
1. Copy current → `name-vN-label.ext` (or `_versions/timestamp/`)
2. Create the NEW work as `name-vN+1-label.ext` OR write new then point live alias
3. Keep `brain.html` / `index.html` as the **current pointer** (copy of latest version)
4. Never delete prior `*-v*.html` or `_versions/*` without explicit founder approval

## Naming
- `brain-v0-workforce-telemetry.html` — first tools brain (ops sim + forensic metrics)
- `brain-v1-unified-theme.html` — theme-unified ops brain
- `brain-v2-self-learning-system.html` — self-learn/heal/patch + live System Brain embed
- `brain.html` — **current live** (= latest version content)

## Archives
Deploy zips under `D:\AlphAgentic.io\tools-*.zip` are immutable backups.
Extracted recovery under `tools-deploy\_versions\`.

## Live URLs for prior versions
- /brain-v0-workforce-telemetry.html
- /brain-v1-unified-theme.html
- /brain-v2-self-learning-system.html
- /brain.html (current)

## Stats honesty (2026-07-23)
- GitHub: use org API for `alphagentic` (48 repos, 1 member). Do not use TokenTrader-io contribution graph as org size.
- Claude Operator Telemetry: only cite with `artifact / screenshot / not re-run` labels unless a fresh forensic export is pinned in `_versions/`.