Skip to content

Phase 0: Install and initialize gh-aw in .github-private #230

Closed

Description

@don-petry

Context

Part of the GitHub Agentic Workflows rollout planned in Discussion #228.

Phase 0 establishes the foundation before any individual workflows are authored.

Tasks

1. Install gh-aw extension support in CI

Add a step to .github/workflows/lint.yml that installs the gh-aw extension and runs gh aw compile. The step should:

  • Install via curl -sL https://raw.githubusercontent.com/github/gh-aw/main/install-gh-aw.sh | bash
  • Run gh aw compile to validate all *.md workflow files
  • Fail the CI job if compilation fails
  • Only run if .github/workflows/*.md files exist (skip gracefully if none yet)

2. Initialize gh-aw in this repo

Run gh aw init to generate:

  • .github/agents/agentic-workflows.agent.md — the dispatcher agent config
  • Any MCP server integration config

Configure the engine to use Claude (CLAUDE_CODE_OAUTH_TOKEN is already in repo secrets).

3. Write the test convention doc

Create tests/aw/README.md documenting how gh-aw workflows are tested in this repo:

  • Scenario spec format (written before workflow markdown)
  • How to run staged smoke tests (gh aw run <name> --staged)
  • Compile validation as the CI gate
  • Definition of Done checklist

4. Create the tests/aw/ directory structure

Create the directory with the README and placeholder subdirectories for the first two planned workflows:

  • tests/aw/issue-triage/ (empty, with .gitkeep)
  • tests/aw/ci-failure-analyst/ (empty, with .gitkeep)

Acceptance Criteria

  • gh aw compile runs in CI and passes (with zero workflows — baseline)
  • .github/agents/agentic-workflows.agent.md exists and references Claude as engine
  • tests/aw/README.md exists and covers the 3-level test methodology
  • All changes land via a PR (not direct push to main)

Activity

  1. don-petry commented on May 18, 2026

    @don-petry
    CollaboratorAuthor

    @dev-lead please implement this issue. All changes via a PR — no direct pushes to main.

  2. don-petry commented on May 19, 2026

    @don-petry
    CollaboratorAuthor

    Phase 0 complete — PR #276 fully passing (0 failures, 0 pending). Chaining to Phase 1 (#232).

  3. added a commit that references this issue on May 20, 2026
    97b3010
  4. added 5 commits that reference this issue on Jun 7, 2026
    1fb010d
    bb24179
    16c45ea
    a09a724
    d6dba10
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    dev-leadFor dev-lead agent pickup

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions