🧠⛓️ A-TownChain OS / KAI-OS — Offizielle Dokumentation

🤖 Für KI-Agenten — Pflichtlektüre vor jeder Änderung

1. docs/AGENT_POLICY.md — verbindliche Regeln, Reality-Check, Konsolidierungsziel
2. docs/AGENT_COORDINATION.md — wer arbeitet gerade woran, Agent-IDs
3. docs/DECISIONS_REGISTER.md — verbindliche Architektur-Entscheidungen

Dezentrales, KI-gesteuertes Blockchain-Betriebssystem A-TownChain OS (technisch) · KAI-OS (Produktname)

Dies ist der kanonische Dokumentations-Hub des A-TownChain-Ökosystems.

Version: 1.0.0 | Stand: 03.09.2026 | Lizenz: Apache-2.0 Autor: Michael Wroblewski | Agent: Aurora (Base44 Superagent)

---

Architektur-Policy v1.0

• 🔴 ATCLang First — Kern-Logik in ATCLang (ATC-99)
• 🔴 SHA-256 — TX-Hashing (AD-001 RESOLVED)
• 🔴 Chain-ID 658467 — Apache-2.0e Non-EVM Chain-ID, ASCII 'ATC' (AD-004 RESOLVED)
• 🔴 Dual-Repo-Modell — Code in a-townchain-os, Doku hier (Mandat AGENT_POLICY/AD-89)

Metriken (Stand 03.09.2026)

Metrik	Wert
Repositories	128 total — 2 aktiv, 126 archiviert (Konsolidierung Sept 2026)
Hub-Dateien	1.700+ (kanonische Doku + Archive)
ATC-Standards	ATC-01…35 (5 Tiers, Tier 5 aktiv) + ATC-97 (AIP-Entwurf) + ATC-99 (ATCLang First)
ShivaCore Rust-Kernel	K29 abgeschlossen — 30 Module, 367/367 Tests grün
Monorepo	2.237 Dateien, 60 Module, VERSION 1.0.0, 0 Audit-Fehler
Interne Links	873 geprüft, 0 kaputt
Mainnet-Launch	per AD-023 kein Termin (qualitaetsgetrieben)

K-Sprint-Status

Phase	Status
K3–K29 — ShivaCore Rust-Kernel	✅ ABGESCHLOSSEN (367 Tests)
Konsolidierung 128→2	✅ ABGESCHLOSSEN (Migration, Datenverlust-Check, Archivierung)
K30 — Validator-Nodes (#70)	🔵 AUSSTEHEND
K31 — Genesis Block (#71)	🔵 AUSSTEHEND
#69 — Security (Dependabot 70 Vulns)	🔴 OFFEN — vor K30 priorisiert
K32 — Pre-Launch Verify · K33 — External Audit	🟡 GEPLANT

Quick Links

• Roadmap | Status | TODO | Changelog
• Standards Registry | KAI-OS Wiki
• Launch-Checkliste & Roadmap | Whitepaper
• Compliance (BaFin) | Lizenz-Übersicht
• Agent Master Rules | ATCLang First Policy

Hub-Struktur

docs/
├── standards/       # ATC-01…35 + ATC-LIC/ATS-LIC (kanonisch)
├── wiki/            # KI-OS Wiki-Struktur (Kapitel je Modul)
├── whitepaper/      # Whitepaper + Einzelkapitel
├── compliance/      # BaFin-Konformität, Richtlinien
├── project/         # Master-Component-Plan, Launch-Checkliste
├── issues/ sprints/ # Issue- und Sprint-Dokumentation
├── archive/
│   ├── wiki/        # 65 Modul-Wikis ( verschmolzen, mit Index)
│   └── kai-os-legacy/
└── monorepo-legacy/ # Historische Monorepo-Docs (eingefroren)

Repository-Struktur (Dual-Repo-Modell)

a-townchain-os/        # Code-Monorepo: 60 Module, ShivaCore K29, VERSION 1.0.0
a-townchain-os-docs/  # Doku-Hub (dieses Repo): Standards, Wiki, Whitepaper, Archive

---

A-TownChain OS / KAI-OS · v1.0.0 · Non-EVM · SHA-256 · Chain-ID 658467 · ATCLang First

Lizenzmodell

A-TownChain etabliert ein monetarisiertes, autonomes Open-Source-Ökosystem.

"Code is Law" auf Lizenzebene: Unlizenzierter Code wird von der ATVM physisch gar nicht erst ausgeführt.

• ATC-LIC — Smart Contract Lizenzen mit automatischer Royalty-Durchsetzung
• ATS-LIC — System & Hardware Lizenzen mit TPM-Verifikation
• Compliance-Handbuch — BaFin-konforme Dokumentation

→ Lizenz-Übersicht | ATC-LIC | ATS-LIC | Compliance-Handbuch

Copyright (c) 2026 Michael Wroblewski / ShivaCore / A-TownChain-Okosystems. Apache-2.0.

Verwandte Vision-Projekte

• atc-genesis-engine — Vision-/Konzept-Modul für eine potenzielle zukünftige Game-Engine (Genesis Engine) und deren Ausbaustufen. Reines Konzeptmaterial, kein aktueller Teil der A-TownChain-Kernentwicklung.

---

Last Updated: 2026-09-03 by Aurora (Base44 Superagent)

---

ATC Compliance & Governance (ATC-STD-201 / 202 / 203)

ATC COMPLIANCE: R3 — auditiert am 2026-09-07 (atc-repo-audit; R-Level aus .atc/repository.yaml). Architekturentscheidungen: zentral im DECISIONS_REGISTER (AD-Nummern verbindlich; lokale Entscheidungen in docs/decisions/).

• Purpose: Dokumentations-Hub des Oekosystems (parallel zu L0-L7).
• Scope: Layer parallel, Domain documentation — a-townchain-os-docs als SPEC in der 23-Repo-Landschaft (AD-024/026).
• Architecture: DECISIONS_REGISTER (AD-001…), Roadmaps (M1-M8, AD-027), Audits, Projekt-Doku; Standards: kanonisch im atc-standards-Repo (AD-030), Hub docs/standards = Archiv-Snapshot.
• Features: Wiki, Whitepaper, Compliance-Handbuch, BaFin-Bericht, REPOSITORY_MAP.
• Installation: Modul-Build je Sprache (markdown); Integration via Monorepo-Workspace (a-townchain-os, sync_modules.py).
• Development: Conventional Commits; Governance-Regeln aus atc-standards; Naming gemaess ATC-STD-000 §7.
• Testing: Interne Link-Audits (873+94 Links geprueft, 0 kaputt); Governance-CI.
• Security: SECURITY.md; S-Klasse S3; ATC-STD-203 Release-Gates; Emergency-Prozess ATC-STD-000 §32.
• Roadmap: Einordnung in die Lauffaehigkeits-Roadmap M1-M8 (AD-027) und Bauhierarchie L0-L7 (AD-026).
• Version: CHANGELOG.md; SemVer; Releases als ATC-REL-X.Y.Z.
• License: Apache-2.0 — Apache-2.0, Michael Wroblewski / ShivaCore / A-TownChain-Okosystems (ATC-LIC/ATS-LIC).