README

Engineering Tools#

Zweck#

Dieses Repository ist die dauerhaft versionierte Quelle für engineering-tools. Die Nummern der Hauptverzeichnisse definieren die Navigationsreihenfolge und lassen durch Zehnerschritte spätere Ergänzungen zu.

Verantwortlichkeit#

Das Repository besitzt ausschließlich die Artefakte, für die sein fachlicher Scope verantwortlich ist. Inhalte anderer Ebenen werden referenziert, nicht dupliziert.

Kanonischer Einstieg#

Tool Scope
Tool Landscape
Tool Contract Model
Traceability
Danach die nummerierte Verzeichnisreihenfolge.

Repository Boundaries

Inhalt#

00-overview/ – Einstieg, Navigation und Abgrenzung der gemeinsamen Engineering-Werkzeuge.
10-bootstrap/ – Aufbau einer reproduzierbaren Engineering-Landschaft aus einer leeren Zielstruktur.
17-workbench-editors/ – Verträge und Sicherheitsgrenzen für interaktive Workbench- und Editor-Werkzeuge.
20-roundtrip/ – Import, Materialisierung, Validierung, , Packaging, Deployment und Recovery.
30-repository-management/ – Initialisierung, , Clone, Status, Synchronisation und Strukturverwaltung von Repositories.
40-validation/ – Struktur-, Manifest-, Link-, Modell-, Architektur- und Konsistenzprüfungen.
50-reporting/ – Generatoren für HTML-, Markdown-, Delta-, Status- und Qualitätsreports.
60-packaging/ – ZIP-Erzeugung, Dateilisten, Prüfsummen, Signaturen und Distributionspakete.
70-deployment/ – Kontrollierte Ausbringung von Paketen in Zielbereiche, insbesondere aus dem bestehenden Roundtrip nach ~/engineering.
80-migration/ – Kontrollierte Übernahme und Anpassung bestehender Artefakte aus der eingefrorenen Netzwerksolution.
90-cli/ – Gemeinsamer Kommandozeileneinstieg und stabile Befehlsoberflächen.
95-templates/ – Wiederverwendbare Repository-, Dokument-, Manifest- und Konfigurationsvorlagen.
96-scripts/ – Kleine, klar abgegrenzte Hilfsskripte, die keiner spezialisierten Werkzeugdomäne gehören.
97-documentation/ – Betriebs-, Nutzer- und Entwicklerdokumentation der Engineering-Werkzeuge.
98-tests/ – Automatisierte Tests der Werkzeuge, einschließlich sicherer Dry-Runs und Recovery-Szenarien.
99-examples/ – Kleine, nicht produktive Beispiele für Werkzeugnutzung und Integrationsabläufe.

Gehört ausdrücklich nicht hier hinein#

Laufzeitzustände, Logs, , Inbox/Outbox und generierte Arbeitsreports.
Ungeprüfte Inhalte, die fachlich einem anderen Repository gehören.
Direkte Kopien übergeordneter Modelle statt stabiler Referenzen.

Beziehungen#

Der Architecture Contract bestimmt Rangfolge und Geltung.
engineering-tools materialisiert, validiert und paketiert Inhalte.
runtime nimmt veränderliche Zustände und erzeugte Ausgaben auf.

Typischer Workflow#

Änderungen werden im zuständigen Hauptverzeichnis erarbeitet, validiert, dokumentiert und anschließend als nachvollziehbarer Git-Commit freigegeben.

Langfristige Entwicklung#

Die Struktur darf wachsen, aber Verantwortungsgrenzen und nummerierte Navigation bleiben stabil.

CLI Services#

Der kanonische Einstieg für Kommandozeilenoberflächen liegt unter 90-cli/README.md.

Generatoren#

Siehe 55-generators/README.md für deterministische Materialisierung und Vorlagenverträge.

Validatoren#

Der kanonische Einstieg für ausführbare Prüfungen und Quality-Auswertungen liegt unter 40-validation/README.md.

Documentation Tooling#

Der kanonische Einstieg für Dokumenterzeugung, Publishing, Navigation, Linkprüfung und dokumentationsbezogene liegt unter 97-documentation/README.md.

Repository-Klassifikation#

Primäre Klasse: Engineering Repository
Kanonischer Root-Einstieg: AI_STARTS_HERE.md
Maschinenlesbare Identität:
Validierungseinstieg: 40-validation/README.md

Verantwortung: Owns shared engineering tools, executable validation, packaging, deployment and supporting tool contracts.

Die Klassifikation richtet sich nach der kanonischen Repository-Verantwortung. Anforderungen anderer Repository-Klassen werden nicht implizit übernommen.