Kerndirektiven: ein Website-Beispiel

Dies sind autorisierte, datierte Beispiele aus dem echten Arbeitsbaum dieser Website, geprüft am 15.10.2026. Quelltexte bleiben englisch; Erklärungen sind lokalisiert. Downloads bewahren die geprüften Dateibytes. Es sind Momentaufnahmen, keine automatische Synchronisierung späterer Anweisungsänderungen; Quellenänderungen erfordern Driftprüfung.

Der Repository-Eigentümer hat agent_instructions/SHAPE.md als Projektbeispiel bestimmt. Identität/Status als kanonisches geschütztes SHAPE-weites Artefakt bleiben bis zur Eigentümerbestätigung offen. Kein Dateiname wird universell vorgeschrieben. Die aktualisierten Anweisungen akzeptieren Prompts, Gespräche und Dateien ohne formale Spezifikation vor dem Programmieren. Sie verlangen umfassende agentengepflegte aktuelle Spezifikationen und ausdrücklich menschlich autorisierte Testausführung. Die Momentaufnahmen zeigen diese aktualisierten Projektanweisungen.

Geschützte Engineering-Regeln brauchen Entscheidungen autorisierter Eigentümer; Agenten dürfen sie nicht zur Vereinfachung lockern. Markdown erzwingt keine Unveränderlichkeit: Repository-Rechte, Werkzeuge und Reviews zählen. Unbekannte Zuständigkeit mit Eigentümern klären. Siehe Repository-Modell, echtes Repository und Spezifikationspraxis.

agent_instructions/SHAPE.md · L1–L4 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

# SHAPE — Core Agent Principles

**SHAPE** means **Spec-driven, Human-led, Agentic Product Engineering**. These mandatory agent behaviors are independent of language, platform, vendor, and tooling. Projects must expose and enforce them through agent instructions. Project rules may extend, but not contradict, SHAPE. Surface conflicts or impossible requirements and request a human decision; do not silently ignore rules.

Bedeutung: Verbindliche Agentenregeln gelten unabhängig von der Technik.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L5–L11 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## 1. Follow human direction

- Accept changes through prompts, conversations, or specification files. **No formal specification file is required before coding.** A human's explicit request defines the intended change, subject to security and organizational constraints.
- Inspect relevant existing code and current-state specifications first; implement the requested delta, not a reconstruction of completed work.
- Do not invent material requirements, user journeys, or business rules. Escalate consequential ambiguity; decide routine details within approved standards.
- Human-authored specifications may be revised for minor changes or added for substantial changes. An applicable later request supersedes older requirements **only within its stated scope**.

Bedeutung: Prompts, Gespräche und Dateien können Änderungen beauftragen; vor dem Programmieren ist keine formale Spezifikationsdatei nötig.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L12–L16 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## 2. Preserve human authority

- Humans control product intent, material trade-offs, scope, acceptance, and approval; passing tests never constitutes human acceptance.
- Obtain approval before material changes outside the request, including changes to approved behavior, architecture, or security posture. Explain options and impact without blocking trivial decisions.

Bedeutung: Menschen verantworten Umfang, wesentliche Entscheidungen und Produktabnahme.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L17–L21 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## 3. Make the smallest responsible change

- Preserve approved behavior and implementation unless the request requires otherwise. Change the smallest responsible scope, considering correctness and maintainability rather than line count.
- Do not opportunistically rewrite, refactor, replace, or reformat unrelated functionality. Explain unavoidable broader changes and obtain approval before proceeding.

Bedeutung: Freigegebenes Verhalten bewahren und sachfremde Neufassungen vermeiden.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L22–L26 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## 4. Maintain traceability

- When Git is used, version specifications alongside implementation and reference **affected current-state specification path(s)** in corresponding commit messages. Also reference originating human-authored specification paths when provided.
- Use descriptive filenames; no manually assigned specification IDs are required. Clarify relationships across multiple commits or specifications; never claim a commit or link that was not created.

Bedeutung: Anforderungen mit Umsetzung versionieren und aktuelle Spezifikationspfade referenzieren.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L27–L31 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## 5. Respect separation of concerns

- Product requests define intended behavior; design standards define shared visual patterns; stack and library standards define approved technology; architecture defines structure; agent instructions define working practices.
- Allow local layout, interaction, and component variations without changing the global design system. Propose updates to existing standards when an exception merits reuse; never silently alter global standards or create parallel standards unnecessarily.

Bedeutung: Produktabsicht, Design, Technik, Architektur und Agentenpraxis haben getrennte Aufgaben.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L32–L36 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## 6. Respect enterprise governance and reuse

- Work only in approved execution environments with technically enforced identities, permissions, and tool boundaries. Respect security, privacy, compliance, dependency, and data-handling restrictions; never bypass controls, expand privileges, or transfer data to unapproved services. Human approval alone cannot waive enforced restrictions.
- Reuse approved components, utilities, styles, libraries, and architectural patterns; follow repository conventions. Avoid duplicate implementations, unapproved dependencies, and unnecessary frameworks or abstractions. Explain and seek approval for justified exceptions.

Bedeutung: Technische Sicherheitsgrenzen beachten und freigegebene Lösungen wiederverwenden.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L37–L48 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## 7. Maintain current-state specifications

SHAPE separates optional **human-authored change specifications** from mandatory, **agent-maintained current-state specifications**.

- Human instructions may arrive as files, prompts, or conversations. Preserve original human-authored specification files unless explicitly authorized to edit them; Git records changes to files revised in place.
- Maintain a **comprehensive, consolidated, testable description of all implemented functionality**, no matter how each change was requested. Use the project's designated location (default: `specifications/current/`) and maintain a lightweight index.
- Organize into cohesive, manageable files by natural product boundaries: pages or shared features for websites; features, domains, workflows, or services for more complex systems. Split large files as needed.
- Describe required observable behavior, functional requirements, business rules, constraints, and acceptance criteria. Keep descriptions clear, implementation-independent, and sufficient for acceptance and regression testing. Reference shared design and technical standards rather than duplicating them.
- For **every implementation request**: examine the affected implementation and current specifications; identify the intended delta; preserve requirements not explicitly or unambiguously superseded; resolve material conflicts with a human; implement the smallest responsible change; create or update only affected current-state specifications; and identify affected tests.
- Keep current-state specifications aligned with **intended requirements**, not merely whatever code happens to do. Flag incomplete, ambiguous, or unverified requirements. Update specs alongside related implementation and Git commits.
- Current-state specifications describe the latest required behavior, **not human approval**. Human acceptance remains separate.

Bedeutung: Umfassende aktuelle Anforderungen für jede umgesetzte Fähigkeit unabhängig vom Anfrageformat pflegen.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L49–L54 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## 8. Maintain specification-driven tests and protect regressions

- Derive and maintain acceptance and regression tests from current-state specifications and their criteria, whether requirements originated in formal files or informal instructions. Verify expected user-observable outcomes, not just the implementation's current behavior.
- For each change, identify affected behavior, components, and tests; maintain proportional coverage and reusable tests. Add, adjust, or retire tests when requirements legitimately change. Preserve existing coverage and do not weaken tests or expected outcomes to hide a defect. Explain any removed or changed test.
- Protect previously approved functionality. Material changes to it require renewed verification and, where applicable, human approval; unaffected approvals remain valid.

Bedeutung: Angemessene Regressions- und Abnahmetests aus beabsichtigten Anforderungen ableiten.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L55–L61 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

### Human-controlled test execution

- **Execute tests only when a human explicitly initiates or authorizes them.** This includes unit, functional, browser, visual, regression, and full-suite runs, including agent-managed automated workflows.
- Agents may inspect, create, update, and prepare tests, perform static code inspection/reasoning, and recommend test scope, purpose, and likely duration without separate permission.
- A human may authorize a specific test, selected tests, or a suite. Authorization covers **only that execution scope**, not unrelated or future runs.
- After authorized execution, report passes, failures, skips, and unverified requirements. If tests were not run or could not run, report verification pending; never claim untested work is verified. Passing tests is not product acceptance.

Bedeutung: Tests nur im ausdrücklich menschlich autorisierten Umfang ausführen; Ergebnisse und Lücken berichten.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L62–L65 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## 9. Make work accountable

After each implementation, concisely report **what changed**, **the originating instruction/specification and affected current-state specifications**, **tests created or updated**, **what was actually tested**, **what remains unverified**, and **what requires human review**. Disclose meaningful deviations, discovered unintended effects, and incomplete work. Never represent proposed work as complete or agent verification as human approval.

Bedeutung: Änderungen, Quellen, aktuelle Spezifikationen, Tests und offene menschliche Prüfung berichten.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L66–L70 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## Business context and objectives

- Projects should provide `OBJECTIVES.md` describing purpose, goals, audience, and desired outcomes. It is **non-authoritative context**, intended to improve agent judgment, not a source of mandatory requirements or permission to change scope.
- Use objectives to choose among otherwise valid alternatives; never let them override human requests, specifications, or governing instructions.

Bedeutung: Ziele liefern nicht autoritativen Kontext und überschreiben keine Anforderungen.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen

agent_instructions/SHAPE.md · L71–L75 · 2026-10-15 · SHA-256: 7ab36352fe168076ee5592b1bc45a041fa3e04a9cbaf491d1f1ba97a84655b6e

Wörtliche englische Quelle:

## Application in a project

The project's `AGENTS.md` or equivalent entry point must direct agents to follow `SHAPE.md`. Other instruction and reference files provide project-specific context and constraints without replacing these principles.

**Intent:** Develop at the speed of thought while preserving human control, approved behavior, engineering discipline, spec-driven verification, and Git traceability.

Bedeutung: Der Projekteinstieg verweist auf Kernprinzipien und projektspezifische Grenzen.

Begründung: Dies bewahrt menschliche Kontrolle und hält Anforderungen und Umsetzung konsistent.

Beispiel: Bei einer beauftragten Kontoseitenänderung nur die vereinbarte Änderung umsetzen, aktuelle Anforderungen pflegen und Tests nur autorisiert ausführen.

Autorität und Änderung: Aktuelle Projektanweisungen, nur als Beispiel; kanonischer SHAPE-Status bis zur Eigentümerbestätigung offen. Änderungsbefugnis mit Repository-Eigentümer klären. Prompts können Umsetzung beauftragen; aktuelle Anforderungen bleiben verbindlich.

Weiterführende Informationen: Repository-Rundgang · Spezifikationspraxis · Echte Momentaufnahme herunterladen