From 1762793fb7f33f55c940cb7ffabba718dd3abd14 Mon Sep 17 00:00:00 2001
From: Matthias Leuffen <matthes@leuffen.de>
Date: Wed, 30 Sep 2026 10:43:22 +0200
Subject: [PATCH] Document CLI output buffering architecture rule

---
 Architecture.md | 5 +++++
 1 file changed, 5 insertions(+)
 create mode 100644 Architecture.md

diff --git a/Architecture.md b/Architecture.md
new file mode 100644
index 0000000..cf6bff9
--- /dev/null
+++ b/Architecture.md
@@ -0,0 +1,5 @@
+# Architecture
+
+## CLI output ownership
+
+CLI execution must never automatically enable, replace, flush, clean, or otherwise manage PHP output buffering. In particular, CLI framework code must not call `ob_start()`, `ob_get_clean()`, `ob_end_clean()`, or equivalent buffering mechanisms as part of normal command execution. Command output is written directly to the active output stream, while any deliberate output buffering remains the responsibility of the embedding application or caller.