Schnellstart

Diese Anleitung führt neue Nutzer von der Installation bis zum geprüften Commit: einmal die Maschine einrichten, dann einmal das Projekt.

Voraussetzungen

• macOS oder Linux mit git und zsh oder bash.
• OpenSSL 3 für die Signaturprüfung der Erstinstallation (brew install openssl@3 auf macOS; das System-LibreSSL kann ed25519 nicht prüfen).
• Ein unterstützter Coding-Agent: Claude Code, oder Codex und OpenCode über die Runtime-Adapter.
• Zugang zum signierten Endpunkt oder ein lokaler Checkout.

1. Maschine einrichten

Installation vom signierten Endpunkt; weder Repository-Zugang noch SSH-Key sind nötig:

bash

curl -fsSL https://devkit.one-dot.io/install.sh | sh

Oder aus einem Checkout mit cargo run -p devkit -- install. In beiden Fällen installiert der Installer jq, verdrahtet den SessionStart-Hook und führt den ersten Sync aus; hängt er eine markierte export PATH=…-Zeile an deine Shell-Startdatei, öffne eine neue Shell.

Installation prüfen:

bash

devkit status   # Version, Quelle/Channel, Sync-Alter
devkit doctor   # Symlinks, persönliche Konfiguration, Tools

Der erste Sync installiert jedes Pflicht-Tool. Dazu gehören die Delegate-CLIs, die /share-Renderer, die pen-Design-Kette und der Schwachstellen-Scanner. Was jedes Werkzeug freischaltet und was es noch von dir braucht: Werkzeuge, die einen Schritt von dir brauchen.

Jedes Tool ist versions-gepinnt. devkit sync holt abgedriftete Tools jetzt selbst auf ihren Pin zurück, höchstens einmal in 24 Stunden; devkit tools --outdated zeigt sie, devkit tools --upgrade erzwingt den Lauf, und DEVKIT_TOOLS_AUTO_UPGRADE=0 schaltet den automatischen ab.

Ab jetzt aktiviert jeder Session-Start ein bereits geholtes Update und holt das nächste im Hintergrund. devkit off entfernt Runtime-Links und Hooks, behält aber Version und Config; devkit on stellt sie wieder her.

2. Projekt einrichten

Kürzester Weg: Starte claude im Projekt und tippe /index. Es zeigt, was devkit init ändern würde, wendet es nach einem Ja an und baut danach den Kontext; nach jedem devkit-Update einfach erneut.

Führe devkit init im Projektordner aus. Es führt dich durch: git init, falls der Ordner noch kein git hat, den Plan und eine Rückfrage, bevor sich etwas ändert, die Stack-Skills aus dem ONEDOT-Boilerplate und einen Commit der neuen Dateien. Danach claude starten und /index ausführen. Es baut .agents/context/ (STACK, CONVENTIONS, SUMMARY, STRUCTURE); committe es für das Team.

3. Einen grünen Commit machen

Beschreibe eine kleine Änderung. Der Agent arbeitet inline, prüft zuerst, ob vorhandener Code wiederverwendbar ist, und läuft dann durch diese Gates:

Skill	Gate
/test	Gezielte Tests; /test --full nur auf Anfrage oder wenn das Risiko es verlangt.
/review	Unabhängiges, nur lesendes Review des aktuellen Diffs.
/commit	Staged nur die Dateien dieser Session, scannt sie mit gitleaks und lehnt Agent-State-Pfade ab.

Das ist Tagesarbeit. Ist ein Rollback teuer oder gibt es noch keine deterministische Prüfung, beginne stattdessen mit /spec: Feature.

Wenn die Einrichtung scheitert

Erst devkit doctor, dann Troubleshooting.

Nächste Schritte

• Workflows
• So funktioniert es
• Skill-Übersicht