Skip to content

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

@zircote

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_

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions