DE
Menü
Framework-Referenz

Das Website-Repository

Ein überprüfter Rundgang durch die echte SHAPE-Website, ihre Grenzen, Anweisungen und ihr Produktwissen.

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):

DateiErste ZeileRundgang
ARCHITECTURE.md## Internationalization (i18n) ArchitectureQuelle und Erklärung lesen
DESIGN.md# DESIGN.mdQuelle und Erklärung lesen
OBJECTIVES.md# OBJECTIVES.md — SHAPE Framework WebsiteQuelle und Erklärung lesen
SHAPE.md# SHAPE — Core Agent PrinciplesQuelle und Erklärung lesen
STACK.md# STACK.mdQuelle und Erklärung lesen

Verantwortlichkeiten je Verzeichnis

PfadInhalt und AbgrenzungVerantwortung und AgentenarbeitZweck / Geltung
AGENTS.mdOrientierung und echte Detailregeln; keine FunktionsabsichtÄnderungen nur auf ausdrückliche Nutzeranweisung; Agenten lesenUmfangreicher Projekteinstieg
agent_instructions/Dauerhafter Stack, Architektur, Design, Kontext; keine einzelnen FunktionsspecsEigentümer steuern Standards; Agenten lesen, Änderungen nur mit BefugnisErweiterbare Konvention, projektgewählte Dateien
specifications/requests/Menschliche Änderungswünsche; kein ausführbarer InhaltMenschen verfassen; Agenten lesen, ändern nur auf AnweisungHistorische Projektabsicht
specifications/archive/Frühere menschliche Änderungsanfragen; kein generierter CodeMenschen bewahren Historie; Agenten lesen ohne unbefugte ÄnderungArchivierte Herkunft, kein SHAPE-Pflichtordner
specifications/current/Anforderungen nach Fachbereich; keine einzelne Master-DateiAgenten pflegen; Menschen entscheiden AbsichtAktuelle Projektpraxis
app/Dünne EN/DE/ES-Routenadapter und Metadaten; keine doppelte Sprach-UIAgenten folgen Architektur; Architekturänderungen mit Eigentümer klärenNext.js-Routing
domain/Inhaltsverträge, kanonische Routen, Beziehungen; keine UI/DateizugriffeAgenten pflegen Verträge und RoutenTrennung der Produktstruktur
application/Navigation, Metadaten und Routenaufbau; keine DarstellungAgenten verbinden Domäne und LaderAnwendungsschicht
infrastructure/Serverseitige YAML-/Dateizugriffe und HTTP-Wiederherstellung; kein Client-DateizugriffAgenten nutzen freigegebene ServerfähigkeitenInfrastrukturgrenze
components/Gemeinsame kanonische UI und kleine Browserinteraktionen; keine SprachkomponentenAgenten verwenden wieder; globale Designänderungen brauchen BefugnisReact-Darstellung
styles/Zentrale Tokens und globale Stile; keine beliebigen KomponentenwerteDesignverantwortliche steuern wesentliche Standards; Agenten nutzen TokensAustauschbares Theme
i18n/Sprachhelfer und EN/DE/ES-YAML; keine ausführbare Prosa/JSXAgenten pflegen Übersetzungsparität und MetadatenInhaltsarchitektur dieser Website
scripts/Diagramm-/Wiederherstellungserzeugung, Prüfungen, Paketierung; keine ProduktrichtlinienAusführung nur im autorisierten Rahmen einschließlich TestregelnBuild-Betrieb, keine SHAPE-Pflichtwerkzeuge
tests/unit/, tests/e2e/Vitest-/Playwright-Prüfungen und Testdaten; kein AbnahmenachweisAutorisierte Verhaltenstests; unabhängige Ableitung braucht separaten KontextProjektgewählte Werkzeuge
public/Ausgelieferte Assets und Fehlerdokumente; keine GeheimnisseAgenten veröffentlichen sichere freigegebene Dateien; Bilder hier geschütztBrowserdateien
resources/Originale lokale Referenzgrafiken; keine GeschäftslogikFreigegebene Assets bleiben erhalten; keine BildänderungLokales Quellmaterial
diagrams/Bearbeitbare Mermaid-Quellen/Konfiguration; keine BefugnisregelnBuild kann SVG ableiten; diese Änderung regeneriert sie nichtWebsite-Bildpipeline
docs/Deployment-/Verifikationsdokumentation; kein neues LaufzeitverhaltenAgenten pflegen Fakten und Ergebnisse; keine erfundene AbnahmePrüffähige Betriebsnachweise
server.js, next.config.mjscPanel-Start/Konfiguration; keine DomänenlogikBestehende Hostingarchitektur gilt; Eigentümer bestätigenProjekt-Hostingwahl
package.json, pnpm-lock.yamlSkripte und genaue Abhängigkeiten; keine ZugangsdatenNeue Abhängigkeiten brauchen menschliche Freigabe; Agenten nutzen BestandReproduzierbare Werkzeuge

Framework-Konvention oder Projektentscheidung?

ElementUmsetzung dieser WebsiteSHAPE-weite Anforderung?Wer darf ändern?Bedeutung
OrientierungDetailliertes AGENTS.md verweist auf alle AnweisungsdateienMinimalorientierung ist Konvention; voller Wurzelinhalt lokalHier ausdrückliche NutzeranweisungRegeln ohne manuelles Register finden
AnweisungsverzeichnisFünf echte ProjektdokumenteErweiterbar, kein vorgeschriebenes InventarAutorisierte Dokumenteigentümer; mit Repository-Eigentümer klärenDauerhafte Themen trennen
DateinamenSHAPE.md, STACK.md, ARCHITECTURE.md, DESIGN.md, OBJECTIVES.mdKeine universellen Namen; kanonische Kernidentität offenMit Repository-Eigentümer klärenBeispiele nicht zu Pflichten machen
SpezifikationsorganisationAnfragen und aktuelle FachbereicheProjektwahl; Drei-Verzeichnis-Lebenszyklus; einzelne Master-Datei optionalMenschliche Absichtsverantwortliche; Agenten pflegen KontextHerkunft und Kontinuität bewahren
QuellstrukturNext.js-/React-Schichten und YAMLWebsite-spezifischMit Repository-Eigentümer klärenSHAPE schreibt keine Architektur vor
TestwerkzeugeVitest und PlaywrightWebsite-spezifisch; unabhängige Verifikation bleibt PrinzipMenschen autorisieren Ausführung nach lokalen RegelnTests sind keine Produktabnahme
Technischer ZugriffUmgebung/Repository müssen Grenzen durchsetzenGrenzprinzip; Kontrollen unternehmensabhängigAutorisierte Administratoren; mit Eigentümer klärenText 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.