Glossar
Jeder OpenSpec-Begriff, eine Zeile pro Begriff.
OpenSpec verwendet Wörter, die in Git, CI und Agent-Tooling etwas anderes bedeuten. Jede Zeile gibt die OpenSpec-Bedeutung an. Die letzte Spalte verlinkt auf weitere Details, sofern verfügbar.
| Begriff | Definition | Mehr |
|---|---|---|
| Umsetzen | Die Aufgaben in einem Änderungsvorschlag implementieren. Skill: openspec-apply-change. | Change umsetzen |
| Archivieren | Einen Änderungsvorschlag abschließen: seine Deltas in die Haupt-Specs mergen und seinen Ordner nach openspec/changes/archive/ verschieben. | Quickstart |
| Artefakt | Ein Planungsdokument innerhalb eines Änderungsvorschlags: proposal.md, Delta-Specs, design.md, tasks.md. Kein Build-Output. | Artefakte |
| Fähigkeit | Ein Verhaltensbereich Ihres Systems. Jede hat einen Spec unter openspec/specs/<capability>/spec.md. | Fähigkeiten |
| Änderungsvorschlag | Eine Arbeitseinheit: ein Ordner unter openspec/changes/<name>/, der seine Planungsartefakte enthält. Oft kurz "Change". Kein Git-Commit. | Vorschlagen |
| Befehl | Ein eingetippter Einstiegspunkt für einen Workflow. Schreibweise variiert je nach Tool (/opsx:propose, /opsx-propose). Die Docs benennen Workflows stattdessen nach Skill. | Unterstützte Tools |
| Fortsetzen | Das nächste Planungsartefakt für einen bestehenden Änderungsvorschlag erstellen. Skill: openspec-continue-change. | Skills |
| Bereitstellung | Wie Workflows installiert werden: als Skills, Befehle oder beides. | Projekt einrichten |
| Delta-Spec | Ein Spec innerhalb eines Änderungsvorschlags, der nur auflistet, was sich ändert, unter den Überschriften ADDED, MODIFIED, REMOVED und RENAMED. | Delta-Specs |
| Erkunden | Eine Idee mit dem Agenten durchdenken, bevor ein Vorschlag erstellt wird. Schreibt keinen Code. Skill: openspec-explore. | Idee erkunden |
| Fast-Forward | Einen Änderungsvorschlag mit jedem Planungsartefakt in einem Durchgang erstellen, bereit zur Implementierung. Skill: openspec-ff-change. Kein Git-Fast-Forward. | Skills |
| Legacy-Workflow | Die /openspec:*-Befehle vor OPSX. | |
| Zyklus | Der Zyklus, den ein Änderungsvorschlag durchläuft: erkunden, vorschlagen, prüfen, umsetzen, archivieren. | Quickstart |
| Haupt-Specs | Der openspec/specs/-Baum: das aktuelle, abgestimmte Verhalten Ihres Systems. Beim Archivieren werden Deltas darin gemergt. Eine Fähigkeit ohne Spec erhält einen aus ihren ADDED-Anforderungen. | Archivieren |
| OpenSpec-Root | Der openspec/-Baum, auf den ein Befehl verweist und auf dem er operiert: das Ihres Repos oder das eines Stores. | Stores |
| OPSX | Das aktuelle OpenSpec-Workflow-System und das von ihm installierte Befehl-Präfix (/opsx:). | |
| Profil | Welche Workflows init installiert: core oder custom. | Profile |
| Vorschlagen | Einen Änderungsvorschlag erstellen und alle seine Planungsartefakte in einem Schritt generieren. Skill: openspec-propose. | Quickstart |
| Registry | Die systemweite Liste registrierter Stores in registry.yaml. Kein Paket-Registry. | CLI |
| Anforderung | Ein Verhalten, das das System haben muss, geschrieben mit SHALL: ### Requirement: in einem Spec. | Delta-Specs |
| Szenario | Ein testbares Beispiel unter einer Anforderung, in WHEN/THEN-Form. | Delta-Specs |
| Schema | Die Definition, welche Artefakte ein Änderungsvorschlag produziert und in welcher Reihenfolge. Kein JSON Schema. | Schemas |
| Skill | Die Anweisungen eines Workflows, installiert dort, wo Ihr KI-Tool sie liest (.agents/skills/, ...). | Skills |
| Spec | Eine Datei, die beschreibt, wie eine Fähigkeit sich heute verhält, unter openspec/specs/<capability>/spec.md. | Archivieren |
| spec-driven | Das Standard-Schema: Proposal, dann Delta-Specs, dann Design, dann Tasks. | spec-driven |
| Store | Ein eigenständiges OpenSpec-Repo, das auf Ihrem Rechner registriert ist, für Planung, die mehrere Repositories umfasst. Kein Datastore. | Stores (Beta) |
| Synchronisieren | Implementierte Deltas in die Haupt-Specs mergen, ohne zu archivieren. Skill: openspec-sync-specs. | Skills |
| Vorlage | Der Startinhalt, den ein Schema jedem Artefakt gibt. | Schemas |
| Aktualisieren | Als Skill (openspec-update-change): die Planungsartefakte eines Änderungsvorschlags überarbeiten. Als CLI-Befehl (openspec update): die installierten Dateien von OpenSpec aktualisieren. | Change aktualisieren, CLI |
| Verifizieren | Prüfen, ob die Implementierung mit den Artefakten eines Änderungsvorschlags übereinstimmt, bevor archiviert wird. Skill: openspec-verify-change. | Skills |
| Workflow | Eine benannte OpenSpec-Aktion (vorschlagen, umsetzen, archivieren, ...), installiert in Ihr KI-Tool als Skill oder Befehl. | Projekt einrichten |
| Workset | Eine persönliche, lokale Gruppe von Ordnern, die zusammen in einem Tool geöffnet werden. Kein Store, und nichts wird geteilt. | Worksets (Beta) |