Skip to content

Add agentic workflow infrastructure and docs-check workflow#56

Merged
theletterf merged 7 commits intomainfrom
add-agentic-workflows
Apr 2, 2026
Merged

Add agentic workflow infrastructure and docs-check workflow#56
theletterf merged 7 commits intomainfrom
add-agentic-workflows

Conversation

@theletterf
Copy link
Copy Markdown
Member

Summary

  • Adds gh-aw agentic workflow support alongside existing composite actions
  • Introduces a workflows/ library layout where .md sources and fragments live, with a scripts/compile.sh that bridges them to .github/workflows/ for the gh-aw compiler
  • First workflow: docs-check — analyzes PRs/commits for Elastic documentation impact via the Elastic Docs MCP server, triggered by /docs-check slash command, label, or manual dispatch
  • CI: compile-check.yml gates PRs on stale lock files; check-aw-updates.yml recompiles weekly and opens a PR if anything changed

What's included

Area Files
Build tooling Makefile, scripts/compile.sh
Workflow source workflows/docs-check/gh-aw-docs-check.md
Shared fragments workflows/fragments/ (10 files)
Trigger template workflows/docs-check/example.yml
CI workflows compile-check.yml, check-aw-updates.yml
Documentation README.md, workflows/DEVELOPING.md, workflows/README.md, workflows/docs-check/README.md

Note

The .lock.yml file is not yet included — it needs to be generated by running make compile (requires Go for the gh-aw compiler). This can be done as a follow-up or in this PR after review.

Test plan

  • Run make setup && make compile to verify compilation produces gh-aw-docs-check.lock.yml
  • Verify .lock.yml is gitignored from source but the compiled output lands in .github/workflows/
  • Review scripts/compile.sh cleanup logic (temp copies removed after compile)
  • Validate workflows/docs-check/example.yml with actionlint

🤖 Generated with Claude Code

Introduces gh-aw agentic workflow support alongside the existing composite
actions. Workflow .md sources live in workflows/ as a library; a compile
script copies them into .github/workflows/ for the gh-aw compiler and
produces .lock.yml files that consumer repos reference via workflow_call.

First workflow: docs-check — analyzes PRs/commits for documentation impact
using the Elastic Docs MCP server and posts structured findings as comments.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@theletterf theletterf self-assigned this Apr 2, 2026
@theletterf theletterf added the enhancement New feature or request label Apr 2, 2026
Replace go install with gh extension install for the gh-aw compiler.
Drop actionlint binary download — the repo already has it via pre-commit.
Remove bin/ dependency entirely.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
theletterf and others added 2 commits April 2, 2026 12:10
- Move `roles` under `on:` (latest gh-aw schema change)
- Exclude .lock.yml from pre-commit trailing-whitespace and end-of-file-fixer
- Replace custom lint/release Makefile targets with `pre-commit run --all`
- Remove release target (release-drafter handles releases)
- Recompile lock file with latest gh-aw

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Update gh-aw extension (v0.63.0 → v0.65.5) and recompile lock file
- Exclude .lock.yml from actionlint pre-commit hook (generated files
  reference secrets injected by the gh-aw runtime)
- Fix .gitattributes missing trailing newline

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Update all references in compile script, Makefile, CI, README,
DEVELOPING.md, and workflow docs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@theletterf theletterf requested a review from reakaleek April 2, 2026 10:26
theletterf and others added 2 commits April 2, 2026 12:42
Interactive skill that scaffolds the three required files for a new
gh-aw agentic workflow: source .md, example.yml trigger, and README.
Guides users through pattern selection, trigger config, and prompt
structure.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Add Step 3 that reads available fragments, explains what each provides
and when to include it, documents import rules, and guides users on
when to create new fragments vs. reuse existing ones.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@theletterf
Copy link
Copy Markdown
Member Author

@reakaleek Renamed! Also added a Claude skill to help create more AWs

@theletterf theletterf merged commit ba3ac52 into main Apr 2, 2026
4 checks passed
@theletterf theletterf deleted the add-agentic-workflows branch April 2, 2026 12:42
cotti pushed a commit that referenced this pull request Apr 7, 2026
* Add agentic workflow infrastructure and docs-check workflow

Introduces gh-aw agentic workflow support alongside the existing composite
actions. Workflow .md sources live in workflows/ as a library; a compile
script copies them into .github/workflows/ for the gh-aw compiler and
produces .lock.yml files that consumer repos reference via workflow_call.

First workflow: docs-check — analyzes PRs/commits for documentation impact
using the Elastic Docs MCP server and posts structured findings as comments.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Simplify tooling: use gh extension instead of Go binary

Replace go install with gh extension install for the gh-aw compiler.
Drop actionlint binary download — the repo already has it via pre-commit.
Remove bin/ dependency entirely.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Fix CI failures and address review feedback

- Move `roles` under `on:` (latest gh-aw schema change)
- Exclude .lock.yml from pre-commit trailing-whitespace and end-of-file-fixer
- Replace custom lint/release Makefile targets with `pre-commit run --all`
- Remove release target (release-drafter handles releases)
- Recompile lock file with latest gh-aw

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Fix CI: recompile with latest gh-aw, exclude lock files from actionlint

- Update gh-aw extension (v0.63.0 → v0.65.5) and recompile lock file
- Exclude .lock.yml from actionlint pre-commit hook (generated files
  reference secrets injected by the gh-aw runtime)
- Fix .gitattributes missing trailing newline

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Rename workflows/ to agentic-workflows/

Update all references in compile script, Makefile, CI, README,
DEVELOPING.md, and workflow docs.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Add /create-agentic-workflow Claude skill

Interactive skill that scaffolds the three required files for a new
gh-aw agentic workflow: source .md, example.yml trigger, and README.
Guides users through pattern selection, trigger config, and prompt
structure.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

* Teach skill about fragment selection and creation

Add Step 3 that reads available fragments, explains what each provides
and when to include it, documents import rules, and guides users on
when to create new fragments vs. reuse existing ones.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants