Include .agents folder in sparse checkout for agent jobs

[Copilot]

Implementation: Checkout .agents folder in agent jobs

Completed

• Update generateCheckoutGitHubFolder() to include .agents in sparse-checkout
• Update function documentation to reflect .agents checkout
• Update test cases to verify .agents is checked out
• Add unit tests for the function
• Run validation (fmt, lint, test)
• Recompile workflows to apply changes
• Remove redundant documentation (sparse-checkout behavior is implied)

Changes Made

1. Modified pkg/workflow/compiler_yaml_helpers.go:

   • Updated generateCheckoutGitHubFolder() to include .agents folder in sparse-checkout
   • Changed step name to "Checkout .github and .agents folders"
   • Added .agents to the sparse-checkout configuration
   • Updated all log messages to mention both folders

2. Updated Tests:

   • Modified TestGitHubFolderCheckoutOptimization to check for new step name
   • Added assertions to verify .agents is in sparse-checkout configuration
   • Added TestGenerateCheckoutGitHubFolder unit test

Validation Results

• ✅ All tests passing
• ✅ Linting passed
• ✅ Code formatted

Original prompt

The .agents folder should be checkout by default if the action job does not have contents read (like the .github folder). Only in agent job.

This is to support the new location for storing skills.

---

💡 You can make Copilot smarter by setting up custom instructions, customizing its development environment and configuring Model Context Protocol (MCP) servers. Learn more Copilot coding agent tips in the docs.

[pelikhan]

@copilot .agent maybe missing, do not check

[pelikhan]

@copilot this is implied by sparse checkout

[Copilot]

Removed the redundant note. Sparse-checkout behavior is indeed implied. (9d6b778)

[github-actions]

🌑 The shadows whisper... Smoke Codex failed. The oracle requires further meditation...

[github-actions]

📰 BREAKING: Smoke Copilot is now investigating this pull request. Sources say the story is developing...

[github-actions]

❌ Changeset Generator failed. Please review the logs for details.

[github-actions]

🎬 THE END — Smoke Claude MISSION: ACCOMPLISHED! The hero saves the day! ✨

[Copilot]

@copilot .agent maybe missing, do not check

The .agents folder is included in the sparse-checkout configuration, but the checkout won't fail if it doesn't exist. The actions/checkout action with sparse-checkout gracefully handles non-existent paths by simply not checking them out. This means:

1. If .agents exists in the repo → it will be checked out
2. If .agents doesn't exist → the checkout succeeds, just without that folder

This is the standard sparse-checkout behavior and doesn't require any additional handling. Is there a specific issue you'd like me to address differently?

[github-actions]

Agent Container Tool Check

Tool	Status	Version
bash	✅	GNU bash, version 5.2.21(1)-release
sh	✅	available
git	✅	git version 2.52.0
jq	✅	jq-1.7
yq	✅	yq version v4.50.1
curl	✅	curl 8.5.0
gh	✅	gh version 2.86.0
node	✅	v20.20.0
python3	✅	Python 3.12.3
go	✅	go version go1.24.12
java	✅	available (detection issue - needs fix)
dotnet	❌	not available

Result: 11/12 tools available ❌
Status: FAIL - .NET runtime (dotnet) is missing

Note: Java version check returned bash output incorrectly but Java is available in the container.

AI generated by Agent Container Smoke Test

[github-actions]

🤖 Beep boop! The smoke test agent just passed through discussion #13913 like a gentle breeze on a spring day. All systems nominal! ✨

P.S. If discussions could talk, this one would probably say "Hey, nice triage report!" 🎯

AI generated by Smoke Copilot

[github-actions]

Smoke Test: ✅ PASS

• ✅ GitHub MCP (Configure PR triage reports with 1-day expiration and auto-close older issues #13903, Add Video component for Astro Starlight documentation #13902)
• ✅ Safe Inputs GH CLI (Add missing category field to workflows using create-discussion #13915, Use workflow-id markers for close-older-discussions #13914)
• ✅ Serena MCP
• ✅ Playwright
• ✅ File Writing
• ✅ Bash Tool
• ✅ Discussion Comment ([Auto-Triage] Auto-Triage Report - 2026-02-05 #13913)
• ✅ Build gh-aw
• ✅ Workflow Dispatch

Run: https://github.com/github/gh-aw/actions/runs/21713400692

cc @pelikhan @Copilot

AI generated by Smoke Copilot

[github-actions]

📰 VERDICT: Smoke Copilot has concluded. All systems operational. This is a developing story. 🎤

[Copilot]

Pull request overview

This PR adds support for checking out the .agents folder alongside the .github folder in agent jobs. This enables workflows to access skills stored in the new .agents location while maintaining the existing functionality for workflow configurations and runtime imports.

Changes:

• Updated sparse checkout configuration to include .agents folder
• Modified step naming and documentation to reflect both folders
• Added comprehensive test coverage for the new behavior

Reviewed changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 1 comment.

File	Description
pkg/workflow/compiler_yaml_helpers.go	Modified generateCheckoutGitHubFolder() to include .agents in sparse-checkout configuration, updated function documentation and log messages
pkg/workflow/github_folder_checkout_optimization_test.go	Updated test assertions to verify both .github and .agents folders are included in sparse checkout
pkg/workflow/compiler_yaml_helpers_test.go	Added new unit test TestGenerateCheckoutGitHubFolder to verify sparse checkout includes both folders

Comments suppressed due to low confidence (2)

pkg/workflow/compiler_yaml_helpers.go:185

• Inconsistent logger variable usage. This should use compilerYamlHelpersLog instead of compilerYamlLog to be consistent with the rest of the file. See comment on line 178 for details.

	// Skip .github and .agents checkout if an automatic full repository checkout will be added

pkg/workflow/compiler_yaml_helpers.go:192

• Inconsistent logger variable usage. This should use compilerYamlHelpersLog instead of compilerYamlLog to be consistent with the rest of the file. See comment on line 178 for details.

	// For all modes (dev, script, release), checkout .github and .agents folders

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[Copilot]

Inconsistent logger variable usage. This file defines and uses compilerYamlHelpersLog at line 12, and all other functions in this file use that logger (see lines 31, 35, 49, 62). The log statements on lines 178, 185, and 192 should use compilerYamlHelpersLog instead of compilerYamlLog to be consistent with the rest of the file.

This issue also appears in the following locations of the same file:

• line 185
• line 192