Skip to main content
GitHub Agentic Workflows
DocsWorkflow examplesBlog
Get started
  • Docs
  • Workflow examples
  • Blog

Documentation

  • Blog
  • Introduction
    • What are Agentic Workflows?
    • How Agentic Workflows Work
    • Security Architecture
  • Setup
    • Quick Start
    • Creating New Workflows
    • Working with Workflows
    • Creation Wizard
    • CLI Commands
  • AI Engines
    • GitHub Copilot
    • Claude Code
    • OpenAI Codex
    • Google Gemini
    • Agy (experimental)
    • Pi
  • Guides
    • GitHub Actions Primer
    • Using MCPs
    • Network Configuration
    • Deploying a Work Queue
    • Agentic Automation Workshop
    • Using at Scale in Organizations
  • Gallery
    • Gallery Overview
    • Issue Triage
    • Pull Request Review
    • Documentation Maintenance
    • Repository Maintenance
    • CI Failure Investigation
    • Code Improvement
    • Dependency Analysis
    • Metrics and Analytics
    • Repository Reporting
    • Security Review
    • Multi-Repository Examples
    • Triage from Side Repo
    • Code Quality Monitoring
    • Feature Synchronization
    • Cross-Repository Issue Tracking
    • Dependabot Rollout
  • Design Patterns
    • BatchOps
    • CentralRepoOps
    • ChatOps
    • Daily Report Portfolio
    • DeterministicOps
    • DispatchOps
    • IssueOps
    • LabelOps
    • Linter Factory
    • MemoryOps
    • MonitorOps
    • FeatureOps
    • MultiRepoOps
    • OrchestratorOps
    • ProjectOps
    • ResearchPlanAssignOps
    • SpecOps
    • WorkQueueOps
  • Practices
    • Measuring Impact
    • Safe Rollout in Organizations
    • Sharing Workflows in Organizations
  • Reference
    • AI Engines
    • AI Engines (Custom)
    • AI Engines (Azure BYOK)
    • Authentication
    • Authentication (Projects)
    • Compilation Process
    • Configuration Governance
    • Cost Management
    • Cost Management (Auditing Workflows)
    • Cost Management (Billing)
    • Cost Management (Rate Limiting)
    • Cost Management (Model Tables)
    • Enterprise Configuration
    • Enterprise Configuration (Compiler Controls)
    • Environment Variables
    • FAQ
    • GH-AW Agent
    • GH-AW as MCP Server
    • GitHub (Checkout)
    • GitHub (Read Tools)
    • GitHub (Read Permissions)
    • GitHub (Integrity Filtering)
    • GitHub (Cross-Repository)
    • GitHub (Fork Support)
    • GitHub (Artifacts)
    • Glossary
    • Imports
    • Imports (APM)
    • Imports (Copilot Agent Files)
    • Imports (Copilot Inline Sub-Agents)
    • Imports (Dependabot)
    • Outcomes
    • OpenTelemetry
    • OpenTelemetry Attributes
    • Package Manifest
    • Releases and Versioning
    • Safe Outputs
    • Safe Outputs (Copilot Cloud Agent)
    • Safe Outputs (Custom)
    • Safe Outputs (Ephemerals)
    • Safe Outputs (Footers)
    • Safe Outputs (Pull Requests)
    • Safe Outputs (Staged Mode)
    • Safe Outputs (Triggering CI)
    • Sandbox
    • Sandbox (Agent Runtimes)
    • Sandbox (MCP Gateway)
    • Sandbox (Network Access)
    • Self-Hosted Runners
    • Self-Hosted Runners (ARC DinD)
    • Threat Detection
    • Tools
    • Tools (Cache Memory)
    • Tools (Repo Memory)
    • Tools (Playwright)
    • Tools (Serena)
    • Tools (Web Search)
    • Work Queues
    • Workflows
    • Workflows (Frontmatter)
    • Workflows (Markdown)
    • Workflows (Triggers)
    • Workflows (Schedule Syntax)
    • Workflows (Command Triggers)
    • Workflows (Concurrency)
    • Workflows (Custom Steps and Jobs)
    • Workflows (Feature Flags)
    • Workflows (MCP Scripts)
    • Workflows (Templating)
    • Workflows (Full)
  • Specs
    • Package Management (Spec)
    • Forecast Command Specification
    • Frontmatter Hash Specification
    • Fuzzy Schedule Time Syntax Specification
    • Graders Specification
    • MCP Scripts Specification
    • Model Alias Format Specification
    • Safe Outputs MCP Gateway Specification
    • AI Credits Specification
    • Checkout Behavior Specification
    • Copilot SDK Driver Specification
    • Unified Agent Session Specification
    • Safe Update Specification
    • Bash Command Parser Specification
    • Git-backed Ledger Specification
    • Work Queue Specification
  • Contributing
    • Error Message Style Guide
  • Troubleshooting
    • Error Reference
    • Common Issues
    • Debugging Workflows
    • Debugging GHE Cloud with Data Residency
  • Experimental
    • A/B Experiments
    • A/B Experiments (Spec)
    • AWF Reflect Route
    • CorrectionOps
    • Drive Memory (Private Preview)
    • Private Repository Enclaves
    • Graders
    • Monitoring with Projects
    • QMD Documentation Search
    • Safe-Outputs Samples
    • TrialOps
    • WASM Compilation
  • Agent Factory
  • Editors
  • About
GitHub
Get started
On this page
  • Overview
  • Abstract
  • Status of This Document
  • Table of Contents
  • 1. Introduction
    • 1.1 Purpose
    • 1.2 Scope
  • 2. Conformance
    • 2.1 Requirements Notation
    • 2.2 Conformance Classes
  • 3. Checkout Model
    • 3.1 Checkout Entry Parsing
    • 3.2 Entry Merge Rules
    • 3.3 Job-specific Checkout Generation
    • 3.4 Checkout Manifest
    • 3.5 Workspace Git-Scan Fallback
  • 4. Authentication and Token Resolution
    • 4.0 Compiler Error Message Requirements
    • 4.1 Checkout Entry Auth
    • 4.2 Activation Job Token
    • 4.3 safe_outputs PR Checkout Token
    • 4.4 Credential Lifecycle Boundary
    • 4.5 Credential-less Safe-outputs MCP Context
  • 5. Sparse, Shallow, Fetch, Symlink, and Submodule Behavior
    • 5.1 Shallow and Additional Fetch
    • 5.2 Sparse Checkout and Partial-clone Repair
    • 5.3 Activation Symlink Handling
    • 5.4 Submodules and Credential Cleanup
  • 6. Trial Mode and Side-Repo Behavior
    • 6.1 Trial Mode Checkout
    • 6.2 Side-Repo Target Derivation
    • 6.3 push_to_pull_request_branch Side-Repo Checkout Resolution
  • 7. Compliance Testing
    • 7.1 Required Tests
    • 7.2 Compliance Checklist
    • 7.3 Safeguards
  • 8. References
    • Normative References
    • Informative References
  • 9. Change Log
    • Version 1.3.1 (Working Draft)
    • Version 1.3.0 (Working Draft)
    • Version 1.2.0 (Working Draft)
    • Version 1.1.0 (Working Draft)
    • Version 1.0.0 (Working Draft)

On this page

  • Overview
  • Abstract
  • Status of This Document
  • Table of Contents
  • 1. Introduction