Die technische Grundlage gehört zum Framework
Das SHAPE Framework definiert mehr als Lieferrollen und Prüfschritte. Sein Engineering-Modell beruht auf auffindbaren Anweisungen, dauerhaftem Produktwissen, freigegebenen Unternehmensfähigkeiten und durchsetzbaren Ausführungsgrenzen. Coding-Agenten müssen erkennen können, welche Regeln gelten, wo Produktverhalten beschrieben wird und welche technischen Entscheidungen feststehen.
SHAPE bietet eine kleine Repository-Konvention zur Agentenorientierung und für dauerhafte Anweisungen; Unternehmen wählen ihre Stacks, Designsysteme, Sicherheitsmechanismen und Projektdateien selbst. Agenten brauchen genug dauerhafte Orientierung für autonomes Arbeiten, ohne die begrenzenden Standards selbst umschreiben zu dürfen.
Beginnen Sie mit dem Repository-Modell, dem echten Website-Repository und den kommentierten Direktiven. Die Website-Anweisungsbeispiele unterscheiden Projektentscheidungen von Framework-Prinzipien. Die bestehende Abbildung bleibt unverändert und kann eine frühere Konvention darstellen; der Begleittext erklärt die aktuelle Praxis.
Drei Arten von Informationen
Agentenanweisungen und Projektkontext legen fest, wie ein Agent arbeiten soll, welche Beschränkungen gelten, welchen Zielen das Produkt dient und welche Architekturentscheidungen bereits getroffen wurden. Diese Anweisungen können in eigenständigen, selbsterklärenden Markdown-Dokumenten organisiert werden.
Funktionsspezifikationen beschreiben das beabsichtigte Produktverhalten. Sie werden als versionierte Artefakte gepflegt und entwickeln sich weiter, wenn sich das vereinbarte Verhalten ändert. Spezifikationen beantworten, was geschehen soll, einschließlich Geschäftsregeln, Ausnahmen und Akzeptanzbedingungen.
Unternehmensbausteine liefern freigegebene und wiederverwendbare Implementierungsfähigkeiten. Dazu können ausgewählte Stacks, Dienste, gemeinsame Bibliotheken, Identitäts- und Sicherheitsmechanismen, Designsysteme, Komponenten, Engineering-Konventionen und wiederverwendbare Muster gehören. Verantwortung und Änderungen dieser gemeinsamen Materialien werden projektübergreifend geregelt.
Standardkonventionen für Projekte
Das SHAPE Framework empfiehlt ein einfaches und erweiterbares Modell zum Auffinden von Projektanweisungen. Eine AGENTS.md im Stammverzeichnis weist Coding-Agenten an, alle Markdown-Dateien in agent_instructions/ zu lesen und einzuhalten. Jede Datei nennt ihren Zweck in der ersten Zeile oder Überschrift. Projekte können eigene Dateien hinzufügen, statt auf ein zentral gepflegtes Register verpflichtender Dateinamen angewiesen zu sein.
Funktionsspezifikationen verbleiben in einem gesonderten Bereich specifications/. Sie sind keine dauerhaften Arbeitsanweisungen: Jede beschreibt Produktverhalten, das die Implementierung liefern und die Verifikation bewerten muss.
Verantwortung von Organisation und Projekt
Die Organisation pflegt Standards und freigegebene wiederverwendbare Bausteine. Ein Projekt liefert seine eigenen Ziele, geltenden Anweisungen, akzeptierte Architektur und Funktionsspezifikationen. Der genaue Dokumentenmix kann sich zwischen einer kleinen Workflow-Anwendung und einem komplexen Integrationsprodukt unterscheiden; die grundlegenden Kategorien sollten jedoch klar bleiben.
Dokumentation und Implementierung müssen übereinstimmen
Wenn sich das akzeptierte Produktverhalten ändert, sollten sich die Spezifikationen ändern. Wenn sich eine formal freigegebene Architekturentscheidung ändert, sollte sich ihre Dokumentation ändern. Wenn sich eine wiederverwendbare Unternehmenskomponente ändert, sollten ihre Anleitungen korrekt bleiben. Widersprüchliche Dokumentation schafft Unsicherheit für Menschen und Agenten.
Wo Kontrollen durchsetzbar werden
Eine Textanweisung, nicht auf eine Datenbank zuzugreifen, verhindert den Zugriff nicht. Die tatsächlichen Möglichkeiten zum Lesen von Daten, Ausführen von Befehlen, Installieren von Software oder Verbinden mit Diensten müssen durch die freigegebene Ausführungsumgebung begrenzt werden. Das Framework betrachtet auffindbare Anweisungen und technische Berechtigungen als Ergänzungen mit unterschiedlichen Aufgaben.
Die Artefakte im Detail
Lesen Sie Spezifikationen zum Produktverhalten, Agentenanweisungen zum Modell dauerhafter Anweisungen, Unternehmensbausteine & Wiederverwendung zu organisationsweiten Fähigkeiten und Ausführungsgrenzen für Agenten zu durchgesetzten Berechtigungen.