Update artifact naming documentation to reflect upload-artifact@v5 changes

[Copilot]

PR #8362 renamed artifacts from agent_output.json → agent-output (and similar) to comply with upload-artifact@v5 requirements, but specs/layout.md still documented the old names, creating confusion about which name to use when.

Changes

Updated artifact documentation structure

• Added "File Inside" column to distinguish artifact names (GitHub Actions layer) from file names (filesystem layer)
• Artifact names: agent-output, safe-output, aw-info, prompt (hyphens, no extensions)
• File names inside: agent_output.json, safe_output.jsonl, aw_info.json, prompt.txt (unchanged)

Updated constant value documentation

• AgentOutputArtifactName: "agent-output" (was documented as "agent_output.json")
• SafeOutputArtifactName: "safe-output" (was documented as "safe_output.jsonl")

Clarified environment variable paths

• GH_AW_AGENT_OUTPUT now documents the full path including artifact subdirectory: /tmp/gh-aw/safeoutputs/agent-output/agent_output.json

Key Insight

# Artifact name (GitHub Actions layer)
- uses: actions/upload-artifact@v6
  with:
    name: agent-output  # ← Changed (hyphens, no extension)
    path: /tmp/gh-aw/agent_output.json  # ← File name unchanged

# Later download extracts to:
# /tmp/gh-aw/safeoutputs/agent-output/agent_output.json
#                        └─ artifact dir └─ original filename

Other documentation (compilation-process.md, threat-detection.md) already correctly referenced file names and required no changes.

Warning

Firewall rules blocked me from connecting to one or more addresses (expand for details)

I tried to connect to the following addresses, but was blocked by firewall rules:

• https://api.github.com/repos/githubnext/gh-aw/check-runs/59245594596/annotations
  • Triggering command: /usr/bin/curl curl -s REDACTED (http block)

If you need me to access, download, or install something from one of these locations, you can either:

• Configure Actions setup steps to set up my environment, which run before the firewall is enabled
• Add the appropriate URLs or hosts to the custom allowlist in this repository's Copilot coding agent settings (admins only)

Original prompt

Reference: https://github.com/githubnext/gh-aw/actions/runs/20629624745/job/59245594596#step:6:1

Custom agent used: debug-agentic-workflow
Debug and refine agentic workflows using gh-aw CLI tools - analyze logs, audit runs, and improve workflow performance

---

💬 We'd love your input! Share your thoughts on Copilot coding agent in our 2 minute survey.

[github-actions]

Smoke Test Results

Last 2 Merged PRs:

• [WIP] Update documentation references in action #8396: [WIP] Update documentation references in action
• [docs] Update documentation for audit command deep URL support #8392: [docs] Update documentation for audit command deep URL support

Test Results:

• ✅ GitHub MCP - Retrieved PR data
• ✅ File Writing - Created /tmp/gh-aw/agent/smoke-test-copilot-20629950807.txt
• ✅ Bash Tool - Verified file contents
• ✅ Playwright MCP - Navigated to github.com (title: "GitHub · Change is constant. GitHub keeps you ahead. · GitHub")
• ❌ Safe Input gh Tool - No auth token configured

Overall Status: PASS (4/5 tests successful)

AI generated by Smoke Copilot No Firewall