Kernkonzepte

Dropstone ist ein agentisches Codierungswerkzeug, das in Ihrem Terminal läuft. Es kann Code lesen, Befehle ausführen, Änderungen planen, Dateien bearbeiten und das Ergebnis verifizieren. Diese Seite behandelt die Kernideen, die Sie nur einmal lernen müssen: die Schleife, in der der Agent arbeitet, worauf er zugreifen kann, wie Sitzungen funktionieren, wie Kontext verwaltet wird und wie Berechtigungen Sie unter Kontrolle halten.

Die agentische Schleife

Wenn Sie Dropstone eine Aufgabe geben, arbeitet es in drei Phasen: Kontext sammeln, handeln und Ergebnisse verifizieren. Die Phasen gehen ineinander über. Dropstone nutzt durchgehend Tools, ob es Dateien liest, um Ihren Code zu verstehen, Änderungen vornimmt oder Tests ausführt, um seine Arbeit zu prüfen.

Die Schleife passt sich an das an, was Sie fragen. Eine Frage zu Ihrer Codebasis benötigt möglicherweise nur Kontextsammlung. Ein Bugfix durchläuft alle drei Phasen. Ein großes Refactoring kann umfangreiche Verifikation erfordern. Dropstone entscheidet, was jeder Schritt benötigt, basierend auf dem, was es aus dem vorherigen Schritt gelernt hat, und verknüpft Dutzende von Aktionen, wobei es unterwegs korrigiert.

Sie sind auch Teil dieser Schleife. Sie können jederzeit unterbrechen, um umzuleiten, Kontext hinzuzufügen oder einen anderen Ansatz zu verlangen. Dropstone arbeitet autonom, bleibt aber auf Ihre Eingaben reagierend.

Die agentische Schleife wird von zwei Komponenten angetrieben: dem Modell, das denkt, und den Tools, die handeln.

Modelle

Dropstone verwendet speziell entwickelte Codierungsmodelle. Es gibt drei Stufen, jede für eine andere Art von Arbeit optimiert:

Wechseln Sie die Stufen mit /effort low, /effort medium, /effort high oder /effort xhigh während einer Sitzung, oder mit Ctrl+T, um sie durchzuschalten. Wenn dieser Leitfaden sagt „Dropstone entscheidet" oder „Dropstone wählt", ist es das Modell, das denkt.

Tools

Tools sind das, was Dropstone agentisch macht. Ohne Tools kann das Modell nur Text erzeugen. Mit Tools kann es handeln: Ihren Code lesen, Dateien bearbeiten, Befehle ausführen, im Web suchen und mit externen Diensten interagieren. Jedes Tool-Ergebnis fließt zurück in die Schleife und informiert die nächste Entscheidung.

Die eingebauten Tools fallen in fünf Kategorien:

Dropstone wählt, welche Tools es verwendet, basierend auf Ihrer Eingabe und dem, was es unterwegs lernt. Wenn Sie sagen „behebe die fehlgeschlagenen Tests", könnte es:

1. Die Testsuite ausführen, um zu sehen, was fehlschlägt
2. Die Fehlerausgabe lesen
3. Nach den relevanten Quelldateien suchen
4. Diese Dateien lesen, um den Code zu verstehen
5. Sie bearbeiten, um das Problem zu beheben
6. Die Tests erneut ausführen, um zu verifizieren

Jede Tool-Nutzung liefert Informationen, die den nächsten Schritt informieren. Das ist die agentische Schleife in der Praxis.

Die eingebauten Tools sind die Grundlage. Sie können das Wissen von Dropstone mit Skills erweitern, mit MCP-Servern eine Verbindung zu externen Diensten herstellen und Arbeit an Subagenten delegieren. Für die vollständige Liste der eingebauten Tools siehe Eingebaute Tools.

Worauf Dropstone zugreifen kann

Wenn Sie dropstone in einem Verzeichnis ausführen, erhält der Agent Zugriff auf:

• Ihr Projekt. Dateien in Ihrem Arbeitsverzeichnis und Unterverzeichnissen, plus andere Dateien mit Ihrer Erlaubnis.
• Ihr Terminal. Jeden Befehl, den Sie selbst ausführen könnten: Build-Tools, Git, Paketmanager, Systemdienstprogramme, Skripte. Wenn Sie es von der Befehlszeile aus tun können, kann es Dropstone auch.
• Ihren Git-Status. Aktuellen Branch, unbestätigte Änderungen, gestaffte Dateien und die jüngste Commit-Historie.
• Ihre AGENTS.md. Eine Markdown-Datei im Repo-Root, in der Sie projektspezifische Konventionen, Build-Befehle, Stolperfallen und alles schreiben, was Dropstone in jeder Sitzung wissen sollte.
• Erweiterungen, die Sie konfigurieren. MCP-Server für externe Dienste, Skills für Workflows und Subagenten für delegierte Arbeit.

Da Dropstone Ihr gesamtes Projekt sieht, kann es darüber hinweg arbeiten. Wenn Sie es bitten, „den Authentifizierungs-Bug zu beheben", sucht es nach relevanten Dateien, liest mehrere, um den Kontext zu verstehen, nimmt koordinierte Änderungen über sie hinweg vor, führt Tests zur Verifikation aus und committet, wenn Sie es verlangen. Das unterscheidet sich von Inline-Code-Assistenten, die nur die aktuelle Datei sehen.

Sitzungen

Jede interaktive Sitzung wird lokal gespeichert. Jede Nachricht, jede Tool-Nutzung und jedes Ergebnis wird in einem Sitzungsprotokoll festgehalten, was es ermöglicht, vergangene Arbeit rückgängig zu machen, fortzusetzen und zu forken.

Sitzungen sind unabhängig. Eine neue Sitzung startet mit einem frischen Kontextfenster, ohne Erinnerung an frühere Gespräche. Dauerhaftes Wissen gehört in AGENTS.md, nicht in den Gesprächsverlauf.

Sitzungen fortsetzen oder forken

Das Fortsetzen mit dropstone --continue (oder dropstone -c) öffnet die letzte Sitzung im aktuellen Verzeichnis erneut und hängt neue Nachrichten an. Eine bestimmte Sitzung per ID fortzusetzen, verwendet dropstone --session <id>.

# Die letzte Sitzung in diesem Verzeichnis fortsetzen
dropstone -c

# Eine bestimmte Sitzung fortsetzen
dropstone --session 7f3a82b1

# Eine bestehende Sitzung in ein neues Gespräch forken
dropstone --session 7f3a82b1 --fork

Forken kopiert den Verlauf in eine neue Sitzungs-ID und lässt das Original unberührt. Nützlich, wenn Sie eine alternative Richtung erkunden möchten, ohne den ursprünglichen Faden zu verlieren.

Das Kontextfenster

Das Kontextfenster enthält Ihren Gesprächsverlauf, Dateiinhalte, Befehlsausgaben, AGENTS.md, geladene Skills und Systemanweisungen. Während Sie arbeiten, füllt sich das Fenster. Dropstone kompaktiert ältere Inhalte automatisch, aber Anweisungen aus dem frühen Gespräch können verloren gehen.

Ein paar Faustregeln:

• Legen Sie dauerhafte Regeln in AGENTS.md ab, nicht in Chat-Nachrichten. Die Chat-Nachrichtenversion wird kompaktiert; die AGENTS.md-Version wird in jeder Sitzung neu geladen.
• Skills laden bei Bedarf. Dropstone sieht Skill-Beschreibungen beim Sitzungsstart, lädt aber den vollständigen Inhalt nur, wenn ein Skill aufgerufen wird.
• Subagenten erhalten ihren eigenen frischen Kontext. Ihre Arbeit bläht das Hauptgespräch nicht auf; wenn sie fertig sind, geben sie eine Zusammenfassung zurück.

Sicherheit: Checkpoints und Berechtigungen

Dropstone hat zwei Sicherheitsmechanismen. Checkpoints ermöglichen es Ihnen, Änderungen des Agents rückgängig zu machen. Berechtigungen kontrollieren, was der Agent ohne Nachfrage tun kann.

Rückgängig machen mit Checkpoints

Jede Dateibearbeitung ist umkehrbar. Bevor Dropstone eine Datei bearbeitet, erstellt es einen Schnappschuss des aktuellen Inhalts. Wenn etwas schiefgeht, verwenden Sie /undo, um einen Bearbeitungszyklus nach dem anderen zurückzugehen, oder /redo, um einen rückgängig gemachten Schritt erneut auszuführen.

/undo            # den letzten Bearbeitungszyklus rückgängig machen
/redo            # den zuletzt rückgängig gemachten Schritt erneut ausführen

Checkpoints sind lokal für Ihre Sitzung, getrennt von Git. Sie decken nur Dateiänderungen ab. Aktionen, die entfernte Systeme berühren (Datenbanken, bereitgestellte Dienste, Netzwerk-APIs), können nicht checkpointiert werden, weshalb Dropstone vor der Ausführung von Befehlen mit externen Nebenwirkungen fragt.

Kontrollieren, was Dropstone tun kann

Dropstone fragt beim ersten Mal um Genehmigung, wenn es eine sensible Aktion ausführen möchte: eine Datei bearbeiten, einen Shell-Befehl ausführen, ins Netzwerk gehen. Einmal genehmigt, läuft dieselbe Operation ohne erneute Aufforderung für den Rest der Sitzung.

Verwenden Sie Tab, um während einer Sitzung zwischen zwei Betriebsmodi zu wechseln:

• Build-Modus. Der Standard. Dropstone kann Dateien bearbeiten und Befehle ausführen (vorbehaltlich Genehmigung). Verwenden Sie dies, wenn Sie die Änderung ausliefern möchten.
• Plan-Modus. Nur lesen. Dropstone kann die Codebasis untersuchen, Kontext sammeln und einen Plan erstellen, aber nichts bearbeiten oder ausführen. Verwenden Sie dies, wenn Sie das System studieren möchten, bevor Sie es ändern.

Um Befehle vorab zu genehmigen und die Aufforderung vollständig zu überspringen, listen Sie sie in der Berechtigungskonfiguration Ihres Projekts auf. Zum Beispiel:

{
  "permissions": {
    "allow": ["git status", "git diff", "npm test", "npm run lint"]
  }
}

Für organisationsweite Richtlinien, feinere Muster und wie die Geltungsbereichsauflösung funktioniert, siehe den Berechtigungsleitfaden.

Effektiv mit Dropstone arbeiten

Ein paar Muster, die tendenziell bessere Ergebnisse liefern.

Es ist ein Gespräch

Sie brauchen keinen perfekten ersten Prompt. Beginnen Sie mit dem, was Sie wollen, sehen Sie, was der Agent tut, und korrigieren Sie dann:

behebe den Login-Bug

nein, das Problem liegt in der Sitzungsverwaltung, nicht in der Formularvalidierung

Sie beginnen nicht von vorne. Sie iterieren. Jede Runde verfeinert das Verständnis des Agents.

Unterbrechen und steuern

Sie können Dropstone jederzeit umleiten:

• Drücken Sie Esc, um sofort zu stoppen. Der aktuelle Tool-Aufruf wird abgebrochen und Dropstone wartet auf Ihre nächste Anweisung.
• Geben Sie eine Korrektur ein und drücken Sie Enter, ohne zu warten. Dropstone liest sie, sobald die aktuelle Aktion abgeschlossen ist, und passt sich an, bevor es seinen nächsten Schritt entscheidet.

Seien Sie im Voraus spezifisch

Je präziser Ihr anfänglicher Prompt ist, desto weniger Korrekturen benötigen Sie. Verweisen Sie auf Dateien, erwähnen Sie Einschränkungen, zeigen Sie auf Beispielmuster:

der Checkout-Flow ist für Benutzer mit abgelaufenen Karten kaputt.
schau in src/payments/ nach dem Problem, besonders beim Token-Refresh.
schreibe zuerst einen fehlschlagenden Test, dann behebe ihn.

Vage Prompts funktionieren, aber Sie verbringen mehr Zeit mit Steuern. Spezifische Prompts wie der obige gelingen oft beim ersten Versuch.

Geben Sie Dropstone etwas zum Verifizieren

Der Agent arbeitet besser, wenn er seine eigene Arbeit prüfen kann. Fügen Sie Testfälle, erwartete Ausgaben oder Akzeptanzkriterien hinzu:

implementiere validateEmail. Testfälle:
  'user@example.com' -> true
  'invalid'           -> false
  'user@.com'         -> false
führe die Tests danach aus.

Erkunden, bevor Sie implementieren

Für komplexe Probleme trennen Sie Recherche vom Codieren. Wechseln Sie in den Plan-Modus (Tab), lassen Sie Dropstone den relevanten Code studieren, verfeinern Sie den Plan durch Gespräche, und wechseln Sie dann zurück in den Build-Modus, um auszuführen:

lies src/auth/ und erkläre, wie wir Sitzungen heute handhaben.
schlage dann einen Plan für die Hinzufügung von OAuth-Unterstützung vor.

Überprüfen Sie den Plan, widersprechen Sie allem, womit Sie nicht einverstanden sind, und lassen Sie Dropstone dann implementieren. Dieser Zwei-Phasen-Ansatz liefert konsistent bessere Ergebnisse, als direkt zum Code zu gehen.

Delegieren, nicht diktieren

Behandeln Sie Dropstone wie einen fähigen Kollegen. Geben Sie Kontext und Richtung, dann vertrauen Sie darauf, dass der Agent die Details herausfindet:

der Checkout-Flow ist für Benutzer mit abgelaufenen Karten kaputt.
der relevante Code ist in src/payments/.
untersuche und behebe es.

Sie müssen nicht angeben, welche Dateien zu lesen sind, welche Befehle auszuführen sind oder in welcher Reihenfolge. Dropstone findet das aus dem Prompt heraus.

Was als Nächstes