Skip to content

Project Summary

Create a periodic project summary issue covering recent activity, priorities, and next steps.

How it works

Finds the last project summary issue to determine the reporting window, then collects commits, opened and merged PRs, and updated issues. Highlights items needing attention — stale reviews, blocking issues, decisions needed — in a concise periodic report.

Quick Install

mkdir -p .github/workflows && curl -sL \
  https://raw.githubusercontent.com/elastic/ai-github-actions/v0/gh-agent-workflows/project-summary/example.yml \
  -o .github/workflows/project-summary.yml

Trigger

Event Schedule
schedule Daily
workflow_dispatch Manual

Inputs

Input Description Required Default
additional-instructions Repo-specific instructions appended to the agent prompt No ""
setup-commands Shell commands run before the agent starts No ""
allowed-bot-users Allowlisted bot actor usernames (comma-separated) No github-actions[bot]

Safe Outputs

  • create-issue — file a project summary report (max 1, auto-closes older reports)

Example Workflow

name: Project Summary
on:
  schedule:
    - cron: "0 9 * * *"
  workflow_dispatch:

permissions:
  contents: read
  issues: write
  pull-requests: read

jobs:
  run:
    uses: elastic/ai-github-actions/.github/workflows/gh-aw-project-summary.lock.yml@v0
    secrets:
      COPILOT_GITHUB_TOKEN: ${{ secrets.COPILOT_GITHUB_TOKEN }}