Skip to content

[q] update architecture diagram workflow to maintain scratchpad file #19205

@github-actions

Description

@github-actions

Summary

Updates the daily-architecture-diagram workflow to maintain scratchpad/architecture.md in addition to creating GitHub issues.

Changes Made

.github/workflows/daily-architecture-diagram.md

  1. Added create-pull-request safe-output — enables the agent to propose file updates via PR when the diagram changes
  2. Added Scratchpad File section — instructs the agent to update scratchpad/architecture.md with the latest diagram after each run, including the date and source issue link

Behavior

  • When the diagram changes: agent updates scratchpad/architecture.md via create-pull-request safe-output, creating a PR labeled architecture, diagram, documentation
  • When the diagram is unchanged: agent calls noop and skips the scratchpad update

Validation

Compiled successfully with gh aw compile daily-architecture-diagram

Closes #19177 (triggered by comment from @pelikhan)

🎩 Equipped by Q

  • expires on Mar 4, 2026, 12:38 PM UTC

Note

This was originally intended as a pull request, but the git push operation failed.

Workflow Run: View run details and download patch artifact

The patch file is available in the agent-artifacts artifact in the workflow run linked above.

To create a pull request with the changes:

# Download the artifact from the workflow run
gh run download 22576109720 -n agent-artifacts -D /tmp/agent-artifacts-22576109720

# Create a new branch
git checkout -b q/update-architecture-diagram-scratchpad-7589862475a6c6d7

# Apply the patch (--3way handles cross-repo patches where files may already exist)
git am --3way /tmp/agent-artifacts-22576109720/aw-q-update-architecture-diagram-scratchpad.patch

# Push the branch to origin
git push origin q/update-architecture-diagram-scratchpad-7589862475a6c6d7

# Create the pull request
gh pr create --title '[q] update architecture diagram workflow to maintain scratchpad file' --base main --head q/update-architecture-diagram-scratchpad-7589862475a6c6d7 --repo github/gh-aw
Show patch preview (314 of 314 lines)
From 15325fcacc945138fc4477aaf29a71812fc09968 Mon Sep 17 00:00:00 2001
From: "github-actions[bot]" <github-actions[bot]@users.noreply.github.com>
Date: Mon, 2 Mar 2026 12:37:00 +0000
Subject: [PATCH] feat(daily-architecture-diagram): maintain
 scratchpad/architecture.md

Add create-pull-request safe-output and instructions to update
scratchpad/architecture.md when the architecture diagram changes.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
---
 .../daily-architecture-diagram.lock.yml       | 146 +++++++++++++++++-
 .../workflows/daily-architecture-diagram.md   |  36 +++++
 2 files changed, 175 insertions(+), 7 deletions(-)

diff --git a/.github/workflows/daily-architecture-diagram.lock.yml b/.github/workflows/daily-architecture-diagram.lock.yml
index ecbe696..ba01aea 100644
--- a/.github/workflows/daily-architecture-diagram.lock.yml
+++ b/.github/workflows/daily-architecture-diagram.lock.yml
@@ -27,7 +27,7 @@
 #   Imports:
 #     - shared/reporting.md
 #
-# gh-aw-metadata: {"schema_version":"v1","frontmatter_hash":"e390a776612f4b61886e01884fa8b6d50bcda447e11f1c638ff696153b12ce7b"}
+# gh-aw-metadata: {"schema_version":"v1","frontmatter_hash":"ed6ad476b06d6af269ab948a4e050ab97d4b159d1ac0ef1a7df33000d6ec5342"}
 
 name: "Architecture Diagram Generator"
 "on":
@@ -129,7 +129,10 @@ jobs:
           cat "/opt/gh-aw/prompts/safe_outputs_prompt.md"
           cat << 'GH_AW_PROMPT_EOF'
           <safe-output-tools>
-          Tools: create_issue, missing_tool, missing_data, noop
+          Tools: create_issue, create_pull_request, missing_tool, missing_data, noop
+          GH_AW_PROMPT_EOF
+          cat "/opt/gh-aw/prompts/safe_outputs_create_pull_request.md"
+          cat << 'GH_AW_PROMPT_EOF'
           </safe-output-tools>
           <github-context>
           The following GitHub context information is available for this workflow:
@@ -339,7 +342,7 @@ jobs:
           mkdir -p /tmp/gh-aw/safeoutputs
           mkdir -p /tmp/gh-aw/mcp-logs/sa
... (truncated)

Metadata

Metadata

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions