ET-OVR-TOOL-SCOPE-001

Engineering Tools Scope#

Im Scope#

engineering-tools verantwortet gemeinsame, wiederverwendbare Werkzeugmechanik für:

• Workbench-nahe Entwicklungswerkzeuge und Editoren,
• CLI-Dienste und stabile Befehlsoberflächen,
• Generatoren und Validatoren,
• Dokumentations- und Reporting-Werkzeuge,
• Repository Utilities,
• Developer Experience und Test Utilities,
• Bootstrap, Environment Management, Roundtrip, Packaging und kontrolliertes Deployment,
• Governance, Requirements und Verification dieser Werkzeuge.

Außerhalb des Scopes#

Nicht durch dieses Repository definiert werden:

• Enterprise- oder Solution-Architektur,
• fachliche Domänenmodelle der Plattform oder einzelner Building Blocks,
• Workspace-Verträge und Runtime-Topologien,
• produktive Laufzeitkonfigurationen, Secrets, Logs, Inbox/Outbox oder ⌘CacheEin Cache ist ein technischer Beschleunigungsmechanismus für Inhalte aus einer bestehenden Zustandsklasse. Er ist keine eigenständige fachliche Zustandsklasse und darf keine konkurrierende fachliche Wahrheit erzeugen.,
• zweite Kopien führender Contracts anderer Repositorys.

Solche Inhalte werden ausschließlich referenziert oder durch einen lokalen Werkzeugvertrag technisch spezialisiert.

Ownership-Regel#

Eine Aussage gehört nur dann nach engineering-tools, wenn ihr primärer Gegenstand die Funktionsweise, Bedienung, Sicherheit, Qualität oder Verifikation eines Engineering-Werkzeugs ist.

Beschreibt eine Aussage dagegen, was die Plattform fachlich sein muss, verbleibt sie bei der führenden Architektur oder dem zuständigen Produktrepository. Beschreibt sie, wie ein gemeinsames Werkzeug diese Vorgabe prüft, materialisiert oder paketiert, gehört die technische Spezialisierung hierher.

Änderungsregel#

Neue Werkzeugdomänen benötigen:

1. eine eindeutige Verantwortung,
2. dokumentierte Eingaben, Ausgaben und Seiteneffekte,
3. eine Position in der Tool Landscape,
4. Navigation aus einem bestehenden Einstieg,
5. Validierung und Tests,
6. Traceability zu den führenden Contracts.

Architekturwidersprüche werden als ⌘FindingTechnical documentation artifact. oder ADR-Vorschlag dokumentiert und nicht durch Implementierungsdetails entschieden.