From 5cbd949bd514c5344f8d133f25f76daeac99f98a Mon Sep 17 00:00:00 2001
From: nexxo <nexxo@clupilot.local>
Date: Mon, 27 Jul 2026 21:20:37 +0200
Subject: [PATCH] Say plainly that the path comment in the plan is not code

The Task 1 implementer copied '// path/to/file.php' into the files
verbatim, which breaks Pint's blank_line_after_opening_tag and matches
no file in the repo. The annotation was mine; the constraint now says so
before the next seven tasks repeat it.
---
 docs/superpowers/plans/2026-07-27-mailboxes.md | 5 +++++
 1 file changed, 5 insertions(+)

diff --git a/docs/superpowers/plans/2026-07-27-mailboxes.md b/docs/superpowers/plans/2026-07-27-mailboxes.md
index 09690f3..49b4886 100644
--- a/docs/superpowers/plans/2026-07-27-mailboxes.md
+++ b/docs/superpowers/plans/2026-07-27-mailboxes.md
@@ -19,6 +19,11 @@
 - **Verschlüsselung:** Postfach-Passwörter mit `SECRETS_KEY`, **niemals** `APP_KEY`. Begründung steht in `SecretVault`: APP_KEY wird routinemäßig gewechselt.
 - **Nie beim Booten in `config('mail')` schreiben.** Auflösung geschieht im Transport, also zum Sendezeitpunkt.
 - **Verifikation nach jeder Aufgabe:** `docker compose exec -T app php artisan test` muss vollständig grün sein (Ausgangsstand: 637 Tests grün).
+- **Die `// pfad/zur/datei.php`-Zeile in den Codeblöcken dieses Plans ist eine
+  Annotation, kein Code.** Sie sagt, wohin die Datei gehört. Die Repo-Konvention
+  ist `<?php`, Leerzeile, `namespace` — genau wie in jeder bestehenden Datei.
+  Ein Kommentar direkt hinter `<?php` verstößt außerdem gegen Pints
+  `blank_line_after_opening_tag`.
 - Blade-Anonymkomponenten liegen unter `resources/views/components/`.
 - Tailwind-Namenskollisionen vermeiden (`.ring`, `.num` sind bereits einmal kollidiert — siehe Handoff §2.1).