Skip to content

[workflow-editor] docs-linker: inline concept coverage check into identification step #2680

Description

@github-actions

Caution

Protected files were modified in this change.
This pull request is in request_review mode and requires explicit human scrutiny before merge.

Protected files: .github/workflows/docs-linker.lock.yml, .github/workflows/docs-linker.md

What changed

File: .github/workflows/docs-linker.md

Removed the standalone ## Verify Concept Coverage (Doc Index Check) section (~12 lines) and folded its two discard rules directly into the ## Identify Concepts and Tasks step, right after the mapping is built.

What was redundant

The old flow described matching logic in one section, then asked the agent to re-check the same match quality in a separate section — but only for the "top 3–5 most prominent" entries. This created two problems:

  1. Duplication: the discard rules restated what a good match already meant.
  2. Inconsistency: the spot-check applied to only a subset of entries; the rest could slip through unverified.

How the revised wording is more Skills-like

The new inline paragraph is one short, direct block attached to the step it belongs to. It applies the quality check uniformly to every entry, matches the active-voice style of the surrounding instructions, and removes the false impression that verification is a separate audit phase.

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 ✂️ Workflow Skills Editor · 44.4 AIC · ⌖ 8.3 AIC · ⊞ 5.1K ·

  • expires on Aug 17, 2026, 9:35 PM UTC

Note

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

Original error: pushSignedCommits: refusing unsigned push for branch 'workflow-skills-editor/trim-docs-linker-verify-section-326aeadae7ab80a1': Signed-commit payload violates file-protection policy (request_review): .github/workflows/docs-linker.lock.yml, .github/workflows/docs-linker.md

Workflow Run: View run details and download bundle artifact

The bundle file is available in the agent 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 31973591446 -n agent -D /tmp/agent-31973591446

# Fetch the bundle into a temporary ref, then update the local branch
git fetch /tmp/agent-31973591446/aw-workflow-skills-editor-trim-docs-linker-verify-section.bundle refs/heads/workflow-skills-editor/trim-docs-linker-verify-section:refs/bundles/create-pr-workflow-skills-editor-trim-docs-linker-verify-section-326aeadae7ab80a1-af2d08af
git update-ref refs/heads/workflow-skills-editor/trim-docs-linker-verify-section-326aeadae7ab80a1 refs/bundles/create-pr-workflow-skills-editor-trim-docs-linker-verify-section-326aeadae7ab80a1-af2d08af
git checkout workflow-skills-editor/trim-docs-linker-verify-section-326aeadae7ab80a1
# Ensure the working tree matches the updated branch
git reset --hard
# Remove the temporary bundle ref
git update-ref -d refs/bundles/create-pr-workflow-skills-editor-trim-docs-linker-verify-section-326aeadae7ab80a1-af2d08af

# Push the branch to origin
git push origin workflow-skills-editor/trim-docs-linker-verify-section-326aeadae7ab80a1

# Create the pull request
gh pr create --title '[workflow-editor] docs-linker: inline concept coverage check into identification step' --base main --head workflow-skills-editor/trim-docs-linker-verify-section-326aeadae7ab80a1 --repo githubnext/gh-aw-workshop

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions