Glossar

Das SHAPE Framework. Ein Arbeitsmodell für spezifikationsgetriebenes, von Menschen geführtes, agentisches Product Engineering in der Softwareentwicklung von Unternehmen. Es verbindet Organisation, technischen Unternehmensrahmen und einen spezifikationsgetriebenen Entwicklungsprozess bis zum UAT.

Spec-driven / spezifikationsgetrieben. Ein Ansatz, bei dem beabsichtigtes Produktverhalten in gepflegten, versionierten Spezifikationen erfasst wird, die Implementierung und unabhängige Verifikation leiten.

Human-led / menschlich geführt. Menschliche Rollen bleiben für geschäftliche Absicht, Architekturentscheidungen, Qualitätsbewertung und Abnahme verantwortlich, auch wenn Coding-Agenten wesentliche Implementierungsarbeit übernehmen.

Agentisch. Eine Arbeitsweise, in der KI-Agenten unter menschlicher Führung und Unternehmensbeschränkungen mehrstufige Entwicklungs- oder Verifikationsaufgaben mit autorisierten Werkzeugen und Kontext ausführen.

Product Engineer (PE). Die zentrale menschliche Rolle, die Discovery, Spezifikationen, KI-gestützte Implementierung, Validierung und fortlaufende Verantwortung für ein begrenztes Produktportfolio verbindet.

Pod. Eine kleine produktorientierte Arbeitseinheit, geleitet von einem Product Engineer und unterstützt durch gemeinsame Architektur- und UX-Expertise.

Architekt / Senior Engineer. Der gemeinsam eingesetzte technische Spezialist wirkt an der technischen Grundlagenarbeit in Phase 2 mit, definiert und prüft Architekturgrenzen, unterstützt wichtige Entscheidungen und Ausnahmen über den Lebenszyklus und betreut Unternehmensbausteine für ein begrenztes Portfolio. Der Product Engineer verantwortet Implementierung und Wartung innerhalb dieser Grenzen.

UX-Designer. Der gemeinsam eingesetzte Spezialist, der die Richtung von Interaktion und Benutzererfahrung gestaltet und die funktionierende Software während ihrer Weiterentwicklung bewertet.

Fachlicher Stakeholder / Kunde. Eine Person, die Bedürfnisse, Geschäftsregeln oder Abnahme des Produkts vertritt. „Kunde“ muss keinen externen kommerziellen Auftraggeber bezeichnen.

Coding-Agent. Ein KI-System, das berechtigt ist, Software und zugehörige Artefakte innerhalb einer freigegebenen Arbeitsumgebung zu erstellen oder zu ändern.

Verifikationsagent / unabhängiger Verifikationskontext. Ein KI-gestützter Prüfprozess, der vom Implementierungskontext getrennt ist und Tests aus eingecheckten Spezifikationen ableiten soll, statt lediglich die Annahmen des Implementierers zu wiederholen.

Spezifikationsbestand. Die aktuelle Sammlung gepflegter Funktionsspezifikationen, die das beabsichtigte Produktverhalten definiert.

Funktionsspezifikation. Eine abgegrenzte, dauerhafte Beschreibung von erwartetem Verhalten, Akteuren, Regeln, Ausnahmen und überprüfbaren Akzeptanzbedingungen.

Akzeptanzbedingung. Eine beobachtbare Aussage, anhand derer beurteilt werden kann, ob spezifiziertes Verhalten geliefert wurde.

Dauerhafte Anweisungen. Beständige Regeln und Kontext, die einem Agenten vermitteln, wie er arbeiten soll und welche Projekt- oder Unternehmensbeschränkungen gelten; sie unterscheiden sich von einzelnen Funktionsanforderungen.

AGENTS.md. Der auffindbare zentrale Anweisungseinstieg im Stammverzeichnis nach der SHAPE-Repository-Konvention, der Agenten auf alle Markdown-Dateien in agent_instructions/ verweist.

agent_instructions/. Ein erweiterbares Verzeichnis für selbsterklärende, projektrelevante Markdown-Dokumente mit Anweisungen und Kontext. Das Framework schreibt darin keine bestimmten Dateinamen vor.

specifications/. Ein gesonderter Bereich für Produktspezifikationen statt dauerhafter Agentenanweisungen.

Unternehmensbausteine. Freigegebene, wiederverwendbare Fähigkeiten einer Organisation wie Plattformen, Bibliotheken, Architekturkonventionen, gemeinsame Komponenten, Sicherheitsmechanismen und dokumentierte Anleitungen.

Freigegebene Ausführungsumgebung. Die technische Umgebung, in der ein Agent unter technisch durchgesetzten Zugriffs-, Werkzeug-, Daten- und Berechtigungsgrenzen gemäß Unternehmensrichtlinien arbeitet.

Technische Grundlagenarbeit. Angemessene Vorbereitung in Zyklus 1 Phase 2: freigegebene Stack- und Wiederverwendungsentscheidungen, Architekturgrenzen, stimmige Anweisungen und technisch durchgesetzte Berechtigungen. Sie läuft parallel zu UX-Ausrichtung und Spezifikationserstellung. SHAPE fügt keine gesonderte verpflichtende Bereitschaftsfreigabe hinzu; die beiden geplanten Implementierungsprüfungen finden in Phase 4 und 7 statt.

Zyklus 1. Der achtphasige Erstentwicklungsprozess: Discovery; parallele UX-Ausrichtung, technische Grundlagenarbeit und Spezifikationserstellung; Implementierung; erste Architektenprüfung; Stakeholder-Iteration; unabhängige Verifikation; abschließende Architektenprüfung; UAT.

Zyklus 2. Der vierphasige Erweiterungsprozess: Spezifikations- und Implementierungsänderung; unabhängige Verifikation; richtlinien- oder risikobasierte Architektenprüfung; UAT.

Spezifikationsbasiertes Testen. Unabhängige Verifikation, die Prüfungen aus dem eingecheckten Spezifikationsbestand ableitet, die Implementierung nach Möglichkeit ausführt und die entstehenden Nachweise sowie offene Einschränkungen dokumentiert.

Architektenfreigabe. Das Ergebnis einer technischen Prüfung gemäß Unternehmensrichtlinien; sie entspricht nicht der fachlichen Abnahme durch Stakeholder.

UAT (User Acceptance Testing / Benutzerakzeptanztest). Der autorisierte fachliche Prozess einer Organisation zur Beurteilung, ob ein Produkt oder eine Änderung den beabsichtigten Bedarf erfüllt.

Begrenztes Produktportfolio. Die Menge an Anwendungen, die ein Product Engineer dauerhaft verantworten kann, einschließlich Zeit für fortlaufende Änderungen, Wartung und aktuelle Projekte.

Übernahme gemeinsamer Bausteine. Der geprüfte Prozess, ein nützliches lokales Muster oder eine Komponente in organisationsweit wiederverwendbare Materialien zu übernehmen.

Menschen äußern Absicht, prüfen funktionierendes Verhalten und nehmen das Produkt ab. Agenten pflegen Implementierung und dauerhaften Sollverhaltenskontext in Iterationen; es gibt keine universelle menschliche Dokumentfreigabe. Ein gesonderter Prüfer vergleicht Absicht und echte Anwendung. Eine konsolidierte Master-Spezifikation bleibt offene Erkundung statt Pflichtartefakt.

Der Spezifikationslebenszyklus: specifications/requests/ enthält menschlich verfasste, noch umzusetzende Anfragen; specifications/archive/ bewahrt umgesetzte menschliche Anfragen als historische Aufzeichnungen; specifications/current/ enthält agentengepflegte Beschreibungen des aktuell erforderlichen Produktverhaltens. Umgesetzte Anfragen unverändert archivieren und aktuelle Spezifikationen pflegen. Direkte Prompts und Gespräche können Entwicklung ohne formale Spezifikationsdatei beauftragen; der aktuelle Stand wird unabhängig vom Anfrageformat dokumentiert.

Die Begriffe werden hier für eine einheitliche Verwendung definiert. Ihre jeweiligen Konzeptseiten erklären die Hintergründe; die Praxisleitfäden beschreiben konkrete Maßnahmen. Nutzen Sie gegebenenfalls die verlinkte Rollen-, Prozess- oder Artefaktseite für weitere Einzelheiten.