Change-Driven Development nach OpenSpec-Vorbild.

Nutze die an OpenSpec angelehnte Projektvorlage Change-Driven in Manager und ändere bestehenden Code Vorschlag für Vorschlag, mit Delta-Specs, die in lebende Spezifikationen im Wiki einfließen.

Warum OpenSpec in Manager?

Gemacht für bestehenden Code

Ein Change Proposal beschreibt nur den Unterschied, du musst also nie erst das ganze System spezifizieren.

Änderungen als Delta

Jeder Vorschlag listet, was hinzukommt, sich ändert, wegfällt oder umbenannt wird. Diese Liste ist der Vertrag für die Umsetzung.

Spezifikationen, die stimmen

Beim Archivieren fließt das Delta in die Spec-Seiten ein. So beschreibt das Wiki das System, wie es heute läuft.

So funktioniert OpenSpec.

OpenSpec gibt Coding-Agenten eine Spezifikation statt Chatverlauf: Du einigst dich darauf, was gebaut wird, bevor Code entsteht. Die Methode ist für bestehende Codebasen gemacht, und jeder Schritt läuft, wann immer er gebraucht wird.

Specs liegen in openspec/specs/, ein Ordner pro Fähigkeit. Jede Änderung bekommt einen Ordner in openspec/changes/ mit proposal.md, design.md, tasks.md und Delta-Specs. /opsx:explore denkt sie durch, /opsx:propose schreibt sie, /opsx:apply baut sie, und /opsx:archive übernimmt die Deltas in die Specs.

  1. Explore
  2. Propose
  3. Apply
  4. Archive

Angelehnt an OpenSpec, MIT © 2024 OpenSpec Contributors (github.com/Fission-AI/OpenSpec). Nicht mit OpenSpec verbunden oder von OpenSpec empfohlen.

OpenSpec in Manager.

Wo jedes Artefakt und jeder Befehl von OpenSpec in deinem Projekt liegt.

OpenSpecIn Manager
openspec/specs/Spec-Seiten in einem Specs-Ordner im Wiki, mit Revisionshistorie.
Change-OrdnerEin Change Proposal; das Feld Change Slug hält den Kebab-Case-Namen.
proposal.mdDie Beschreibung des Change Proposals: warum und was.
Delta Spec, design.mdMit dem Proposal verknüpfte Wiki-Seiten; das Delta listet ADDED-, MODIFIED-, REMOVED- und RENAMED-Anforderungen.
tasks.mdAufgaben vom Typ Task unter dem Change Proposal.
/opsx:*-BefehleDie Skills explore, propose, apply, sync und archive, gespiegelt in den Status des Proposals.
changes/archive/Der Status „Archiviert“; der gespeicherte Filter „Changes“ listet jedes Proposal.

Der Workflow.

  1. Das Projekt anlegen

    Verbinde deinen Agenten über MCP und lass ihn ein Projekt aus der Vorlage Change-Driven anlegen. Lass das Wiki an: Dort landen deine lebenden Spezifikationen.

    Sag deinem AgentenManager: Leg für diese Codebasis ein Projekt aus der Vorlage Change-Driven an.

  2. Eine kleine, echte Änderung erkunden

    Du musst die Codebasis nicht erst spezifizieren. Der Skill explore liest Code und vorhandene Spec-Seiten und wägt mit dir Optionen ab. Steht der Weg schon fest, überspring ihn.

    Sag deinem AgentenManager: Lass uns meine nächste Änderung mit dem Skill explore durchdenken, und frag mich zuerst, worum es geht.

  3. Vorschlagen und prüfen

    Der Skill propose legt das Change Proposal an, schreibt Delta und Design ins Wiki und legt die Aufgaben an. Lies das Delta, bevor Code entsteht.

    Sag deinem AgentenManager: Führ den Skill propose für diese Änderung aus.

  4. Umsetzen

    Der Skill apply arbeitet die Aufgaben streng nach dem Delta ab. Braucht der Code eine andere Spezifikation, wird zuerst das Delta angepasst.

    Sag deinem AgentenManager: Führ den Skill apply für dieses Change Proposal aus.

  5. In die Spezifikation archivieren

    Sind alle Aufgaben erledigt, übernimmt der Skill archive das Delta in die Spec-Seiten und setzt das Proposal auf „Archiviert“. Mit dem optionalen Skill sync übernimmst du es schon vorher.

    Sag deinem AgentenManager: Führ den Skill archive für dieses Change Proposal aus, sobald alle Aufgaben erledigt sind.

Was die Vorlage anlegt.

Ein Projekt aus der Vorlage Change-Driven startet mit diesen Aufgabentypen und Status. Anpassen kannst du alles später an dein Team.

Change Proposal

Ein Änderungsvorschlag mit Delta-Spec gegenüber den lebenden Spezifikationen.

  1. Erkundung
  2. Vorschlag
  3. Anwendung
  4. Abgleich
  5. Archiviert

Task

Eine Arbeitseinheit, die einen Teil einer Änderung umsetzt.

  1. Zu erledigen
  2. In Arbeit
  3. Erledigt

Skills

Diese Skills bringt die Vorlage in Manager mit:

  • explore

    Denkt eine Änderung an Code und Specs durch, ohne Code zu schreiben.

  • propose

    Legt Proposal, Delta-Spec, Design und Aufgaben an.

  • apply

    Setzt die Aufgaben streng nach der Delta-Spec um.

  • sync

    Optional: übernimmt das Delta in die Specs, ohne die Änderung abzuschließen.

  • archive

    Übernimmt das Delta in die Specs und setzt das Proposal auf „Archiviert“.

Gut zu wissen.

Das Wiki einschalten

Lebende Spezifikationen sind Wiki-Seiten, also schalte das Wiki-Feature ein. Ohne Wiki halten die Skills Deltas als Kommentare am Change Proposal fest.

Unterschiede zu OpenSpec

Specs sind Wiki-Seiten statt Dateien im Repository, Änderungen sind Aufgaben auf dem Board. Die Skills decken die Kernbefehle ab, von explore bis archive.

Wann Change-Driven passt

Nimm Change-Driven für Änderungen an bestehenden Systemen. Spec-Driven passt zu Arbeit in Releases und Phasen, Test-Driven zu testgetriebenen Features, Governed Spec zu Features, die eine Verfassung einhalten müssen.

Eine Änderung nach der anderen und eine Spezifi­kation, die stimmt.

Proposals, Deltas und lebende Spezifikationen liegen in einem Projekt. So kann dein Team prüfen, was der Agent ändern wird und was er geändert hat.

Vorabzugang anfragen