[product-manager-impersonator] Example Trigger Lint Gate

Open Beginner friendly
#796 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Assessment

Difficulty
2/5
Estimated time
1-3 hours
Newbie friendliness
78/100
Issue type
Feature
Clarity
Clearly specified
Activity status
Quiet
Tech stack
github-actions
Domain
ci-cd

Research direction

Start in Makefile lines 204-217 and review the existing bin/actionlint loop, then check the example-file guidance in gh-agent-workflows/DEVELOPING.md lines 38 and 204-209. Run make lint-workflows after extending coverage to both example.yml and example.yaml files under gh-agent-workflows; done means all published examples are linted while existing coverage remains intact, with the documentation note added.

Written by the indexing model from the issue text.

Description

Feature Idea

Summary: Add CI linting for all gh-agent-workflows/*/example.yml files so broken copy-paste trigger templates are caught before release.

Why a Customer Would Want This

Teams adopt these workflows by copying example.yml files directly into .github/workflows/. When an example file is invalid, users only discover it after setup, which erodes trust and creates avoidable support churn.

Rough Implementation Sketch

  • Extend make lint-workflows to include gh-agent-workflows/*/example.yml (and .yaml) in the actionlint loop.
  • Keep current lint coverage for claude-workflows examples and .github/workflows/trigger-*.yml; add this as an additional source set.
  • Fail CI when any published example trigger is invalid.
  • Add a short note to gh-agent-workflows/DEVELOPING.md documenting that example.yml must pass workflow lint.

Why It Won't Be That Hard

This is a small, low-risk CI guardrail: mostly a Makefile path expansion plus a docs note. It reuses existing tooling (bin/actionlint) and current lint targets, with no runtime/workflow architecture changes.

Evidence

  • Makefile currently lints claude-workflows examples and selected .github/workflows files, but not gh-agent-workflows/*/example.yml (Makefile:204-217).
  • gh-agent-workflows/DEVELOPING.md defines example.yml as the source users copy into consuming repos (gh-agent-workflows/DEVELOPING.md:38, gh-agent-workflows/DEVELOPING.md:204-209).
  • scripts/quick-setup.sh downloads gh-agent-workflows/$workflow/example.yml directly during setup (scripts/quick-setup.sh:194-203).
  • A recent defect came from an invalid example file and required a fix PR (#712), showing this exact failure mode is real.

[!NOTE]

🔒 Integrity filtering filtered 169 items

Integrity filtering activated and filtered the following items during workflow execution.
This happens when a tool call accesses a resource that does not meet the required integrity or secrecy level of the workflow.

  • issue:elastic/ai-github-actions#795 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#765 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#718 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#749 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#770 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#774 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#779 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#785 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#782 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#786 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#784 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#753 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#783 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#781 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#780 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • issue:elastic/ai-github-actions#778 (list_issues: has lower integrity than agent requires. The agent cannot read data with integrity below "approved".)
  • ... and 153 more items

What is this? | From workflow: Trigger Product Manager Impersonator

Give us feedback! React with 🚀 if perfect, 👍 if helpful, 👎 if not.

Dominant language
Python
Stars
11
Forks
16
Avg merge
11h 16m
Merged PRs (30d)
29

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from elastic/ai-github-actions

All issues in elastic/ai-github-actions

Similar issues

More Python issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.