Copilot Coding Agent Workspace
AGENTS.md plus scoped .instructions.md files, custom agents, skills, and hooks designed for GitHub's autonomous Coding Agent.
Description
GitHub's Copilot Coding Agent (GA 2025) works autonomously in the background on assigned issues. It reads AGENTS.md from the repo root for global instructions, plus nested AGENTS.md for subdirectory-specific context. The awesome-copilot repository by GitHub defines the full structure: .github/instructions/ for coding standards, agents/ for specialized AI personas, hooks/ for automated event triggers (sessionStart, userPromptSubmitted), skills/ for domain-specific capabilities, and workflows/ for GitHub Actions automation. Custom agents use .agent.md files. The Coding Agent also reads CLAUDE.md and GEMINI.md files if present, making it highly interoperable.
Who is this for
Teams using GitHub Copilot Business or Enterprise who want to delegate issue resolution to the autonomous Coding Agent.
Why files are split this way
The Coding Agent operates without human interaction during a session. It needs everything upfront: how to build, how to test, how to lint, what conventions to follow. Path-specific instructions prevent the agent from applying wrong rules to wrong files. Hooks automate quality gates. Skills provide domain expertise. Each piece reduces the chance of a PR getting rejected.
What changed from the previous setup
A simple copilot-instructions.md with basic coding standards — no path-specific instructions, agents, or hooks.
Related patterns
Universal AGENT.md with Symlinks
One AGENT.md file as the single source of truth, with symlinks to CLAUDE.md, .cursorrules, .windsurfrules, and copilot-instructions.md.
Multi-Editor Frontend Setup
Frontend-optimized AI config covering design system tokens, component conventions, and testing patterns across Cursor, Copilot, and Claude Code simultaneously.
Copilot Custom Instructions
Repository-wide copilot-instructions.md plus path-specific .instructions.md files with applyTo frontmatter for scoped guidance.