Skip to content

[aw-daily] GAP-001: Add pre-steps: field to frontmatter-schema.md (v0.68.3) #25

Description

@zircote

Gap Details

Type: missing
File: skills/aw-author/references/frontmatter-schema.md
Section: Quick Index table + Section 8 Steps & Post-Steps

Current Content

The Quick Index table has post-steps and steps entries but no pre-steps entry. Section 8 documents steps and post-steps but has no pre-steps definition.

Expected Content

Quick Index entry:

| `pre-steps` | [Steps & Post-Steps](#8-steps--post-steps) | [link](#pre-steps) |

Section definition (after steps entry, before post-steps):

### `pre-steps`

- **Type:** object | array
- **Required:** no
- **Default:** none
- **Description:** Custom workflow steps that run at the very **beginning** of the agent job, before the repository is checked out.

```yaml
pre-steps:
  - name: Mint app token
    id: app-token
    uses: actions/create-github-app-token@v2
    with:
      app-id: ${{ vars.APP_ID }}
      private-key: ${{ secrets.APP_KEY }}

Use cases:

  • Token minting that must happen before checkout (avoids masked-value cross-job boundary issues with checkout.github-token)
  • Environment preparation required before repository access

Step outputs are available via ${{ steps.<id>.outputs.<name> }} and can be referenced in checkout.github-token.

Same security restrictions apply as for steps: (runs outside the firewall sandbox).


## Source

PR #26607 in github/gh-aw: [Sync github-agentic-workflows.md with v0.68.3](https://github.com/github/gh-aw/pull/26607)

## Intelligence Report

https://github.com/zircote/github-agentic-workflows/discussions/24

---
_Automated by /aw-daily on 2026-04-16_

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

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