Eine echte Implementierung, geprüft am 15.10.2026
Dieses Repository baut diese Website. Es zeigt ausgewählte SHAPE-Praktiken; eine funktionierende Anwendung validiert nicht jede Framework-Variante. Das kuratierte Pfadinventar wurde im Arbeitsbaum geprüft. Weitere verschachtelte Dateien, generierte Abhängigkeiten und Build-Ausgaben sind bewusst ausgelassen; es ist kein vollständiger Verzeichnisabzug. Zugangsdaten und private Dateien sind nicht enthalten.
shape/
├── AGENTS.md
├── agent_instructions/
│ ├── SHAPE.md
│ ├── STACK.md
│ ├── ARCHITECTURE.md
│ ├── DESIGN.md
│ └── OBJECTIVES.md
├── specifications/
│ ├── requests/
│ ├── archive/
│ └── current/
├── app/
│ ├── (english)/
│ ├── (german)/de/
│ └── (spanish)/es/
├── application/
├── domain/
├── infrastructure/
├── components/
├── styles/
├── i18n/
├── scripts/
├── tests/
│ ├── unit/
│ └── e2e/
├── public/
├── resources/
├── diagrams/
├── docs/
├── server.js
├── next.config.mjs
├── package.json
└── pnpm-lock.yaml
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.
Echte Anweisungen statt konzeptionellem Minimum
Das echte zentrale AGENTS.md enthält neben Orientierung detaillierte Projektregeln und ist umfangreicher als das Minimalmodell. Es wurde nicht für das Beispiel umgeschrieben. Siehe Wurzeldatei-Rundgang.
In agent_instructions/ liegen tatsächlich SHAPE.md (Agenten-Grundprinzipien), STACK.md (freigegebene Technologien), ARCHITECTURE.md (Internationalisierung und Schichtgrenzen), DESIGN.md (weite Gestaltungsrichtung) und OBJECTIVES.md (ausdrücklich nicht verbindlicher Geschäftskontext). Das Kernbeispiel und der Dateirundgang geben Quellen wieder und erklären sie in Reihenfolge. Diese Namen sind das Projektinventar, keine universelle Liste; LIBRARIES.md existiert hier nicht.
Tatsächliche erste Zeilen (wörtliche englische Quelle):
| Datei | Erste Zeile | Rundgang |
|---|---|---|
ARCHITECTURE.md | ## Internationalization (i18n) Architecture | Quelle und Erklärung lesen |
DESIGN.md | # DESIGN.md | Quelle und Erklärung lesen |
OBJECTIVES.md | # OBJECTIVES.md — SHAPE Framework Website | Quelle und Erklärung lesen |
SHAPE.md | # SHAPE — Core Agent Principles | Quelle und Erklärung lesen |
STACK.md | # STACK.md | Quelle und Erklärung lesen |
Verantwortlichkeiten je Verzeichnis
| Pfad | Inhalt und Abgrenzung | Verantwortung und Agentenarbeit | Zweck / Geltung |
|---|---|---|---|
AGENTS.md | Orientierung und echte Detailregeln; keine Funktionsabsicht | Änderungen nur auf ausdrückliche Nutzeranweisung; Agenten lesen | Umfangreicher Projekteinstieg |
agent_instructions/ | Dauerhafter Stack, Architektur, Design, Kontext; keine einzelnen Funktionsspecs | Eigentümer steuern Standards; Agenten lesen, Änderungen nur mit Befugnis | Erweiterbare Konvention, projektgewählte Dateien |
specifications/requests/ | Menschliche Änderungswünsche; kein ausführbarer Inhalt | Menschen verfassen; Agenten lesen, ändern nur auf Anweisung | Historische Projektabsicht |
specifications/archive/ | Frühere menschliche Änderungsanfragen; kein generierter Code | Menschen bewahren Historie; Agenten lesen ohne unbefugte Änderung | Archivierte Herkunft, kein SHAPE-Pflichtordner |
specifications/current/ | Anforderungen nach Fachbereich; keine einzelne Master-Datei | Agenten pflegen; Menschen entscheiden Absicht | Aktuelle Projektpraxis |
app/ | Dünne EN/DE/ES-Routenadapter und Metadaten; keine doppelte Sprach-UI | Agenten folgen Architektur; Architekturänderungen mit Eigentümer klären | Next.js-Routing |
domain/ | Inhaltsverträge, kanonische Routen, Beziehungen; keine UI/Dateizugriffe | Agenten pflegen Verträge und Routen | Trennung der Produktstruktur |
application/ | Navigation, Metadaten und Routenaufbau; keine Darstellung | Agenten verbinden Domäne und Lader | Anwendungsschicht |
infrastructure/ | Serverseitige YAML-/Dateizugriffe und HTTP-Wiederherstellung; kein Client-Dateizugriff | Agenten nutzen freigegebene Serverfähigkeiten | Infrastrukturgrenze |
components/ | Gemeinsame kanonische UI und kleine Browserinteraktionen; keine Sprachkomponenten | Agenten verwenden wieder; globale Designänderungen brauchen Befugnis | React-Darstellung |
styles/ | Zentrale Tokens und globale Stile; keine beliebigen Komponentenwerte | Designverantwortliche steuern wesentliche Standards; Agenten nutzen Tokens | Austauschbares Theme |
i18n/ | Sprachhelfer und EN/DE/ES-YAML; keine ausführbare Prosa/JSX | Agenten pflegen Übersetzungsparität und Metadaten | Inhaltsarchitektur dieser Website |
scripts/ | Diagramm-/Wiederherstellungserzeugung, Prüfungen, Paketierung; keine Produktrichtlinien | Ausführung nur im autorisierten Rahmen einschließlich Testregeln | Build-Betrieb, keine SHAPE-Pflichtwerkzeuge |
tests/unit/, tests/e2e/ | Vitest-/Playwright-Prüfungen und Testdaten; kein Abnahmenachweis | Autorisierte Verhaltenstests; unabhängige Ableitung braucht separaten Kontext | Projektgewählte Werkzeuge |
public/ | Ausgelieferte Assets und Fehlerdokumente; keine Geheimnisse | Agenten veröffentlichen sichere freigegebene Dateien; Bilder hier geschützt | Browserdateien |
resources/ | Originale lokale Referenzgrafiken; keine Geschäftslogik | Freigegebene Assets bleiben erhalten; keine Bildänderung | Lokales Quellmaterial |
diagrams/ | Bearbeitbare Mermaid-Quellen/Konfiguration; keine Befugnisregeln | Build kann SVG ableiten; diese Änderung regeneriert sie nicht | Website-Bildpipeline |
docs/ | Deployment-/Verifikationsdokumentation; kein neues Laufzeitverhalten | Agenten pflegen Fakten und Ergebnisse; keine erfundene Abnahme | Prüffähige Betriebsnachweise |
server.js, next.config.mjs | cPanel-Start/Konfiguration; keine Domänenlogik | Bestehende Hostingarchitektur gilt; Eigentümer bestätigen | Projekt-Hostingwahl |
package.json, pnpm-lock.yaml | Skripte und genaue Abhängigkeiten; keine Zugangsdaten | Neue Abhängigkeiten brauchen menschliche Freigabe; Agenten nutzen Bestand | Reproduzierbare Werkzeuge |
Framework-Konvention oder Projektentscheidung?
| Element | Umsetzung dieser Website | SHAPE-weite Anforderung? | Wer darf ändern? | Bedeutung |
|---|---|---|---|---|
| Orientierung | Detailliertes AGENTS.md verweist auf alle Anweisungsdateien | Minimalorientierung ist Konvention; voller Wurzelinhalt lokal | Hier ausdrückliche Nutzeranweisung | Regeln ohne manuelles Register finden |
| Anweisungsverzeichnis | Fünf echte Projektdokumente | Erweiterbar, kein vorgeschriebenes Inventar | Autorisierte Dokumenteigentümer; mit Repository-Eigentümer klären | Dauerhafte Themen trennen |
| Dateinamen | SHAPE.md, STACK.md, ARCHITECTURE.md, DESIGN.md, OBJECTIVES.md | Keine universellen Namen; kanonische Kernidentität offen | Mit Repository-Eigentümer klären | Beispiele nicht zu Pflichten machen |
| Spezifikationsorganisation | Anfragen und aktuelle Fachbereiche | Projektwahl; Drei-Verzeichnis-Lebenszyklus; einzelne Master-Datei optional | Menschliche Absichtsverantwortliche; Agenten pflegen Kontext | Herkunft und Kontinuität bewahren |
| Quellstruktur | Next.js-/React-Schichten und YAML | Website-spezifisch | Mit Repository-Eigentümer klären | SHAPE schreibt keine Architektur vor |
| Testwerkzeuge | Vitest und Playwright | Website-spezifisch; unabhängige Verifikation bleibt Prinzip | Menschen autorisieren Ausführung nach lokalen Regeln | Tests sind keine Produktabnahme |
| Technischer Zugriff | Umgebung/Repository müssen Grenzen durchsetzen | Grenzprinzip; Kontrollen unternehmensabhängig | Autorisierte Administratoren; mit Eigentümer klären | Text erzeugt keine Berechtigungen |
Eine überprüfbare kleine Änderung und ihre Grenzen
Die erhaltene Anfrage specifications/archive/SHAPE_Framework_Website_QA_Round_3_Correction_Spec.md verlangte die Zusammenführung doppelter Abschlusskriterien. Geändert wurden nur die entsprechenden Texte in i18n/en/guides/discovery.yaml und i18n/en/guides/feature-specification.yaml sowie deutsche/spanische Gegenstücke. specifications/current/content.md und Tests in tests/unit/round3-content.test.tsx und tests/e2e/qa-content.spec.ts dokumentieren Absicht und Prüfungen.
docs/QA-ROUND-3.md hält 62 bestandene Unit- und 57 bestandene Browserprüfungen mit einer bewussten Auslassung sowie unveränderte Bildprüfsummen fest. Dies sind lokale Ergebnisse, keine Behauptung unabhängiger Testautorenschaft, produktionsseitiger Testausführung oder menschlicher Abnahme. Ein Abnahmebeleg oder eingecheckter Änderungsstand lag nicht vor; Veröffentlichung/Abnahme dürfen nicht erfunden werden. Es ist ein überprüfbares Arbeitsbaumbeispiel mit diesen Grenzen.