From 90fac0d137db5d1166e44473f433640821decf6d Mon Sep 17 00:00:00 2001
From: "flamingo[bot]" <277372822+flamingo[bot]@users.noreply.github.com>
Date: Thu, 17 Sep 2026 22:53:36 +0000
Subject: [PATCH] =?UTF-8?q?chore:=20add=20=F0=9F=A6=A9=20Flamingo=20Code?=
 =?UTF-8?q?=20Documentation=20workflow?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This workflow enables automated documentation generation using the
🦩 Flamingo Code Documentation pipeline. It runs on repository_dispatch events
triggered by the multi-platform-hub.

No secrets required - all credentials are passed securely at runtime.
---
 .github/workflows/doc-orchestrator.yml | 13 ++++++++++++-
 1 file changed, 12 insertions(+), 1 deletion(-)

diff --git a/.github/workflows/doc-orchestrator.yml b/.github/workflows/doc-orchestrator.yml
index c6f9c826..764eeea3 100644
--- a/.github/workflows/doc-orchestrator.yml
+++ b/.github/workflows/doc-orchestrator.yml
@@ -2411,6 +2411,16 @@ jobs:
             echo "   Added .md/.mmd/.gitignore/*-schema.json/*-config.json from $DIAGRAMS_OUTPUT_PATH/"
           fi
 
+          # AGENTS.md carries the hub-rendered ecosystem block ("Fetch ecosystem
+          # facts" upserts it just before this stage). It sits at the repository
+          # root, outside every output directory staged above, so it is staged by
+          # name: the first production run wrote the block and no commit ever
+          # picked the file up (openframe-cli#383).
+          if [ -f AGENTS.md ]; then
+            git add -f AGENTS.md
+            echo "   Added AGENTS.md (ecosystem block)"
+          fi
+
           # Check if there are changes
           STAGED_COUNT=$(git diff --cached --name-only | wc -l)
           echo "   Staged $STAGED_COUNT files"
@@ -2828,7 +2838,8 @@ jobs:
           done
 
           # Stage repository documentation files
-          for f in README.md CONTRIBUTING.md LICENSE.md SECURITY.md; do
+          # AGENTS.md is here as the backstop for a run whose Stage 2 commit did not happen.
+          for f in README.md CONTRIBUTING.md LICENSE.md SECURITY.md AGENTS.md; do
             if [ -f "$f" ]; then
               git add -f "$f"
             fi