Skip to content

[workshop-sync] workshop/09-agentic-editing.md: unnecessary recompile steps in body-only terminal paths #2509

Description

@github-actions

Workshop file reviewed

workshop/09-agentic-editing.md

Problem

Three terminal paths in this file instruct learners to run gh aw compile after making body-only edits to a workflow file. According to the reference documentation, recompilation is only required when the frontmatter is changed — editing the Markdown body alone does not require recompilation.

Occurrence 1 — Edit terminal path:

gh aw compile
git add .
git commit -m "feat: add team-benefit sentence to daily-report-status brief"
git push

Occurrence 2 — Debug terminal path:

Recompile and push the change.

Occurrence 3 — Optimize terminal path:

Recompile after each removal so you can verify nothing breaks.

Current correct behaviour

Per the github-agentic-workflows.md reference doc:

Recompilation Rule: Edit the markdown body only → no recompilation required.

Recompilation is only needed when frontmatter fields (e.g., safe-outputs, permissions, trigger configuration) are modified.

Suggested fix

  • Edit path: Remove the gh aw compile line from the terminal path bash block — keep git add ., git commit, and git push.
  • Debug path: Replace Recompile and push the change. with Commit and push the change.
  • Optimize path: Replace Recompile after each removal so you can verify nothing breaks. with Commit and push after each removal so you can verify nothing breaks. (only instruct recompilation if safe-outputs declarations in the frontmatter are also being removed).

Warning

Firewall blocked 1 domain

The following domain was blocked by the firewall during workflow execution:

  • awmgmcpg

To allow these domains, add them to the network.allowed list in your workflow frontmatter:

network:
  allowed:
    - defaults
    - "awmgmcpg"

See Network Configuration for more information.

Generated by 🔍 Workshop Sync Check · 109.6 AIC · ⌖ 5.43 AIC · ⊞ 5.8K ·

  • expires on Aug 6, 2026, 12:14 PM UTC

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentation

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions