Skip to content

Split out Elastic-specific workflows with estc- prefix#431

Merged
strawgate merged 6 commits intomainfrom
copilot/split-out-elastic-workflows
Feb 27, 2026
Merged

Split out Elastic-specific workflows with estc- prefix#431
strawgate merged 6 commits intomainfrom
copilot/split-out-elastic-workflows

Conversation

Copy link
Contributor

Copilot AI commented Feb 26, 2026

Several workflows are only useful within Elastic (they reference elastic.co/docs, Elastic style and applies_to conventions, Buildkite CI, or Elastic-owned downstream repositories). This PR makes those workflows explicitly Elastic-specific in both naming and docs.

Changes

Renamed workflows with estc- prefix

  • docs-patrol-externalestc-docs-patrol-external
  • newbie-contributor-patrol-externalestc-newbie-contributor-patrol-external
  • docs-pr-reviewestc-docs-pr-review
  • downstream-healthestc-downstream-health
  • pr-buildkite-detectiveestc-pr-buildkite-detective

Documentation updates

  • Added an Elastic-specific workflows section to:
    • docs/workflows/gh-agent-workflows.md
    • gh-agent-workflows/README.md
  • Updated mkdocs.yml navigation to group estc- workflows under an Elastic-specific section.

Associated rename/reference updates

  • Updated compiled workflow files (.lock.yml) and source workflow files (.md) for each renamed workflow.

  • Renamed matching trigger workflows for:

    • estc-docs-pr-review
    • estc-downstream-health
    • estc-pr-buildkite-detective
  • Updated related references in per-workflow README.md/example.yml files, smoke-test install workflow, dogfood exclusions, docs overview pages, and blog links.

  • Fixes Split out Elastic specific workflows #428

Generated by Update PR Body for issue #431

Summary by CodeRabbit

  • Documentation

    • Updated docs, blog posts, examples, and site navigation to introduce and link Elastic-specific workflow variants labeled "(Elastic-specific)"; refreshed installation and example commands.
  • Chores

    • Renamed many workflow names, identifiers, and references to Elastic-specific variants for clearer discovery and grouping.
    • Updated workflow lists and install/trigger references and adjusted smoke-test and tooling exclusions to use the new identifiers.

… section in docs

Co-authored-by: strawgate <6384545+strawgate@users.noreply.github.com>
Copilot AI changed the title [WIP] Split out Elastic specific workflows in documentation Split out Elastic-specific workflows with estc- prefix Feb 26, 2026
@strawgate strawgate marked this pull request as ready for review February 26, 2026 23:03
@coderabbitai
Copy link

coderabbitai bot commented Feb 26, 2026

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between c4fe427 and ab0596b.

📒 Files selected for processing (17)
  • .github/aw/actions-lock.json
  • .github/workflows/gh-aw-estc-docs-patrol-external.lock.yml
  • .github/workflows/gh-aw-estc-docs-patrol-external.md
  • .github/workflows/gh-aw-estc-docs-pr-review.lock.yml
  • .github/workflows/gh-aw-estc-docs-pr-review.md
  • .github/workflows/gh-aw-estc-downstream-health.lock.yml
  • .github/workflows/gh-aw-estc-downstream-health.md
  • .github/workflows/gh-aw-estc-newbie-contributor-patrol-external.lock.yml
  • .github/workflows/gh-aw-estc-newbie-contributor-patrol-external.md
  • .github/workflows/gh-aw-estc-pr-buildkite-detective.lock.yml
  • .github/workflows/gh-aw-estc-pr-buildkite-detective.md
  • .github/workflows/smoke-test-install.yml
  • .github/workflows/trigger-estc-pr-buildkite-detective.yml
  • docs/workflows/gh-agent-workflows.md
  • gh-agent-workflows/README.md
  • gh-agent-workflows/estc-pr-buildkite-detective/README.md
  • gh-agent-workflows/estc-pr-buildkite-detective/example.yml

📝 Walkthrough

Walkthrough

Renames many GitHub Actions workflows, lockfiles, examples, and docs to use "estc" / "(Elastic-specific)" variants; updates references, example workflows, mkdocs navigation, and dogfooding exclusions. Changes are textual/identifier updates; no control-flow or behavioral changes were introduced.

Changes

Cohort / File(s) Summary
Workflow lockfiles
.github/workflows/gh-aw-estc-*.lock.yml, .github/workflows/gh-aw-estc-*.md
Rebranded workflow names, run-names, concurrency groups, and GH_AW_* identifiers to ESTC-prefixed variants; updates to frontmatter hashes. No behavioral changes.
Trigger & install workflows
.github/workflows/trigger-estc-*.yml, .github/workflows/smoke-test-install.yml, .github/workflows/*.yml
Repointed triggers, lockfile references, and install lists to ESTC-specific lockfiles and workflow IDs.
Examples & gh-agent-workflows READMEs
gh-agent-workflows/estc-*/example.yml, gh-agent-workflows/estc-*/README.md, gh-agent-workflows/README.md
Renamed example workflow titles and updated curl/example commands and referenced lockfile paths to ESTC variants; added Elastic-specific section in README.
Docs & Blog posts
docs/workflows/*, docs/blog/posts/*.md, docs/workflows/gh-agent-workflows.md
Renamed headings and links to "(Elastic-specific)" variants, restructured docs to add an "Elastic-specific workflows" block and moved/added ESTC entries.
Site nav / mkdocs
mkdocs.yml
Removed some generic workflow nav entries and added an Elastic-specific group listing the ESTC workflow pages.
Tooling scripts
scripts/dogfood.sh
Updated EXCLUDED_WORKFLOWS literals to reference ESTC-prefixed workflow identifiers.
Actions lockfile
.github/aw/actions-lock.json
Appended/updated an actions entry (added github/gh-aw/actions/setup@v0.50.5).

Sequence Diagram(s)

(omitted — changes are renames/string updates and do not introduce new multi-component control flow)

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

Possibly related PRs

Suggested reviewers

  • github-actions

Poem

🐰 I hopped through YAML, titles spry,
Switched names to "estc" with a cheerful cry.
Links updated, examples neat,
Docs and workflows now align and meet.
A carrot for consistency — hop, hop, repeat! 🥕

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name Status Explanation Resolution
Out of Scope Changes check ⚠️ Warning An expanded .github/workflows/gh-aw-estc-pr-buildkite-detective.md with 40 lines of new documentation/logic changes extends beyond simple renaming, potentially introducing new functionality unrelated to the core 'estc-' prefix objective. Review the PR buildkite detective changes to confirm they are essential to the split or separate them into a follow-up PR addressing the Buildkite token/MCP fallback implementation.
✅ Passed checks (4 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Title check ✅ Passed The title clearly describes the main change: renaming and organizing workflows with an 'estc-' prefix to distinguish Elastic-specific workflows from generic ones.
Linked Issues check ✅ Passed All code changes align with issue #428 objectives: introducing 'estc-' prefix naming convention [#428], grouping Elastic-specific workflows separately in documentation [#428], and applying the convention to relevant workflows [#428].
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.

✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch copilot/split-out-elastic-workflows

Comment @coderabbitai help to get the list of available commands and usage tips.

@strawgate
Copy link
Collaborator

/ai estc is the shorthand, in the Docs we should call them Elastic-specific workflows

Copy link

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Caution

Some comments are outside the diff and can’t be posted inline due to platform limitations.

⚠️ Outside diff range comments (3)
.github/workflows/gh-aw-estc-pr-buildkite-detective.lock.yml (1)

134-134: ⚠️ Potential issue | 🟠 Major

Stale workflow file reference may cause runtime failure.

GH_AW_WORKFLOW_FILE still references "gh-aw-pr-buildkite-detective.lock.yml" (the old filename without estc- prefix), but this file has been renamed to gh-aw-estc-pr-buildkite-detective.lock.yml. The timestamp check step may fail because it's looking for a non-existent file.

Since this is an auto-generated .lock.yml file, the fix must be applied to the corresponding source .md file and recompiled with gh aw compile.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/workflows/gh-aw-estc-pr-buildkite-detective.lock.yml at line 134,
Update the source .md that generates the auto-generated lock file so the
GH_AW_WORKFLOW_FILE variable uses the new filename
"gh-aw-estc-pr-buildkite-detective.lock.yml" instead of the old
"gh-aw-pr-buildkite-detective.lock.yml", then re-run the generator with "gh aw
compile" so the .lock.yml is regenerated with the correct GH_AW_WORKFLOW_FILE
value; look for the variable named GH_AW_WORKFLOW_FILE in the template/source
that produces the .lock.yml to make this change.
.github/workflows/gh-aw-estc-docs-patrol-external.lock.yml (1)

134-135: ⚠️ Potential issue | 🟠 Major

Stale workflow file reference may cause runtime failure.

GH_AW_WORKFLOW_FILE still references "gh-aw-docs-patrol-external.lock.yml" (the old filename without estc- prefix), but this file has been renamed to gh-aw-estc-docs-patrol-external.lock.yml. The timestamp check step may fail because it's looking for a non-existent file.

Since this is an auto-generated .lock.yml file, the fix must be applied to the corresponding source .md file and recompiled with gh aw compile.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/workflows/gh-aw-estc-docs-patrol-external.lock.yml around lines 134
- 135, Update the GH_AW_WORKFLOW_FILE env var so it points to the renamed
workflow file: replace the old value "gh-aw-docs-patrol-external.lock.yml" with
"gh-aw-estc-docs-patrol-external.lock.yml" by editing the source .md that
generates this .lock.yml (do not edit the generated .lock.yml directly), then
recompile the workflow using the command `gh aw compile` so the change is
propagated into the generated GH Actions workflow; look for the env block that
sets GH_AW_WORKFLOW_FILE in the generated file to confirm the updated value.
.github/workflows/gh-aw-estc-downstream-health.lock.yml (1)

127-130: ⚠️ Potential issue | 🔴 Critical

Rename is incomplete: timestamp check still references the old lock filename.

At Line 129, GH_AW_WORKFLOW_FILE is still gh-aw-downstream-health.lock.yml, but this workflow now runs from gh-aw-estc-downstream-health.lock.yml. This can make the timestamp validation step check the wrong file (or fail), causing incorrect workflow health behavior.

Suggested fix
-          GH_AW_WORKFLOW_FILE: "gh-aw-downstream-health.lock.yml"
+          GH_AW_WORKFLOW_FILE: "gh-aw-estc-downstream-health.lock.yml"

Then regenerate this .lock.yml from its source .md.

Based on learnings: In this repository, .lock.yml files are auto-generated by gh aw compile; changes must be made in the source .md and then recompiled.

🤖 Prompt for AI Agents
Verify each finding against the current code and only fix it if needed.

In @.github/workflows/gh-aw-estc-downstream-health.lock.yml around lines 127 -
130, The env variable GH_AW_WORKFLOW_FILE still points to
"gh-aw-downstream-health.lock.yml" but this workflow file is now
"gh-aw-estc-downstream-health.lock.yml", so update the GH_AW_WORKFLOW_FILE value
to "gh-aw-estc-downstream-health.lock.yml" where it’s defined (the
actions/github-script step) so the timestamp validation checks the correct lock
file, then regenerate this .lock.yml from its source .md using the repository’s
gh aw compile flow to ensure the change is persisted and consistent with the
auto-generated workflow.
🤖 Prompt for all review comments with AI agents
Verify each finding against the current code and only fix it if needed.

Outside diff comments:
In @.github/workflows/gh-aw-estc-docs-patrol-external.lock.yml:
- Around line 134-135: Update the GH_AW_WORKFLOW_FILE env var so it points to
the renamed workflow file: replace the old value
"gh-aw-docs-patrol-external.lock.yml" with
"gh-aw-estc-docs-patrol-external.lock.yml" by editing the source .md that
generates this .lock.yml (do not edit the generated .lock.yml directly), then
recompile the workflow using the command `gh aw compile` so the change is
propagated into the generated GH Actions workflow; look for the env block that
sets GH_AW_WORKFLOW_FILE in the generated file to confirm the updated value.

In @.github/workflows/gh-aw-estc-downstream-health.lock.yml:
- Around line 127-130: The env variable GH_AW_WORKFLOW_FILE still points to
"gh-aw-downstream-health.lock.yml" but this workflow file is now
"gh-aw-estc-downstream-health.lock.yml", so update the GH_AW_WORKFLOW_FILE value
to "gh-aw-estc-downstream-health.lock.yml" where it’s defined (the
actions/github-script step) so the timestamp validation checks the correct lock
file, then regenerate this .lock.yml from its source .md using the repository’s
gh aw compile flow to ensure the change is persisted and consistent with the
auto-generated workflow.

In @.github/workflows/gh-aw-estc-pr-buildkite-detective.lock.yml:
- Line 134: Update the source .md that generates the auto-generated lock file so
the GH_AW_WORKFLOW_FILE variable uses the new filename
"gh-aw-estc-pr-buildkite-detective.lock.yml" instead of the old
"gh-aw-pr-buildkite-detective.lock.yml", then re-run the generator with "gh aw
compile" so the .lock.yml is regenerated with the correct GH_AW_WORKFLOW_FILE
value; look for the variable named GH_AW_WORKFLOW_FILE in the template/source
that produces the .lock.yml to make this change.

ℹ️ Review info

Configuration used: Repository UI (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between b056f17 and 0ffa421.

📒 Files selected for processing (35)
  • .github/workflows/gh-aw-estc-docs-patrol-external.lock.yml
  • .github/workflows/gh-aw-estc-docs-patrol-external.md
  • .github/workflows/gh-aw-estc-docs-pr-review.lock.yml
  • .github/workflows/gh-aw-estc-docs-pr-review.md
  • .github/workflows/gh-aw-estc-downstream-health.lock.yml
  • .github/workflows/gh-aw-estc-downstream-health.md
  • .github/workflows/gh-aw-estc-newbie-contributor-patrol-external.lock.yml
  • .github/workflows/gh-aw-estc-newbie-contributor-patrol-external.md
  • .github/workflows/gh-aw-estc-pr-buildkite-detective.lock.yml
  • .github/workflows/gh-aw-estc-pr-buildkite-detective.md
  • .github/workflows/smoke-test-install.yml
  • .github/workflows/trigger-estc-docs-pr-review.yml
  • .github/workflows/trigger-estc-downstream-health.yml
  • .github/workflows/trigger-estc-pr-buildkite-detective.yml
  • docs/blog/posts/meet-the-detectives.md
  • docs/blog/posts/meet-the-docs-patrol.md
  • docs/blog/posts/meet-the-reviewers.md
  • docs/blog/posts/meet-the-watchdogs.md
  • docs/workflows/gh-agent-workflows.md
  • docs/workflows/gh-agent-workflows/docs-patrol-overview.md
  • docs/workflows/gh-agent-workflows/newbie-contributor.md
  • gh-agent-workflows/README.md
  • gh-agent-workflows/estc-docs-patrol-external/README.md
  • gh-agent-workflows/estc-docs-patrol-external/example.yml
  • gh-agent-workflows/estc-docs-pr-review/README.md
  • gh-agent-workflows/estc-docs-pr-review/dogfood-with.yml
  • gh-agent-workflows/estc-docs-pr-review/example.yml
  • gh-agent-workflows/estc-downstream-health/README.md
  • gh-agent-workflows/estc-downstream-health/example.yml
  • gh-agent-workflows/estc-newbie-contributor-patrol-external/README.md
  • gh-agent-workflows/estc-newbie-contributor-patrol-external/example.yml
  • gh-agent-workflows/estc-pr-buildkite-detective/README.md
  • gh-agent-workflows/estc-pr-buildkite-detective/example.yml
  • mkdocs.yml
  • scripts/dogfood.sh

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@cla-checker-service
Copy link

❌ Author of the following commits did not sign a Contributor Agreement:
, , c4fe427

Please, read and sign the above mentioned agreement if you want to contribute to this project

@strawgate
Copy link
Collaborator

/ai i dont think estc-pr-buildkite-detective is elastic specific just because an input defaults to elastic, can you review all of the workflows you marked as elastic specific and share why you marked them?

@github-actions
Copy link
Contributor

Good catch — after re-checking each workflow, pr-buildkite-detective does not look intrinsically Elastic-specific, while the other four do.

Why each was marked:

  • docs-patrol-external: explicitly targets published Elastic docs and applies_to/backport conventions (gh-agent-workflows/docs-patrol-external/README.md:3,7).
  • newbie-contributor-patrol-external: explicitly cross-references elastic.co/docs (gh-agent-workflows/newbie-contributor-patrol-external/README.md:7).
  • docs-pr-review: scoped to Elastic technical writing conventions (Elastic style guide, applies_to, Elastic docs MCP) (gh-agent-workflows/docs-pr-review/README.md:3,8-10).
  • downstream-health: explicitly discovers elastic-owned repos (gh-agent-workflows/downstream-health/README.md:7).

For pr-buildkite-detective, the current workflow is mostly provider-specific (Buildkite), not Elastic-specific; buildkite-org is configurable and only defaults to elastic (gh-agent-workflows/pr-buildkite-detective/README.md:33, gh-agent-workflows/pr-buildkite-detective/example.yml:21-22).

So I agree with your concern: this one should likely stay generic unless we add truly Elastic-only behavior.


What is this? | From workflow: Mention in PR

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

@strawgate strawgate merged commit 7c0ed60 into main Feb 27, 2026
6 of 7 checks passed
@strawgate strawgate deleted the copilot/split-out-elastic-workflows branch February 27, 2026 00:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Split out Elastic specific workflows

2 participants