Skip to content

[plan] Elevate professional tone in Archie workflow messages #17744

@github-actions

Description

@github-actions

Context

Identified in discussion #17680 — a quality analysis of workflow message configuration. The Archie workflow messages use a first-person persona announcement and casual phrasing that appears in issue comments viewed by engineering teams.

File to Modify

.github/workflows/archie.md

Current State

run-started: "📐 Archie here! [{workflow_name}]({run_url}) is sketching the architecture on this {event_type}..."
run-success: "🎨 Blueprint complete! [{workflow_name}]({run_url}) has visualized the connections. The architecture speaks for itself! ✅"
run-failure: "📐 Drafting interrupted! [{workflow_name}]({run_url}) {status}. The diagram remains incomplete..."

Issues

  1. "Archie here!" — first-person persona greeting is inappropriate for issue tracker context
  2. "The architecture speaks for itself!" — casual boastful phrasing
  3. {status} in failure message provides no actionable guidance

Proposed Changes

Remove the first-person announcement, maintain the architectural theme but with professional tone, and add actionable context to the failure message. Example direction:

run-started: "📐 [{workflow_name}]({run_url}) is analyzing the architecture for this {event_type}..."
run-success: "🎨 [{workflow_name}]({run_url}) has completed the architecture visualization. ✅"
run-failure: "📐 [{workflow_name}]({run_url}) encountered an issue and could not complete the architecture diagram. Check the [run logs]({run_url}) for details."

Acceptance Criteria

  • First-person persona announcement removed from run-started
  • Casual boastful phrasing removed from run-success
  • Failure message provides actionable guidance (link to logs or clear next step) instead of relying solely on {status}
  • Messages retain the architectural/blueprint theme and emoji
  • No other sections of the file are modified

Generated by Plan Command for issue #discussion #17680

  • expires on Feb 24, 2026, 3:47 PM UTC

Metadata

Metadata

Labels

Type

No type
No fields configured for issues without a type.

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions