system-onboarding · diff

v1.2.0 to v1.2.0

74 added, 58 removed. Audit A to A.

---

name: system-onboarding

version: 1.2.0

type: skill

author: ellmos contributors

created: 2026-05-16

updated: 2026-07-29

description: >

- Provider-neutral onboarding protocol for a new, rebuilt, or replacement workstation.

- It establishes the operating-system prerequisites, agent runtimes, shared rule

- surfaces, portable skills, verified configuration and post-install evidence without

- copying credentials, private prompts, or host-specific configuration into a repository.

+ Anbieterneutrales Onboarding-Protokoll für einen neuen, neu aufgesetzten

+ oder ausgetauschten Arbeitsplatzrechner. Es richtet

+ Betriebssystemvoraussetzungen, Agentenlaufzeiten, gemeinsame Regelflächen,

+ portable Skills, verifizierte Konfiguration und Nachweise nach der

+ Installation ein, ohne Zugangsdaten, private Prompts oder

+ host-spezifische Konfiguration in ein Repository zu kopieren.

standalone: true

anthropic_compatible: true

bach_compatible: true

bach_origin: false

category: infrastructure

tags: [onboarding, setup, agent-runtimes, windows, macos, verification, sync]

- language: en

+ language: de

status: active

visibility: public

dependencies:

tools: []

services: []

protocols: []

python: []

provenance:

origin: "custom"

origin_path: "internal onboarding protocol (sanitized for portable publication)"

origin_version: "1.2.0"

last_sync_from_origin: "2026-07-29"

last_sync_to_origin: null

local_changes_since_sync: false

---

- # System Onboarding

+ # System-Onboarding

- Use this protocol to establish a new or rebuilt workstation for local-first agent

- work. It is a sequencing and verification guide, not an installer and not a source

- of credentials. Resolve product-specific instructions from each provider's current

- documentation before changing a live system.

+ Nutze dieses Protokoll, um einen neuen oder neu aufgesetzten Arbeitsplatzrechner

+ für lokal-first Agentenarbeit einzurichten. Es ist eine Anleitung für Reihenfolge

+ und Verifikation, kein Installer und keine Quelle für Zugangsdaten. Ermittle

+ produktspezifische Anweisungen anhand der aktuellen Dokumentation des jeweiligen

+ Anbieters, bevor du ein Live-System änderst.

- ## Activation

+ ## Aktivierung

- Use for a new workstation, a reinstalled operating system, a replacement device, or

- a controlled recovery of one agent runtime. First identify the operating system,

- target runtime, owner, shared rule surface, and whether the request is a full rebuild

- or a bounded component repair. Do not assume that a configuration copied from one

- host is safe or supported on another.

+ Verwende den Skill für einen neuen Arbeitsplatzrechner, ein neu installiertes

+ Betriebssystem, ein Ersatzgerät oder die kontrollierte Wiederherstellung einer

+ einzelnen Agentenlaufzeit. Ermittle zuerst Betriebssystem, Ziellaufzeit,

+ zuständige Person, gemeinsame Regelfläche und ob ein vollständiger Neuaufbau

+ oder eine begrenzte Komponentenreparatur gewünscht ist. Unterstelle nicht, dass

+ eine von einem Host kopierte Konfiguration auf einem anderen sicher oder

+ unterstützt ist.

- ## Ordered workflow

+ ## Geordneter Arbeitsablauf

- 1. Establish operating-system updates, Git, authenticated source control, Python and

- the current supported Node.js LTS where needed.

- 2. Install only the requested agent runtimes through their supported installers and

- complete their native login flows without placing tokens in project files.

- 3. Create local configuration roots and load an explicitly selected, canonical rule

- surface. Merge templates; never overwrite existing local state blindly.

- 4. Install portable skills and MCP or plugin configuration only through their stated

- deployment procedures. Treat each provider's configuration format as distinct.

- 5. Configure shared synchronization only after the local runtime works. Share

- sanitized contracts and receipts, not credentials, full prompts, or machine-local

- paths.

- 6. Recreate a scheduler or automation only through its supported native surface.

- Preserve prior state and leave new work disabled until its owner approves activation.

- 7. Run the appropriate post-install checks and write a local receipt that distinguishes

- installation, configuration, scheduler registration and successful outcome.

+ 1. Richte Betriebssystemupdates, Git, authentifizierte Quellcodeverwaltung,

+ Python und bei Bedarf die aktuell unterstützte Node.js-LTS-Version ein.

+ 2. Installiere nur die angeforderten Agentenlaufzeiten über deren unterstützte

+ Installer. Schließe die nativen Anmeldeabläufe ab, ohne Token in

+ Projektdateien abzulegen.

+ 3. Erstelle lokale Konfigurationswurzeln und lade eine ausdrücklich ausgewählte,

+ kanonische Regelfläche. Führe Vorlagen zusammen; überschreibe vorhandenen

+ lokalen Zustand niemals blind.

+ 4. Installiere portable Skills sowie MCP- oder Plugin-Konfiguration nur über die

+ jeweils dokumentierten Bereitstellungsverfahren. Behandle die

+ Konfigurationsformate der Anbieter als voneinander verschieden.

+ 5. Richte gemeinsame Synchronisierung erst ein, nachdem die lokale Laufzeit

+ funktioniert. Teile bereinigte Verträge und Belege, nicht Zugangsdaten,

+ vollständige Prompts oder maschinenlokale Pfade.

+ 6. Stelle Scheduler oder Automationen nur über deren unterstützte native

+ Oberfläche wieder her. Bewahre den vorherigen Zustand und lasse neue

+ Aufgaben deaktiviert, bis die zuständige Person die Aktivierung freigibt.

+ 7. Führe die passenden Prüfungen nach der Installation aus und schreibe einen

+ lokalen Beleg, der Installation, Konfiguration, Scheduler-Registrierung und

+ erfolgreiches Ergebnis unterscheidet.

- Read only the matching reference for the target platform:

+ Lies nur die zum Zielsystem passende Referenz:

- - [overview](references/overview.md) for boundaries and data placement;

- - [Windows checklist](references/windows-checklist.md) for Windows;

- - [macOS checklist](references/mac-checklist.md) for macOS; and

- - [post-install](references/post-install.md) for verification and recovery.

+ - [Übersicht](references/overview.md) für Grenzen und Datenablage;

+ - [Windows-Checkliste](references/windows-checklist.md) für Windows;

+ - [macOS-Checkliste](references/mac-checklist.md) für macOS; und

+ - [Prüfung nach der Installation](references/post-install.md) für Verifikation

+ und Wiederherstellung.

- ## Boundaries

+ ## Grenzen

- - Never publish credentials, recovery codes, private prompts, account identifiers, or

- raw logs to a shared repository or synchronization folder.

- - Keep virtual environments, dependency caches and large runtime artifacts out of

- cloud-synchronized project folders.

- - Do not make a copied configuration authoritative. The target host must discover and

- read back its own supported state.

- - Do not register a schedule merely because a task file exists. Native registration

- and outcome evidence are separate requirements.

- - When an existing host is being repaired, inventory its current state and locks before

- changing any configuration.

+ - Veröffentliche niemals Zugangsdaten, Wiederherstellungscodes, private Prompts,

+ Kontokennungen oder Rohprotokolle in einem gemeinsamen Repository oder

+ Synchronisationsordner.

+ - Halte virtuelle Umgebungen, Abhängigkeits-Caches und große

+ Laufzeitartefakte aus cloud-synchronisierten Projektordnern heraus.

+ - Erkläre eine kopierte Konfiguration nicht zur maßgeblichen Quelle. Der

+ Zielhost muss seinen eigenen unterstützten Zustand ermitteln und per Readback

+ bestätigen.

+ - Registriere einen Zeitplan nicht allein deshalb, weil eine Aufgabendatei

+ existiert. Native Registrierung und Ergebnisnachweis sind getrennte

+ Anforderungen.

+ - Inventarisiere bei der Reparatur eines bestehenden Hosts dessen aktuellen

+ Zustand und Sperren, bevor du Konfiguration änderst.

- ## Completion evidence

+ ## Abschlussnachweis

- A complete onboarding receipt records the target operating system, selected runtimes,

- their verified versions, the canonical rule references loaded, the explicit skills or

- extensions deployed, unsupported capabilities, and any deferred user decisions. A

- successful command exit alone is not evidence that an application loaded its new

- configuration or that a scheduled task achieved its intended outcome.

+ Ein vollständiger Onboarding-Beleg hält Zielbetriebssystem, ausgewählte

+ Laufzeiten, verifizierte Versionen, geladene kanonische Regelreferenzen,

+ ausdrücklich bereitgestellte Skills oder Erweiterungen, nicht unterstützte

+ Fähigkeiten und aufgeschobene Nutzerentscheidungen fest. Ein erfolgreicher

+ Befehlsabschluss allein belegt weder, dass eine Anwendung ihre neue

+ Konfiguration geladen hat, noch dass eine geplante Aufgabe ihr beabsichtigtes

+ Ergebnis erreicht hat.

- ## Changelog

+ ## Änderungsprotokoll

### 1.2.0 (2026-07-29)

- - Ported the reusable onboarding sequence and platform references into the public

- skills catalog after removing host-specific paths, account details and private

- operational material.

+ - Die wiederverwendbare Onboarding-Reihenfolge und Plattformreferenzen nach

+ Entfernung host-spezifischer Pfade, Kontodetails und privaten

+ Betriebsmaterials in den öffentlichen Skill-Katalog portiert.