gh-aw

When to Use

• Creating new .github/workflows/*.md agentic workflows
• Modifying frontmatter (triggers, permissions, safe-outputs, tools, MCP servers)
• Creating or importing .github/agents/*.md Copilot Custom Agents
• Debugging gh aw compile errors or warnings
• Configuring network access, rate limits, or footer templates

File Layout

.github/
├── workflows/
│   ├── {name}.md              # Frontmatter + thin context dispatcher
│   └── {name}.lock.yml        # Auto-generated — NEVER edit manually
├── agents/
│   └── {name}.md              # Full agent persona (reusable)