From b3b064c1432031636cba22006177e7398ad4b259 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 22 May 2026 13:24:37 +0000 Subject: [PATCH 1/5] Initial plan From d6de21dd44442975c6c64d8fd4a8c4836b4d0576 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 22 May 2026 13:31:20 +0000 Subject: [PATCH 2/5] Plan docs URL update for workflow install issue Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- .github/aw/actions-lock.json | 5 +++++ .github/workflows/release.lock.yml | 6 +++--- 2 files changed, 8 insertions(+), 3 deletions(-) diff --git a/.github/aw/actions-lock.json b/.github/aw/actions-lock.json index 334d0b7954e..828732d7e61 100644 --- a/.github/aw/actions-lock.json +++ b/.github/aw/actions-lock.json @@ -138,6 +138,11 @@ "version": "v4.1.0", "sha": "4907a6ddec9925e35a0a9e82d7399ccc52663121" }, + "docker/metadata-action@v6": { + "repo": "docker/metadata-action", + "version": "v6", + "sha": "80c7e94dd9b9319bd5eb7a0e0fe9291e23a2a2e9" + }, "docker/metadata-action@v6.0.0": { "repo": "docker/metadata-action", "version": "v6.0.0", diff --git a/.github/workflows/release.lock.yml b/.github/workflows/release.lock.yml index 345e02e8eff..d9aaa5d6eba 100644 --- a/.github/workflows/release.lock.yml +++ b/.github/workflows/release.lock.yml @@ -1,5 +1,5 @@ # gh-aw-metadata: {"schema_version":"v3","frontmatter_hash":"6a6bd39e2339b2b176862a0fceb3dc70c2440fe79b8689f4e476134a57bed33a","strict":true,"agent_id":"copilot"} -# gh-aw-manifest: {"version":1,"secrets":["COPILOT_GITHUB_TOKEN","GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GH_AW_OTEL_GRAFANA_AUTHORIZATION","GH_AW_OTEL_GRAFANA_ENDPOINT","GH_AW_OTEL_SENTRY_AUTHORIZATION","GH_AW_OTEL_SENTRY_ENDPOINT","GITHUB_TOKEN"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"3a2844b7e9c422d3c10d287c895573f7108da1b3","version":"v9.0.0"},{"repo":"actions/setup-go","sha":"4a3601121dd01d1626a1e23e37211e3254c1c06c","version":"v6.4.0"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"anchore/sbom-action","sha":"e22c389904149dbc22b58101806040fa8d37a610","version":"v0.24.0"},{"repo":"docker/build-push-action","sha":"bcafcacb16a39f128d818304e6c9c0c18556b85f","version":"v7.1.0"},{"repo":"docker/login-action","sha":"4907a6ddec9925e35a0a9e82d7399ccc52663121","version":"v4.1.0"},{"repo":"docker/metadata-action","sha":"030e881283bb7a6894de51c315a6bfe6a94e05cf","version":"v6.0.0 (source v6)"},{"repo":"docker/setup-buildx-action","sha":"4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd","version":"v4.0.0 (source v4)"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.51"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.51"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.51"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.3.17"},{"image":"ghcr.io/github/github-mcp-server:v1.0.4"},{"image":"node:lts-alpine","digest":"sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f","pinned_image":"node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f"}]} +# gh-aw-manifest: {"version":1,"secrets":["COPILOT_GITHUB_TOKEN","GH_AW_GITHUB_MCP_SERVER_TOKEN","GH_AW_GITHUB_TOKEN","GH_AW_OTEL_GRAFANA_AUTHORIZATION","GH_AW_OTEL_GRAFANA_ENDPOINT","GH_AW_OTEL_SENTRY_AUTHORIZATION","GH_AW_OTEL_SENTRY_ENDPOINT","GITHUB_TOKEN"],"actions":[{"repo":"actions/checkout","sha":"de0fac2e4500dabe0009e67214ff5f5447ce83dd","version":"v6.0.2"},{"repo":"actions/download-artifact","sha":"3e5f45b2cfb9172054b4087a40e8e0b5a5461e7c","version":"v8.0.1"},{"repo":"actions/github-script","sha":"3a2844b7e9c422d3c10d287c895573f7108da1b3","version":"v9.0.0"},{"repo":"actions/setup-go","sha":"4a3601121dd01d1626a1e23e37211e3254c1c06c","version":"v6.4.0"},{"repo":"actions/upload-artifact","sha":"043fb46d1a93c77aae656e7c1c64a875d1fc6a0a","version":"v7.0.1"},{"repo":"anchore/sbom-action","sha":"e22c389904149dbc22b58101806040fa8d37a610","version":"v0.24.0"},{"repo":"docker/build-push-action","sha":"bcafcacb16a39f128d818304e6c9c0c18556b85f","version":"v7.1.0"},{"repo":"docker/login-action","sha":"4907a6ddec9925e35a0a9e82d7399ccc52663121","version":"v4.1.0"},{"repo":"docker/metadata-action","sha":"80c7e94dd9b9319bd5eb7a0e0fe9291e23a2a2e9","version":"v6"},{"repo":"docker/setup-buildx-action","sha":"4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd","version":"v4.0.0 (source v4)"}],"containers":[{"image":"ghcr.io/github/gh-aw-firewall/agent:0.25.51"},{"image":"ghcr.io/github/gh-aw-firewall/api-proxy:0.25.51"},{"image":"ghcr.io/github/gh-aw-firewall/squid:0.25.51"},{"image":"ghcr.io/github/gh-aw-mcpg:v0.3.17"},{"image":"ghcr.io/github/github-mcp-server:v1.0.4"},{"image":"node:lts-alpine","digest":"sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f","pinned_image":"node:lts-alpine@sha256:d1b3b4da11eefd5941e7f0b9cf17783fc99d9c6fc34884a665f40a06dbdfc94f"}]} # ___ _ _ # / _ \ | | (_) # | |_| | __ _ ___ _ __ | |_ _ ___ @@ -49,7 +49,7 @@ # - anchore/sbom-action@e22c389904149dbc22b58101806040fa8d37a610 # v0.24.0 # - docker/build-push-action@bcafcacb16a39f128d818304e6c9c0c18556b85f # v7.1.0 # - docker/login-action@4907a6ddec9925e35a0a9e82d7399ccc52663121 # v4.1.0 -# - docker/metadata-action@030e881283bb7a6894de51c315a6bfe6a94e05cf # v6.0.0 (source v6) +# - docker/metadata-action@80c7e94dd9b9319bd5eb7a0e0fe9291e23a2a2e9 # v6 # - docker/setup-buildx-action@4d04d5d9486b7bd6fa91e7baf45bbb4f8b9deedd # v4.0.0 (source v4) # # Container images used: @@ -1541,7 +1541,7 @@ jobs: username: ${{ github.actor }} - name: Extract metadata for Docker id: meta - uses: docker/metadata-action@030e881283bb7a6894de51c315a6bfe6a94e05cf # v6.0.0 (source v6) + uses: docker/metadata-action@80c7e94dd9b9319bd5eb7a0e0fe9291e23a2a2e9 # v6 with: images: ghcr.io/${{ github.repository }} tags: | From bd28a1b9a735d61757bff5d34039223f9b4f51f1 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 22 May 2026 13:38:43 +0000 Subject: [PATCH 3/5] Update blog workflow links to githubnext/agentics Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- ...3-meet-the-workflows-advanced-analytics.md | 16 ++-- ...2026-01-13-meet-the-workflows-campaigns.md | 8 +- ...et-the-workflows-continuous-improvement.md | 16 ++-- ...et-the-workflows-continuous-refactoring.md | 8 +- ...eet-the-workflows-continuous-simplicity.md | 8 +- ...-13-meet-the-workflows-continuous-style.md | 4 +- ...-13-meet-the-workflows-creative-culture.md | 20 ++--- ...-01-13-meet-the-workflows-documentation.md | 28 +++--- ...-meet-the-workflows-interactive-chatops.md | 12 +-- ...-13-meet-the-workflows-issue-management.md | 16 ++-- ...13-meet-the-workflows-metrics-analytics.md | 12 +-- ...3-meet-the-workflows-operations-release.md | 6 +- ...6-01-13-meet-the-workflows-organization.md | 12 +-- ...1-13-meet-the-workflows-quality-hygiene.md | 12 +-- ...-meet-the-workflows-security-compliance.md | 20 ++--- ...3-meet-the-workflows-testing-validation.md | 24 ++--- ...-meet-the-workflows-tool-infrastructure.md | 12 +-- .../blog/2026-01-13-meet-the-workflows.md | 4 +- .../docs/blog/2026-01-21-twelve-lessons.md | 12 +-- .../docs/blog/2026-01-24-design-patterns.md | 88 +++++++++---------- .../blog/2026-01-27-operational-patterns.md | 8 +- .../blog/2026-01-30-imports-and-sharing.md | 56 ++++++------ .../docs/blog/2026-02-02-security-lessons.md | 12 +-- .../blog/2026-02-05-how-workflows-work.md | 2 +- .../docs/blog/2026-03-18-weekly-update.md | 2 +- .../docs/blog/2026-03-23-weekly-update.md | 2 +- .../docs/blog/2026-03-30-weekly-update.md | 2 +- .../docs/blog/2026-04-06-weekly-update.md | 2 +- .../docs/blog/2026-04-13-weekly-update.md | 2 +- .../docs/blog/2026-04-20-weekly-update.md | 2 +- .../docs/blog/2026-04-27-weekly-update.md | 2 +- .../docs/blog/2026-05-04-weekly-update.md | 2 +- .../docs/blog/2026-05-11-weekly-update.md | 2 +- 33 files changed, 217 insertions(+), 217 deletions(-) diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-advanced-analytics.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-advanced-analytics.md index 0a221bdd2a8..7545e44d56a 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-advanced-analytics.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-advanced-analytics.md @@ -28,10 +28,10 @@ Beyond tracking basic metrics (run time, cost, success rate), we wanted deeper i These agents use sophisticated analysis techniques to extract insights: -- **[Copilot Session Insights](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-session-insights.md?plain=1)** - Analyzes Copilot coding agent usage patterns and metrics - **32 analysis discussions** -- **[Copilot PR NLP Analysis](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-pr-nlp-analysis.md?plain=1)** - Natural language processing on PR conversations -- **[Prompt Clustering Analysis](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/prompt-clustering-analysis.md?plain=1)** - Clusters and categorizes agent prompts using ML - **27 analysis discussions** -- **[Copilot Agent Analysis](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-agent-analysis.md?plain=1)** - Deep analysis of agent behavior patterns - **48 daily analysis discussions** +- **[Copilot Session Insights](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-session-insights.md?plain=1)** - Analyzes Copilot coding agent usage patterns and metrics - **32 analysis discussions** +- **[Copilot PR NLP Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-pr-nlp-analysis.md?plain=1)** - Natural language processing on PR conversations +- **[Prompt Clustering Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/prompt-clustering-analysis.md?plain=1)** - Clusters and categorizes agent prompts using ML - **27 analysis discussions** +- **[Copilot Agent Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-agent-analysis.md?plain=1)** - Deep analysis of agent behavior patterns - **48 daily analysis discussions** Prompt Clustering Analysis has created **27 analysis discussions** using ML to categorize thousands of agent prompts - for example, [#6918](https://github.com/github/gh-aw/discussions/6918) clustering agent prompts to identify patterns and optimization opportunities. It revealed patterns we never noticed ("oh, 40% of our prompts are about error handling"). @@ -50,25 +50,25 @@ You can add these workflows to your own repository and remix it as follows: **Copilot Session Insights:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-agent-analysis.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-agent-analysis.md ``` **Copilot PR NLP Analysis:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-pr-nlp-analysis +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-pr-nlp-analysis ``` **Prompt Clustering Analysis:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/prompt-clustering-analysis.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/prompt-clustering-analysis.md ``` **Copilot Agent Analysis:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-agent-analysis.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-agent-analysis.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-campaigns.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-campaigns.md index 89411a28b9f..bc3b2b0ec85 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-campaigns.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-campaigns.md @@ -28,8 +28,8 @@ But here's the ultimate challenge: how do you coordinate *multiple* agents worki These agents coordinate multi-agent plans and projects: -- **[Plan Command](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/plan.md?plain=1)** - Breaks down issues into actionable sub-tasks via `/plan` command - **514 merged PRs out of 761 proposed (67% merge rate)** -- **[Discussion Task Miner](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/discussion-task-miner.md?plain=1)** - Extracts actionable tasks from discussion threads - **60 merged PRs out of 105 proposed (57% merge rate)** +- **[Plan Command](https://github.com/githubnext/agentics/blob/main/.github/workflows/plan.md?plain=1)** - Breaks down issues into actionable sub-tasks via `/plan` command - **514 merged PRs out of 761 proposed (67% merge rate)** +- **[Discussion Task Miner](https://github.com/githubnext/agentics/blob/main/.github/workflows/discussion-task-miner.md?plain=1)** - Extracts actionable tasks from discussion threads - **60 merged PRs out of 105 proposed (57% merge rate)** Plan Command has contributed **514 merged PRs out of 761 proposed (67% merge rate)**, providing on-demand task decomposition that breaks complex issues into actionable sub-tasks. This is the **highest-volume workflow by attribution** in the entire factory. Developers can comment `/plan` on any issue to get an AI-generated breakdown into actionable sub-issues that agents can work on. A verified example causal chain: [Discussion #7631](https://github.com/github/gh-aw/discussions/7631) β†’ [Issue #8058](https://github.com/github/gh-aw/issues/8058) β†’ [PR #8110](https://github.com/github/gh-aw/pull/8110). @@ -46,13 +46,13 @@ You can add these workflows to your own repository and remix them. Get going wit **Plan Command:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/plan.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/plan.md ``` **Discussion Task Miner:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/discussion-task-miner.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/discussion-task-miner.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md index aeba5b66c88..2b5cda0477f 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md @@ -24,10 +24,10 @@ In our [previous posts](/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-sim ## Continuous Improvement Workflows -- **[Go Module Usage Expert (aka Go Fan)](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/go-fan.md?plain=1)** - Daily Go module usage reviewer -- **[Typist](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/typist.md?plain=1)** - Analyzes type usage patterns for improved safety -- **[Functional Pragmatist](https://github.com/github/gh-aw/blob/main/.github/workflows/functional-programming-enhancer.md?plain=1)** - Applies functional techniques pragmatically -- **[Repository Quality Improver](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/repository-quality-improver.md?plain=1)** - Holistic code quality analysis +- **[Go Module Usage Expert (aka Go Fan)](https://github.com/githubnext/agentics/blob/main/.github/workflows/go-fan.md?plain=1)** - Daily Go module usage reviewer +- **[Typist](https://github.com/githubnext/agentics/blob/main/.github/workflows/typist.md?plain=1)** - Analyzes type usage patterns for improved safety +- **[Functional Pragmatist](https://github.com/githubnext/agentics/blob/main/.github/workflows/functional-programming-enhancer.md?plain=1)** - Applies functional techniques pragmatically +- **[Repository Quality Improver](https://github.com/githubnext/agentics/blob/main/.github/workflows/repository-quality-improver.md?plain=1)** - Holistic code quality analysis ### Go Module Usage Expert: The Dependency Enthusiast 🐹 @@ -119,25 +119,25 @@ You can add these workflows to your own repository and remix them. Get going wit **Go Module Usage Expert:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/go-fan.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/go-fan.md ``` **Typist:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/typist.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/typist.md ``` **Functional Pragmatist:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/functional-programming-enhancer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/functional-programming-enhancer.md ``` **Repository Quality Improver:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/repository-quality-improver.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/repository-quality-improver.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-refactoring.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-refactoring.md index 38bea6ad960..a7302702247 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-refactoring.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-refactoring.md @@ -26,8 +26,8 @@ In our [previous post](/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-simp Our next two agents continuously analyze code structure, suggesting systematic improvements: -- **[Semantic Function Refactor](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/semantic-function-refactor.md?plain=1)** - Spots refactoring opportunities we might have missed -- **[Large File Simplifier](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-file-diet.md?plain=1)** - Monitors file sizes and proposes splitting oversized files +- **[Semantic Function Refactor](https://github.com/githubnext/agentics/blob/main/.github/workflows/semantic-function-refactor.md?plain=1)** - Spots refactoring opportunities we might have missed +- **[Large File Simplifier](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-file-diet.md?plain=1)** - Monitors file sizes and proposes splitting oversized files The **Semantic Function Refactor** workflow combines agentic AI with code analysis tools to analyze and address the structure of the entire codebase. It analyzes all Go source files in the `pkg/` directory to identify functions that might be in the wrong place. @@ -69,13 +69,13 @@ You can add these workflows to your own repository and remix them. Get going wit **Semantic Function Refactor:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/semantic-function-refactor.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/semantic-function-refactor.md ``` **Large File Simplifier:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-file-diet.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-file-diet.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-simplicity.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-simplicity.md index 0b1a980fdb4..125d858041e 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-simplicity.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-simplicity.md @@ -28,8 +28,8 @@ Now let's meet the agents that work quietly in the background to keep code simpl The next two agents represent different aspects of code simplicity: detecting *overcomplicated code* and *duplicated logic*: -- **[Automatic Code Simplifier](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/code-simplifier.md?plain=1)** - Analyzes recently modified code and creates PRs with simplifications -- **[Duplicate Code Detector](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/duplicate-code-detector.md?plain=1)** - Uses Serena's semantic analysis to identify duplicate code patterns +- **[Automatic Code Simplifier](https://github.com/githubnext/agentics/blob/main/.github/workflows/code-simplifier.md?plain=1)** - Analyzes recently modified code and creates PRs with simplifications +- **[Duplicate Code Detector](https://github.com/githubnext/agentics/blob/main/.github/workflows/duplicate-code-detector.md?plain=1)** - Uses Serena's semantic analysis to identify duplicate code patterns The **Automatic Code Simplifier** runs daily, analyzing recently modified code for opportunities to simplify without changing functionality. It looks at what changed in the last few commits and asks: "Could this be clearer? Could it be shorter? Could it be more idiomatic?" @@ -65,13 +65,13 @@ You can add these workflows to your own repository and remix them. Get going wit **Automatic Code Simplifier:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/code-simplifier.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/code-simplifier.md ``` **Duplicate Code Detector:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/duplicate-code-detector.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/duplicate-code-detector.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-style.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-style.md index 80ea1fa793c..81ca1e2fd70 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-style.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-style.md @@ -24,7 +24,7 @@ In our [previous posts](/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-sim ## A Continuous Style Workflow -Today's post is dedicated to one agent, and the larger concept it represents: the **[Terminal Stylist](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/terminal-stylist.md?plain=1)** workflow. This agent's purpose is to **make things look better**, by reviewing and enhancing the style of command-line interface (CLI) output. +Today's post is dedicated to one agent, and the larger concept it represents: the **[Terminal Stylist](https://github.com/githubnext/agentics/blob/main/.github/workflows/terminal-stylist.md?plain=1)** workflow. This agent's purpose is to **make things look better**, by reviewing and enhancing the style of command-line interface (CLI) output. Command-line interfaces are a primary interaction point for developer tools. When output is inconsistent or noisy, it still β€œworks,” but it adds friction. When it’s well-styled, information becomes scannable, color highlights what matters, layouts remain readable across light and dark themes, and the overall experience feels professional. @@ -51,7 +51,7 @@ You can add this workflow to your own repository and remix it as follows: **Terminal Stylist:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/terminal-stylist.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/terminal-stylist.md ``` Then edit and remix the workflow specification to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md index 179451dc881..aca2bffe32d 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md @@ -28,11 +28,11 @@ But here's the thing: work doesn't have to be all business. While we've built se These agents facilitate team communication and remind us that work can be fun: -- **[Daily Team Status](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-team-status.md?plain=1)** - Shares team mood and status updates - **22 issues**, **17 discussions** (plus 2 causal chain PRs!) -- **[Daily News](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-news.md?plain=1)** - Curates relevant news for the team - **45 news digest discussions** -- **[Poem Bot](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/poem-bot.md?plain=1)** - Responds to `/poem-bot` commands with creative verses (yes, really) -- **[Weekly Issue Summary](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/weekly-issue-summary.md?plain=1)** - Creates digestible summaries complete with charts and trends - **5 weekly analysis discussions** -- **[Daily Repo Chronicle](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-repo-chronicle.md?plain=1)** - Narrates the day's activity like a storyteller - **6 chronicle discussions** +- **[Daily Team Status](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-team-status.md?plain=1)** - Shares team mood and status updates - **22 issues**, **17 discussions** (plus 2 causal chain PRs!) +- **[Daily News](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-news.md?plain=1)** - Curates relevant news for the team - **45 news digest discussions** +- **[Poem Bot](https://github.com/githubnext/agentics/blob/main/.github/workflows/poem-bot.md?plain=1)** - Responds to `/poem-bot` commands with creative verses (yes, really) +- **[Weekly Issue Summary](https://github.com/githubnext/agentics/blob/main/.github/workflows/weekly-issue-summary.md?plain=1)** - Creates digestible summaries complete with charts and trends - **5 weekly analysis discussions** +- **[Daily Repo Chronicle](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-repo-chronicle.md?plain=1)** - Narrates the day's activity like a storyteller - **6 chronicle discussions** The Poem Bot started as a whimsy in our Copilot for PRs project in 2022. Someone said "wouldn't it be funny if we had an agent that writes poems about our code?" and then we built it. Poem Bot responds to `/poem-bot` commands with creative verses about code, adding a touch of whimsy to the development workflow. We learned that AI agents don't have to be all business - they can build culture and create moments of joy. @@ -57,31 +57,31 @@ You can add these workflows to your own repository and remix them. Get going wit **Daily Team Status:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-team-status.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-team-status.md ``` **Daily News:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-news.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-news.md ``` **Poem Bot:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/poem-bot.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/poem-bot.md ``` **Weekly Issue Summary:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/weekly-issue-summary.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/weekly-issue-summary.md ``` **Daily Repo Chronicle:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-repo-chronicle.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-repo-chronicle.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md index 210a0857f3d..f3c887017d0 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md @@ -28,13 +28,13 @@ Now let's address one of software development's eternal challenges: keeping docu These agents maintain high-quality documentation and content: -- **[Daily Documentation Updater](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-doc-updater.md?plain=1)** - Reviews and updates documentation to ensure accuracy and completeness - **57 merged PRs out of 59 proposed (96% merge rate)** -- **[Glossary Maintainer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/glossary-maintainer.md?plain=1)** - Keeps glossary synchronized with codebase - **10 merged PRs out of 10 proposed (100% merge rate)** -- **[Documentation Unbloat](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/unbloat-docs.md?plain=1)** - Reviews and simplifies documentation by reducing verbosity - **88 merged PRs out of 103 proposed (85% merge rate)** -- **[Documentation Noob Tester](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/docs-noob-tester.md?plain=1)** - Tests documentation as a new user would, identifying confusing steps - **9 merged PRs (43% merge rate)** via causal chain -- **[Slide Deck Maintainer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/slide-deck-maintainer.md?plain=1)** - Maintains presentation slide decks - **2 merged PRs out of 5 proposed (40% merge rate)** -- **[Multi-device Docs Tester](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation site across mobile, tablet, and desktop devices - **2 merged PRs out of 2 proposed (100% merge rate)** -- **[Blog Auditor](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/blog-auditor.md?plain=1)** - Verifies blog posts are accessible and contain expected content - **6 audits completed** (5 passed, 1 flagged issues) +- **[Daily Documentation Updater](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-doc-updater.md?plain=1)** - Reviews and updates documentation to ensure accuracy and completeness - **57 merged PRs out of 59 proposed (96% merge rate)** +- **[Glossary Maintainer](https://github.com/githubnext/agentics/blob/main/.github/workflows/glossary-maintainer.md?plain=1)** - Keeps glossary synchronized with codebase - **10 merged PRs out of 10 proposed (100% merge rate)** +- **[Documentation Unbloat](https://github.com/githubnext/agentics/blob/main/.github/workflows/unbloat-docs.md?plain=1)** - Reviews and simplifies documentation by reducing verbosity - **88 merged PRs out of 103 proposed (85% merge rate)** +- **[Documentation Noob Tester](https://github.com/githubnext/agentics/blob/main/.github/workflows/docs-noob-tester.md?plain=1)** - Tests documentation as a new user would, identifying confusing steps - **9 merged PRs (43% merge rate)** via causal chain +- **[Slide Deck Maintainer](https://github.com/githubnext/agentics/blob/main/.github/workflows/slide-deck-maintainer.md?plain=1)** - Maintains presentation slide decks - **2 merged PRs out of 5 proposed (40% merge rate)** +- **[Multi-device Docs Tester](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation site across mobile, tablet, and desktop devices - **2 merged PRs out of 2 proposed (100% merge rate)** +- **[Blog Auditor](https://github.com/githubnext/agentics/blob/main/.github/workflows/blog-auditor.md?plain=1)** - Verifies blog posts are accessible and contain expected content - **6 audits completed** (5 passed, 1 flagged issues) Documentation is where we challenged conventional wisdom. Can AI agents write *good* documentation? @@ -59,43 +59,43 @@ You can add these workflows to your own repository and remix them. Get going wit **Daily Documentation Updater:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-doc-updater.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-doc-updater.md ``` **Glossary Maintainer:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/glossary-maintainer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/glossary-maintainer.md ``` **Documentation Unbloat:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/unbloat-docs.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/unbloat-docs.md ``` **Documentation Noob Tester:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/docs-noob-tester.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/docs-noob-tester.md ``` **Slide Deck Maintainer:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/slide-deck-maintainer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/slide-deck-maintainer.md ``` **Multi-device Docs Tester:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-multi-device-docs-tester.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-multi-device-docs-tester.md ``` **Blog Auditor:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/blog-auditor.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/blog-auditor.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md index bdb41d08fb3..afa279ec1d3 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md @@ -30,9 +30,9 @@ We learned that the right agent at the right moment with the right information i These agents respond to commands, providing on-demand assistance whenever you need it: -- **[Q](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/q.md?plain=1)** - Workflow optimizer that investigates performance and creates PRs - **69 merged PRs out of 88 proposed (78% merge rate)** -- **[Grumpy Reviewer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/grumpy-reviewer.md?plain=1)** - Performs critical code reviews with personality - creates issues for downstream agents -- **[Workflow Generator](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-generator.md?plain=1)** - Creates new workflows from issue requests - scaffolds workflow files +- **[Q](https://github.com/githubnext/agentics/blob/main/.github/workflows/q.md?plain=1)** - Workflow optimizer that investigates performance and creates PRs - **69 merged PRs out of 88 proposed (78% merge rate)** +- **[Grumpy Reviewer](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md?plain=1)** - Performs critical code reviews with personality - creates issues for downstream agents +- **[Workflow Generator](https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-generator.md?plain=1)** - Creates new workflows from issue requests - scaffolds workflow files Interactive workflows changed how we think about agent invocation. Instead of everything running on a schedule, these respond to slash commands and reactions - `/q` summons the workflow optimizer, a πŸš€ reaction triggers analysis. Q (yes, named after the James Bond quartermaster) became our go-to troubleshooter - it has contributed **69 merged PRs out of 88 proposed (78% merge rate)**, responding to commands and investigating workflow issues on demand. Recent examples include [fixing the daily-fact workflow action-tag](https://github.com/github/gh-aw/pull/14127) and [configuring PR triage reports with 1-day expiration](https://github.com/github/gh-aw/pull/13903). @@ -49,19 +49,19 @@ You can add these workflows to your own repository and remix them. Get going wit **Q:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/q.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/q.md ``` **Grumpy Reviewer:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/grumpy-reviewer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md ``` **Workflow Generator:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-generator.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-generator.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md index 6f975b87fa2..100a1a0b2ae 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md @@ -28,10 +28,10 @@ Now let's talk about the daily rituals of software development: managing issues These agents enhance issue and pull request workflows: -- **[Issue Arborist](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-arborist.md?plain=1)** - Links related issues as sub-issues - **77 discussion reports** and **18 parent issues** created -- **[Issue Monster](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-monster.md?plain=1)** - Assigns issues to the asynchronous [GitHub Copilot coding agent](https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent) one at a time - **task dispatcher** for the whole system -- **[Mergefest](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mergefest.md?plain=1)** - Automatically merges main branch into PR branches - **orchestrator workflow** -- **[Sub Issue Closer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/sub-issue-closer.md?plain=1)** - Closes completed sub-issues automatically - **orchestrator workflow** +- **[Issue Arborist](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-arborist.md?plain=1)** - Links related issues as sub-issues - **77 discussion reports** and **18 parent issues** created +- **[Issue Monster](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-monster.md?plain=1)** - Assigns issues to the asynchronous [GitHub Copilot coding agent](https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent) one at a time - **task dispatcher** for the whole system +- **[Mergefest](https://github.com/githubnext/agentics/blob/main/.github/workflows/mergefest.md?plain=1)** - Automatically merges main branch into PR branches - **orchestrator workflow** +- **[Sub Issue Closer](https://github.com/githubnext/agentics/blob/main/.github/workflows/sub-issue-closer.md?plain=1)** - Closes completed sub-issues automatically - **orchestrator workflow** The Issue Arborist is an **organizational workflow** that has created **77 discussion reports** (titled "[Issue Arborist] Issue Arborist Report") and **18 parent issues** to group related sub-issues. It keeps the issue tracker organized by automatically linking related issues, building a dependency tree we'd never maintain manually. For example, [#12037](https://github.com/github/gh-aw/issues/12037) grouped engine documentation updates. @@ -50,25 +50,25 @@ You can add these workflows to your own repository and remix them. Get going wit **Issue Arborist:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-arborist.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-arborist.md ``` **Issue Monster:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-monster.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-monster.md ``` **Mergefest:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mergefest.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/mergefest.md ``` **Sub Issue Closer:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/sub-issue-closer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/sub-issue-closer.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-metrics-analytics.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-metrics-analytics.md index cbdf0caad26..10e2b2469d0 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-metrics-analytics.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-metrics-analytics.md @@ -28,9 +28,9 @@ When you're running dozens of AI agents, how do you know if they're actually wor Let's take a look at these three workflows: -- **[Metrics Collector](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/metrics-collector.md?plain=1)** - Tracks daily performance across the entire agent ecosystem -- **[Portfolio Analyst](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/portfolio-analyst.md?plain=1)** - Identifies cost reduction opportunities -- **[Audit Workflows](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/audit-workflows.md?plain=1)** - A meta-agent that audits all the other agents' runs +- **[Metrics Collector](https://github.com/githubnext/agentics/blob/main/.github/workflows/metrics-collector.md?plain=1)** - Tracks daily performance across the entire agent ecosystem +- **[Portfolio Analyst](https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md?plain=1)** - Identifies cost reduction opportunities +- **[Audit Workflows](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md?plain=1)** - A meta-agent that audits all the other agents' runs The Metrics Collector has created **41 daily metrics discussions** tracking performance across the agent ecosystem - for example, [#6986](https://github.com/github/gh-aw/discussions/6986) with the daily code metrics report. It became our central nervous system, gathering performance data that feeds into higher-level orchestrators. @@ -47,19 +47,19 @@ You can add these workflows to your own repository and remix them. Get going wit **Metrics Collector:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/metrics-collector.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/metrics-collector.md ``` **Portfolio Analyst:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/portfolio-analyst.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md ``` **Audit Workflows:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/audit-workflows.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-operations-release.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-operations-release.md index df68110ebaa..e33fd9981aa 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-operations-release.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-operations-release.md @@ -26,8 +26,8 @@ In our [previous post](/gh-aw/blog/2026-01-13-meet-the-workflows-metrics-analyti The agents that help us actually ship software: -- **[Changeset](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/changeset.md?plain=1)** - Manages version bumps and changelog entries for releases - **22 merged PRs out of 28 proposed (78% merge rate)** -- **[Daily Workflow Updater](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-workflow-updater.md?plain=1)** - Keeps GitHub Actions and dependencies current +- **[Changeset](https://github.com/githubnext/agentics/blob/main/.github/workflows/changeset.md?plain=1)** - Manages version bumps and changelog entries for releases - **22 merged PRs out of 28 proposed (78% merge rate)** +- **[Daily Workflow Updater](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-workflow-updater.md?plain=1)** - Keeps GitHub Actions and dependencies current Shipping software is stressful enough without worrying about whether you formatted your release notes correctly. @@ -42,7 +42,7 @@ You can add these workflows to your own repository and remix them. Get going wit **Changeset:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/changeset.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/changeset.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-organization.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-organization.md index b9b6274eb79..5a75ef104d3 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-organization.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-organization.md @@ -28,9 +28,9 @@ But all that sophisticated functionality has focused on a single repository. Wha These agents work at organization scale, across multiple repositories: -- **[Org Health Report](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/org-health-report.md?plain=1)** - Organization-wide repository health metrics - **4 organization health discussions** created -- **[Stale Repo Identifier](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/stale-repo-identifier.md?plain=1)** - Identifies inactive repositories - **2 issues** flagging truly stale repos -- **[Ubuntu Image Analyzer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/ubuntu-image-analyzer.md?plain=1)** - Documents GitHub Actions runner environments - **4 merged PRs out of 8 proposed (50% merge rate)** +- **[Org Health Report](https://github.com/githubnext/agentics/blob/main/.github/workflows/org-health-report.md?plain=1)** - Organization-wide repository health metrics - **4 organization health discussions** created +- **[Stale Repo Identifier](https://github.com/githubnext/agentics/blob/main/.github/workflows/stale-repo-identifier.md?plain=1)** - Identifies inactive repositories - **2 issues** flagging truly stale repos +- **[Ubuntu Image Analyzer](https://github.com/githubnext/agentics/blob/main/.github/workflows/ubuntu-image-analyzer.md?plain=1)** - Documents GitHub Actions runner environments - **4 merged PRs out of 8 proposed (50% merge rate)** Scaling agents across an entire organization changes the game. Org Health Report has created **4 organization health discussions** analyzing dozens of repositories at scale - for example, [#6777](https://github.com/github/gh-aw/discussions/6777) with the December 2025 organization health report. It identifies patterns and outliers ("these three repos have no tests, these five haven't been updated in months"). @@ -47,19 +47,19 @@ You can add these workflows to your own repository and remix them. Get going wit **Org Health Report:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/org-health-report.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/org-health-report.md ``` **Stale Repo Identifier:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/stale-repo-identifier.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/stale-repo-identifier.md ``` **Ubuntu Image Analyzer:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/ubuntu-image-analyzer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/ubuntu-image-analyzer.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md index 3d715577e25..0f8f78fd6d0 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md @@ -30,9 +30,9 @@ Now let's shift from collaboration ceremony to fault investigation. These are our diligent caretakers - the agents that spot problems before they become bigger problems: -- **[CI Doctor](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/ci-doctor.md?plain=1)** - Investigates failed workflows and opens diagnostic issues - **9 merged PRs out of 13 proposed (69% merge rate)** -- **[Schema Consistency Checker](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/schema-consistency-checker.md?plain=1)** - Detects when schemas, code, and docs drift apart - **55 analysis discussions** created -- **[Breaking Change Checker](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/breaking-change-checker.md?plain=1)** - Watches for changes that might break things for users - creates alert issues +- **[CI Doctor](https://github.com/githubnext/agentics/blob/main/.github/workflows/ci-doctor.md?plain=1)** - Investigates failed workflows and opens diagnostic issues - **9 merged PRs out of 13 proposed (69% merge rate)** +- **[Schema Consistency Checker](https://github.com/githubnext/agentics/blob/main/.github/workflows/schema-consistency-checker.md?plain=1)** - Detects when schemas, code, and docs drift apart - **55 analysis discussions** created +- **[Breaking Change Checker](https://github.com/githubnext/agentics/blob/main/.github/workflows/breaking-change-checker.md?plain=1)** - Watches for changes that might break things for users - creates alert issues The CI Doctor (also known as "CI Failure Doctor") was one of our most important workflows. Instead of drowning in CI failure notifications, we now get *timely*, *investigated* failures with actual diagnostic insights. The agent doesn't just tell us something broke - it analyzes logs, identifies patterns, searches for similar past issues, and even suggests fixes - even before the human has read the failure notification. CI Failure Doctor has contributed **9 merged PRs out of 13 proposed (69% merge rate)**, including fixes like [adding Go module download pre-flight checks](https://github.com/github/gh-aw/pull/13740) and [adding retry logic to prevent proxy 403 failures](https://github.com/github/gh-aw/pull/13155). We learned that agents excel at the tedious investigation work that humans find draining. @@ -51,19 +51,19 @@ You can add these workflows to your own repository and remix them. Get going wit **CI Doctor:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/ci-doctor.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/ci-doctor.md ``` **Schema Consistency Checker:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/schema-consistency-checker.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/schema-consistency-checker.md ``` **Breaking Change Checker:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/breaking-change-checker.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/breaking-change-checker.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md index 996d8e8f00f..6740a1c0375 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md @@ -28,11 +28,11 @@ But reliability alone isn't enough - we also need *security*. When AI agents can These agents are our security guards, keeping watch and enforcing the rules: -- **[Security Compliance](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/security-compliance.md?plain=1)** - Runs vulnerability campaigns with deadline tracking -- **[Firewall](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/firewall.md?plain=1)** - Tests network security and validates rules - **59 daily firewall report discussions**, **5 smoke test issues** -- **[Daily Secrets Analysis](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-secrets-analysis.md?plain=1)** - Scans for exposed credentials (yes, it happens) -- **[Daily Malicious Code Scan](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-malicious-code-scan.md?plain=1)** - Reviews recent code changes for suspicious patterns -- **[Static Analysis Report](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/static-analysis-report.md?plain=1)** - Daily security scans using zizmor, poutine, and actionlint - **57 analysis discussions** plus **12 Zizmor security reports** +- **[Security Compliance](https://github.com/githubnext/agentics/blob/main/.github/workflows/security-compliance.md?plain=1)** - Runs vulnerability campaigns with deadline tracking +- **[Firewall](https://github.com/githubnext/agentics/blob/main/.github/workflows/firewall.md?plain=1)** - Tests network security and validates rules - **59 daily firewall report discussions**, **5 smoke test issues** +- **[Daily Secrets Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-secrets-analysis.md?plain=1)** - Scans for exposed credentials (yes, it happens) +- **[Daily Malicious Code Scan](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-malicious-code-scan.md?plain=1)** - Reviews recent code changes for suspicious patterns +- **[Static Analysis Report](https://github.com/githubnext/agentics/blob/main/.github/workflows/static-analysis-report.md?plain=1)** - Daily security scans using zizmor, poutine, and actionlint - **57 analysis discussions** plus **12 Zizmor security reports** Security Compliance manages vulnerability remediation campaigns with deadline tracking, ensuring security issues are addressed within defined SLAs - perfect for those "audit in 3 weeks" panic moments. @@ -51,31 +51,31 @@ You can add these workflows to your own repository and remix them. Get going wit **Security Compliance:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/security-compliance.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/security-compliance.md ``` **Firewall:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/firewall.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/firewall.md ``` **Daily Secrets Analysis:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-secrets-analysis.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-secrets-analysis.md ``` **Daily Malicious Code Scan:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-malicious-code-scan.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-malicious-code-scan.md ``` **Static Analysis Report:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/static-analysis-report.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/static-analysis-report.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md index 0ed9216a439..687fffb1e60 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md @@ -30,19 +30,19 @@ These agents keep everything running smoothly through continuous testing: ### Code Quality & Test Validation -- **[Daily Testify Uber Super Expert](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-testify-uber-super-expert.md?plain=1)** - Analyzes test files daily and suggests testify-based improvements - **19 issues created**, **13 led to merged PRs (100% causal chain merge rate)** +- **[Daily Testify Uber Super Expert](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-testify-uber-super-expert.md?plain=1)** - Analyzes test files daily and suggests testify-based improvements - **19 issues created**, **13 led to merged PRs (100% causal chain merge rate)** - **[Daily Test Improver](https://github.com/githubnext/agentics/blob/main/workflows/daily-test-improver.md?plain=1)** - Identifies coverage gaps and implements new tests incrementally -- **[Daily Compiler Quality Check](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-compiler-quality.md?plain=1)** - Analyzes compiler code to ensure it meets quality standards +- **[Daily Compiler Quality Check](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-compiler-quality.md?plain=1)** - Analyzes compiler code to ensure it meets quality standards ### User Experience & Integration Testing -- **[Daily Multi-Device Docs Tester](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation across devices with Playwright - **2 merged PRs out of 2 proposed (100% merge rate)** -- **[CLI Consistency Checker](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/cli-consistency-checker.md?plain=1)** - Inspects the CLI for inconsistencies, typos, and documentation gaps - **80 merged PRs out of 102 proposed (78% merge rate)** +- **[Daily Multi-Device Docs Tester](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation across devices with Playwright - **2 merged PRs out of 2 proposed (100% merge rate)** +- **[CLI Consistency Checker](https://github.com/githubnext/agentics/blob/main/.github/workflows/cli-consistency-checker.md?plain=1)** - Inspects the CLI for inconsistencies, typos, and documentation gaps - **80 merged PRs out of 102 proposed (78% merge rate)** ### CI/CD Optimization -- **[CI Coach](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/ci-coach.md?plain=1)** - Analyzes CI pipelines and suggests optimizations - **9 merged PRs out of 9 proposed (100% merge rate)** -- **[Workflow Health Manager](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-health-manager.md?plain=1)** - Meta-orchestrator monitoring health of all agentic workflows - **40 issues created**, **5 direct PRs + 14 causal chain PRs merged** +- **[CI Coach](https://github.com/githubnext/agentics/blob/main/.github/workflows/ci-coach.md?plain=1)** - Analyzes CI pipelines and suggests optimizations - **9 merged PRs out of 9 proposed (100% merge rate)** +- **[Workflow Health Manager](https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-health-manager.md?plain=1)** - Meta-orchestrator monitoring health of all agentic workflows - **40 issues created**, **5 direct PRs + 14 causal chain PRs merged** The Daily Testify Expert has created **19 issues** analyzing test quality, and **13 of those issues led to merged PRs** by downstream agents - a perfect 100% causal chain merge rate. For example, [issue #13701](https://github.com/github/gh-aw/issues/13701) led to [#13722](https://github.com/github/gh-aw/pull/13722) modernizing console render tests with testify assertions. The Daily Test Improver works alongside it to identify coverage gaps and implement new tests. @@ -61,7 +61,7 @@ You can add these workflows to your own repository and remix them. Get going wit **Daily Testify Uber Super Expert:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-testify-uber-super-expert.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-testify-uber-super-expert.md ``` **Daily Test Improver:** @@ -73,31 +73,31 @@ gh aw add-wizard githubnext/agentics/daily-test-improver **Daily Compiler Quality Check:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-compiler-quality.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-compiler-quality.md ``` **Daily Multi-Device Docs Tester:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-multi-device-docs-tester.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-multi-device-docs-tester.md ``` **CLI Consistency Checker:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/cli-consistency-checker.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/cli-consistency-checker.md ``` **CI Coach:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/ci-coach.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/ci-coach.md ``` **Workflow Health Manager:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-health-manager.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-health-manager.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-tool-infrastructure.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-tool-infrastructure.md index ce935c0ac53..61ef7123c8f 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-tool-infrastructure.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-tool-infrastructure.md @@ -28,9 +28,9 @@ But here's a question that kept us up at night: what if the *infrastructure itse These agents monitor and analyze the agentic infrastructure itself: -- **[MCP Inspector](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mcp-inspector.md?plain=1)** - Validates Model Context Protocol configurations - ensures agents can access tools -- **[GitHub MCP Tools Report](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/github-mcp-tools-report.md?plain=1)** - Analyzes available MCP tools - **5 merged PRs out of 6 proposed (83% merge rate)** -- **[Agent Performance Analyzer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/agent-performance-analyzer.md?plain=1)** - Meta-orchestrator for agent quality - **29 issues created, 14 leading to PRs (8 merged)** +- **[MCP Inspector](https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md?plain=1)** - Validates Model Context Protocol configurations - ensures agents can access tools +- **[GitHub MCP Tools Report](https://github.com/githubnext/agentics/blob/main/.github/workflows/github-mcp-tools-report.md?plain=1)** - Analyzes available MCP tools - **5 merged PRs out of 6 proposed (83% merge rate)** +- **[Agent Performance Analyzer](https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md?plain=1)** - Meta-orchestrator for agent quality - **29 issues created, 14 leading to PRs (8 merged)** Infrastructure for AI agents is different from traditional infrastructure - you need to validate that tools are available, properly configured, and actually working. The MCP Inspector continuously validates Model Context Protocol server configurations because a misconfigured MCP server means an agent can't access the tools it needs. @@ -49,19 +49,19 @@ You can add these workflows to your own repository and remix them. Get going wit **MCP Inspector:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mcp-inspector.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md ``` **GitHub MCP Tools Report:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/github-mcp-tools-report.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/github-mcp-tools-report.md ``` **Agent Performance Analyzer:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/agent-performance-analyzer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows.md index e537d38c687..14e0ca03deb 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows.md @@ -32,7 +32,7 @@ Issue triage represents a "hello world" of automated agentic workflows: practica When a new issue is opened, the triage agent analyzes its content, does research in the codebase and other issues, responds with a comment, and applies appropriate labels based on predefined categories. This helps maintainers quickly understand the nature of incoming issues without manual review. -Let's take a look at the full **[Issue Triage Agent](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-triage-agent.md?plain=1)**: +Let's take a look at the full **[Issue Triage Agent](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md?plain=1)**: ```markdown --- @@ -87,7 +87,7 @@ You can add this workflow to your own repository and remix it as follows: **Issue Triage Agent:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-triage-agent.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md ``` Then edit and remix the workflow specification to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-21-twelve-lessons.md b/docs/src/content/docs/blog/2026-01-21-twelve-lessons.md index 1e72b9b6125..bfd2c9e56ee 100644 --- a/docs/src/content/docs/blog/2026-01-21-twelve-lessons.md +++ b/docs/src/content/docs/blog/2026-01-21-twelve-lessons.md @@ -43,17 +43,17 @@ With clear boundaries in place, we can prototype new agents without worrying abo Agents that watch other agents? Sounds meta, but they've become some of our most valuable workflows. They catch issues early and help us understand what's happening across the entire ecosystem. -Once we passed 50 workflows, tracking everything manually became impossible. Meta-agents like [Audit Workflows](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) and [Agent Performance Analyzer](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/agent-performance-analyzer.md) give us the observability layer we desperately needed. They spot patterns across runs, identify struggling agents, and surface systemic issues we'd never catch looking at individual workflows. +Once we passed 50 workflows, tracking everything manually became impossible. Meta-agents like [Audit Workflows](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) and [Agent Performance Analyzer](https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md) give us the observability layer we desperately needed. They spot patterns across runs, identify struggling agents, and surface systemic issues we'd never catch looking at individual workflows. ### Personality Matters Turns out, agents with distinct personalities - like the meticulous auditor, the helpful janitor, the creative poet - are way easier for teams to understand and trust. -We noticed generic names like "issue-handler" or "code-checker" created confusion. But when we gave agents personalities - like [Grumpy Reviewer](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/grumpy-reviewer.md) or [Poem Bot](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/poem-bot.md) - their purpose became immediately clear. Team members actually started developing relationships with specific agents. It's kind of adorable. +We noticed generic names like "issue-handler" or "code-checker" created confusion. But when we gave agents personalities - like [Grumpy Reviewer](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md) or [Poem Bot](https://github.com/githubnext/agentics/blob/main/.github/workflows/poem-bot.md) - their purpose became immediately clear. Team members actually started developing relationships with specific agents. It's kind of adorable. ### Cost-Quality Tradeoffs Are Real -Longer, more thorough analyses cost more - but they're not always better. The [Portfolio Analyst](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/portfolio-analyst.md) helps us figure out which agents actually deliver value. +Longer, more thorough analyses cost more - but they're not always better. The [Portfolio Analyst](https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md) helps us figure out which agents actually deliver value. We discovered that some of our "thorough" agents were doing redundant work or generating reports nobody read. The Portfolio Analyst tracks cost-per-insight across all agents, revealing that simple, focused agents often deliver better ROI than complex ones. This led us to consolidate overlapping agents and tune prompt lengths to balance thoroughness with cost. AI isn't free, folks! @@ -73,11 +73,11 @@ Instead of remembering complex webhook URLs or GitHub Actions syntax, team membe Frequent, lightweight validation tests (every 12 hours) catch regressions quickly. These "heartbeat" agents keep the infrastructure healthy without manual monitoring. -Instead of waiting for production failures, we deploy multiple [smoke test workflows](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/smoke-copilot.md) that continuously validate core functionality. When a smoke test fails, we know immediately which component broke. This proactive monitoring prevents cascading failures and gives us confidence that the ecosystem is actually stable. +Instead of waiting for production failures, we deploy multiple [smoke test workflows](https://github.com/githubnext/agentics/blob/main/.github/workflows/smoke-copilot.md) that continuously validate core functionality. When a smoke test fails, we know immediately which component broke. This proactive monitoring prevents cascading failures and gives us confidence that the ecosystem is actually stable. ### MCP Inspection Is Essential -As workflows start using multiple MCP servers, having agents that can validate and report on tool availability becomes critical. The [MCP Inspector](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mcp-inspector.md) pattern prevents those cryptic "tool not available" failures. +As workflows start using multiple MCP servers, having agents that can validate and report on tool availability becomes critical. The [MCP Inspector](https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md) pattern prevents those cryptic "tool not available" failures. Early on, we'd see agents fail with vague errors like "connection refused." The MCP Inspector proactively checks all MCP server configurations, validates network access, and generates status reports. This visibility transformed debugging from hours of detective work into reading a dashboard. @@ -91,7 +91,7 @@ Whether managing a backlog of refactoring work, coordinating security fixes, or Applying clustering and NLP to agent interactions revealed usage patterns that weren't obvious from individual runs. This meta-analysis helped identify opportunities for consolidation and optimization. -The [Prompt Clustering Analysis](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/prompt-clustering-analysis.md) and [Copilot PR NLP Analysis](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/copilot-pr-nlp-analysis.md) workflows discovered that many agents were asking similar questions or performing redundant analyses. This insight led to shared component libraries and consolidation opportunities we wouldn't have spotted through manual review. +The [Prompt Clustering Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/prompt-clustering-analysis.md) and [Copilot PR NLP Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-pr-nlp-analysis.md) workflows discovered that many agents were asking similar questions or performing redundant analyses. This insight led to shared component libraries and consolidation opportunities we wouldn't have spotted through manual review. ## Challenges We've Encountered diff --git a/docs/src/content/docs/blog/2026-01-24-design-patterns.md b/docs/src/content/docs/blog/2026-01-24-design-patterns.md index e38a8b0187d..9b39b94d6cc 100644 --- a/docs/src/content/docs/blog/2026-01-24-design-patterns.md +++ b/docs/src/content/docs/blog/2026-01-24-design-patterns.md @@ -44,11 +44,11 @@ Use these when: Here are some examples: -- [`audit-workflows`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) - Meta-agent that audits all other agents' runs -- [`portfolio-analyst`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/portfolio-analyst.md) - Spots cost optimization opportunities -- [`session-insights`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/copilot-session-insights.md) - Analyzes Copilot usage patterns -- [`org-health-report`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/org-health-report.md) - Organization-wide health metrics -- [`scout`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/scout.md), [`archie`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/archie.md) - Deep research agents +- [`audit-workflows`](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) - Meta-agent that audits all other agents' runs +- [`portfolio-analyst`](https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md) - Spots cost optimization opportunities +- [`session-insights`](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-session-insights.md) - Analyzes Copilot usage patterns +- [`org-health-report`](https://github.com/githubnext/agentics/blob/main/.github/workflows/org-health-report.md) - Organization-wide health metrics +- [`scout`](https://github.com/githubnext/agentics/blob/main/.github/workflows/scout.md), [`archie`](https://github.com/githubnext/agentics/blob/main/.github/workflows/archie.md) - Deep research agents Some key characteristics are: @@ -75,10 +75,10 @@ Use these when: Here are some examples: -- [`q`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/q.md) - Workflow optimizer (type `/q` and it investigates!) -- [`grumpy-reviewer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/grumpy-reviewer.md) - Critical code review with personality -- [`poem-bot`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/poem-bot.md) - Creative verse generation (because why not?) -- [`mergefest`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mergefest.md) - Branch merging automation +- [`q`](https://github.com/githubnext/agentics/blob/main/.github/workflows/q.md) - Workflow optimizer (type `/q` and it investigates!) +- [`grumpy-reviewer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md) - Critical code review with personality +- [`poem-bot`](https://github.com/githubnext/agentics/blob/main/.github/workflows/poem-bot.md) - Creative verse generation (because why not?) +- [`mergefest`](https://github.com/githubnext/agentics/blob/main/.github/workflows/mergefest.md) - Branch merging automation - [`pr-fix`](https://github.com/githubnext/agentics/blob/main/workflows/pr-fix.md) - Fixes failing CI checks on demand Some key characteristics are: @@ -107,10 +107,10 @@ Use these when: Here are some examples: -- [`daily-workflow-updater`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/daily-workflow-updater.md) - Keeps actions and dependencies current -- [`glossary-maintainer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/glossary-maintainer.md) - Syncs glossary with codebase -- [`daily-file-diet`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/daily-file-diet.md) - Refactors oversized files -- [`hourly-ci-cleaner`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/hourly-ci-cleaner.md) - Repairs CI issues +- [`daily-workflow-updater`](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-workflow-updater.md) - Keeps actions and dependencies current +- [`glossary-maintainer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/glossary-maintainer.md) - Syncs glossary with codebase +- [`daily-file-diet`](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-file-diet.md) - Refactors oversized files +- [`hourly-ci-cleaner`](https://github.com/githubnext/agentics/blob/main/.github/workflows/hourly-ci-cleaner.md) - Repairs CI issues Some key characteristics are: @@ -138,10 +138,10 @@ Use these when: Here are some examples: -- Smoke tests for [`copilot`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/smoke-copilot.md), [`claude`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/smoke-claude.md), [`codex`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/smoke-codex.md) -- [`schema-consistency-checker`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/schema-consistency-checker.md) -- [`breaking-change-checker`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/breaking-change-checker.md) -- [`firewall`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/firewall.md), [`mcp-inspector`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mcp-inspector.md) +- Smoke tests for [`copilot`](https://github.com/githubnext/agentics/blob/main/.github/workflows/smoke-copilot.md), [`claude`](https://github.com/githubnext/agentics/blob/main/.github/workflows/smoke-claude.md), [`codex`](https://github.com/githubnext/agentics/blob/main/.github/workflows/smoke-codex.md) +- [`schema-consistency-checker`](https://github.com/githubnext/agentics/blob/main/.github/workflows/schema-consistency-checker.md) +- [`breaking-change-checker`](https://github.com/githubnext/agentics/blob/main/.github/workflows/breaking-change-checker.md) +- [`firewall`](https://github.com/githubnext/agentics/blob/main/.github/workflows/firewall.md), [`mcp-inspector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md) - [`daily-accessibility-review`](https://github.com/githubnext/agentics/blob/main/workflows/daily-accessibility-review.md) Some key characteristics are: @@ -170,10 +170,10 @@ Use these when: Here are some examples: -- [`issue-triage-agent`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/issue-triage-agent.md) - Auto-labels and categorizes -- [`issue-arborist`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/issue-arborist.md) - Links related issues -- [`mergefest`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mergefest.md) - Merge coordination -- [`sub-issue-closer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/sub-issue-closer.md) - Closes completed sub-issues +- [`issue-triage-agent`](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md) - Auto-labels and categorizes +- [`issue-arborist`](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-arborist.md) - Links related issues +- [`mergefest`](https://github.com/githubnext/agentics/blob/main/.github/workflows/mergefest.md) - Merge coordination +- [`sub-issue-closer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/sub-issue-closer.md) - Closes completed sub-issues Some key characteristics are: @@ -233,11 +233,11 @@ Use these when: Here are some examples: -- [`duplicate-code-detector`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/duplicate-code-detector.md) - Finds code duplicates -- [`semantic-function-refactor`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/semantic-function-refactor.md) - Refactoring opportunities -- [`terminal-stylist`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/terminal-stylist.md) - Console output analysis -- [`go-pattern-detector`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/go-pattern-detector.md) - Go-specific patterns -- [`typist`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/typist.md) - Type analysis +- [`duplicate-code-detector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/duplicate-code-detector.md) - Finds code duplicates +- [`semantic-function-refactor`](https://github.com/githubnext/agentics/blob/main/.github/workflows/semantic-function-refactor.md) - Refactoring opportunities +- [`terminal-stylist`](https://github.com/githubnext/agentics/blob/main/.github/workflows/terminal-stylist.md) - Console output analysis +- [`go-pattern-detector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/go-pattern-detector.md) - Go-specific patterns +- [`typist`](https://github.com/githubnext/agentics/blob/main/.github/workflows/typist.md) - Type analysis Some key characteristics are: @@ -265,10 +265,10 @@ Use these when: Here are some examples: -- [`glossary-maintainer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/glossary-maintainer.md) - Glossary synchronization -- [`technical-doc-writer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/technical-doc-writer.md) - Technical documentation -- [`slide-deck-maintainer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/slide-deck-maintainer.md) - Presentation maintenance -- [`ubuntu-image-analyzer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/ubuntu-image-analyzer.md) - Environment documentation +- [`glossary-maintainer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/glossary-maintainer.md) - Glossary synchronization +- [`technical-doc-writer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/technical-doc-writer.md) - Technical documentation +- [`slide-deck-maintainer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/slide-deck-maintainer.md) - Presentation maintenance +- [`ubuntu-image-analyzer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/ubuntu-image-analyzer.md) - Environment documentation Some key characteristics are: @@ -296,10 +296,10 @@ Use these when: Here are some examples: -- [`audit-workflows`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) - Comprehensive workflow auditing -- [`agent-performance-analyzer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/agent-performance-analyzer.md) - Agent quality metrics -- [`portfolio-analyst`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/portfolio-analyst.md) - Cost optimization -- [`workflow-health-manager`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/workflow-health-manager.md) - Health monitoring +- [`audit-workflows`](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) - Comprehensive workflow auditing +- [`agent-performance-analyzer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md) - Agent quality metrics +- [`portfolio-analyst`](https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md) - Cost optimization +- [`workflow-health-manager`](https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-health-manager.md) - Health monitoring Some key characteristics are: @@ -327,8 +327,8 @@ Use these when: Here are some examples: -- [`workflow-generator`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/workflow-generator.md) - Generates new workflows -- [`dev-hawk`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/dev-hawk.md) - Development monitoring +- [`workflow-generator`](https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-generator.md) - Generates new workflows +- [`dev-hawk`](https://github.com/githubnext/agentics/blob/main/.github/workflows/dev-hawk.md) - Development monitoring Some key characteristics are: @@ -356,9 +356,9 @@ Use these when: Here are some examples: -- [`copilot-session-insights`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/copilot-session-insights.md) - Session usage analysis -- [`copilot-pr-nlp-analysis`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/copilot-pr-nlp-analysis.md) - NLP on PR conversations -- [`prompt-clustering`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/prompt-clustering-analysis.md) - Clusters and categorizes prompts +- [`copilot-session-insights`](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-session-insights.md) - Session usage analysis +- [`copilot-pr-nlp-analysis`](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-pr-nlp-analysis.md) - NLP on PR conversations +- [`prompt-clustering`](https://github.com/githubnext/agentics/blob/main/.github/workflows/prompt-clustering-analysis.md) - Clusters and categorizes prompts Some key characteristics are: @@ -386,11 +386,11 @@ Use these when: Here are some examples: -- [`security-compliance`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/security-compliance.md) - Vulnerability campaigns -- [`firewall`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/firewall.md) - Network security testing -- [`daily-secrets-analysis`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/daily-secrets-analysis.md) - Secret scanning -- [`ai-moderator`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/ai-moderator.md) - Comment spam filtering -- [`security-fix-pr`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/security-fix-pr.md) - Automated security fixes +- [`security-compliance`](https://github.com/githubnext/agentics/blob/main/.github/workflows/security-compliance.md) - Vulnerability campaigns +- [`firewall`](https://github.com/githubnext/agentics/blob/main/.github/workflows/firewall.md) - Network security testing +- [`daily-secrets-analysis`](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-secrets-analysis.md) - Secret scanning +- [`ai-moderator`](https://github.com/githubnext/agentics/blob/main/.github/workflows/ai-moderator.md) - Comment spam filtering +- [`security-fix-pr`](https://github.com/githubnext/agentics/blob/main/.github/workflows/security-fix-pr.md) - Automated security fixes Some key characteristics are: diff --git a/docs/src/content/docs/blog/2026-01-27-operational-patterns.md b/docs/src/content/docs/blog/2026-01-27-operational-patterns.md index 0e03dc3fea7..484e45d681f 100644 --- a/docs/src/content/docs/blog/2026-01-27-operational-patterns.md +++ b/docs/src/content/docs/blog/2026-01-27-operational-patterns.md @@ -52,7 +52,7 @@ These workflows do the following: ### Example: Grumpy Reviewer -The [`grumpy-reviewer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/grumpy-reviewer.md) workflow is a perfect example of this pattern: +The [`grumpy-reviewer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md) workflow is a perfect example of this pattern: - Triggered by `/grumpy` on PR comments - Performs critical code review with distinctive personality @@ -150,7 +150,7 @@ These workflows do the following: ### Example: Issue Triage Agent -The [`issue-triage-agent`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/issue-triage-agent.md) automatically labels and categorizes new issues: +The [`issue-triage-agent`](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md) automatically labels and categorizes new issues: - Analyzes issue title and body - Applies relevant labels (bug, feature, documentation, etc.) @@ -315,7 +315,7 @@ These workflows do the following: ### Example: Duplicate Code Detection -The [`duplicate-code-detector`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/duplicate-code-detector.md) uses ResearchPlanAssignOps: +The [`duplicate-code-detector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/duplicate-code-detector.md) uses ResearchPlanAssignOps: **Research**: Uses Serena MCP for semantic analysis, creates report **Plan**: Creates well-scoped issues (max 3 per run) with refactoring strategies @@ -364,7 +364,7 @@ These workflows do the following: ### Example: Org Health Report -The [`org-health-report`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/org-health-report.md) analyzes health metrics across all organization repositories: +The [`org-health-report`](https://github.com/githubnext/agentics/blob/main/.github/workflows/org-health-report.md) analyzes health metrics across all organization repositories: - Checks for outdated dependencies - Validates security policies diff --git a/docs/src/content/docs/blog/2026-01-30-imports-and-sharing.md b/docs/src/content/docs/blog/2026-01-30-imports-and-sharing.md index 6d8429f886d..a7cea238b87 100644 --- a/docs/src/content/docs/blog/2026-01-30-imports-and-sharing.md +++ b/docs/src/content/docs/blog/2026-01-30-imports-and-sharing.md @@ -37,7 +37,7 @@ Imports provide several game-changing benefits that transformed how we develop a When we improve report formatting or update an MCP server configuration, the change automatically propagates to all workflows that import it. No need to update 46 workflows individually. That's huge! -For example, when we enhanced the [`reporting.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/reporting.md) component with better formatting guidelines, all 46 workflows that imported it immediately benefited. One change, 46 workflows improved. Magic. +For example, when we enhanced the [`reporting.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/reporting.md) component with better formatting guidelines, all 46 workflows that imported it immediately benefited. One change, 46 workflows improved. Magic. ### 🧩 Composable Workflow Capabilities @@ -95,38 +95,38 @@ The factory organized shared components into two main directories: #### Most Popular Shared Components -**[`reporting.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/reporting.md?plain=1)** (46 imports) +**[`reporting.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/reporting.md?plain=1)** (46 imports) - Report formatting guidelines - Workflow run references - Footer standards - Consistent structure -**[`jqschema.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/jqschema.md?plain=1)** (17 imports) +**[`jqschema.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/jqschema.md?plain=1)** (17 imports) - JSON querying utilities - Schema validation - Data transformation patterns -**[`python-dataviz.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/python-dataviz.md?plain=1)** (7 imports) +**[`python-dataviz.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/python-dataviz.md?plain=1)** (7 imports) - Python environment with NumPy, Pandas, Matplotlib, Seaborn - Data visualization templates - Chart generation utilities -**[`trending-charts-simple.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/trending-charts-simple.md?plain=1)** (6 imports) +**[`trending-charts-simple.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/trending-charts-simple.md?plain=1)** (6 imports) - Quick setup for trend visualizations - Time-series analysis - Comparison charts -**[`gh.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/gh.md?plain=1)** (4 imports) +**[`gh.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/gh.md?plain=1)** (4 imports) - Safe-input wrapper for GitHub CLI - Authentication handling - Common gh commands -**[`copilot-pr-data-fetch.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/copilot-pr-data-fetch.md?plain=1)** (4 imports) +**[`copilot-pr-data-fetch.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/copilot-pr-data-fetch.md?plain=1)** (4 imports) - Fetch GitHub Copilot PR data - Cache management @@ -136,14 +136,14 @@ The factory organized shared components into two main directories: **Data Analysis** -- [`charts-with-trending.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/charts-with-trending.md) - Comprehensive trending with cache-memory -- [`ci-data-analysis.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/ci-data-analysis.md) - CI workflow analysis -- [`session-analysis-charts.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/session-analysis-charts.md) - Copilot session visualization +- [`charts-with-trending.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/charts-with-trending.md) - Comprehensive trending with cache-memory +- [`ci-data-analysis.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/ci-data-analysis.md) - CI workflow analysis +- [`session-analysis-charts.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/session-analysis-charts.md) - Copilot session visualization **Prompting & Output** -- [`keep-it-short.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/keep-it-short.md) - Guidance for concise responses -- [`safe-output-app.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/safe-output-app.md) - Safe output patterns +- [`keep-it-short.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/keep-it-short.md) - Guidance for concise responses +- [`safe-output-app.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/safe-output-app.md) - Safe output patterns ### MCP Server Configurations: `.github/workflows/shared/mcp/` @@ -151,31 +151,31 @@ The factory organized shared components into two main directories: #### Most Used MCP Servers -**[`gh-aw.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/gh-aw.md?plain=1)** (12 imports) +**[`gh-aw.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/gh-aw.md?plain=1)** (12 imports) - GH-AW as an MCP server - `logs` command for workflow debugging - Workflow metadata access -**[`tavily.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/tavily.md?plain=1)** (5 imports) +**[`tavily.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/tavily.md?plain=1)** (5 imports) - Web search via Tavily API - Research capabilities - Current information access -**[`markitdown.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/markitdown.md?plain=1)** (3 imports) +**[`markitdown.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/markitdown.md?plain=1)** (3 imports) - Document conversion (PDF, Office, images to Markdown) - Content extraction - Multimedia analysis -**[`ast-grep.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/ast-grep.md?plain=1)** (2 imports) +**[`ast-grep.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/ast-grep.md?plain=1)** (2 imports) - Structural code search and analysis - Pattern matching - Refactoring support -**[`brave.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/brave.md?plain=1)** (2 imports) +**[`brave.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/brave.md?plain=1)** (2 imports) - Alternative web search via Brave API - Privacy-focused search @@ -185,23 +185,23 @@ The factory organized shared components into two main directories: **Development Tools** -- [`jupyter.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/jupyter.md) - Jupyter notebook environment with Docker services -- [`skillz.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/skillz.md) - Dynamic skill loading from `.github/skills/` -- [`serena.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/serena.md) - Semantic code analysis +- [`jupyter.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/jupyter.md) - Jupyter notebook environment with Docker services +- [`skillz.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/skillz.md) - Dynamic skill loading from `.github/skills/` +- [`serena.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/serena.md) - Semantic code analysis **Knowledge & Search** -- [`context7.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/context7.md) - Context-aware search -- [`deepwiki.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/deepwiki.md) - Wikipedia deep search -- [`microsoft-docs.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/microsoft-docs.md) - Microsoft documentation -- [`arxiv.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/arxiv.md) - Academic paper research +- [`context7.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/context7.md) - Context-aware search +- [`deepwiki.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/deepwiki.md) - Wikipedia deep search +- [`microsoft-docs.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/microsoft-docs.md) - Microsoft documentation +- [`arxiv.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/arxiv.md) - Academic paper research **External Integrations** -- [`slack.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/slack.md) - Slack workspace integration -- [`notion.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/notion.md) - Notion workspace integration -- [`sentry.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/sentry.md) - Error tracking -- [`datadog.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/datadog.md) - Observability platform +- [`slack.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/slack.md) - Slack workspace integration +- [`notion.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/notion.md) - Notion workspace integration +- [`sentry.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/sentry.md) - Error tracking +- [`datadog.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/datadog.md) - Observability platform ## Import Statistics diff --git a/docs/src/content/docs/blog/2026-02-02-security-lessons.md b/docs/src/content/docs/blog/2026-02-02-security-lessons.md index 9bbd3b68db1..f704af3210e 100644 --- a/docs/src/content/docs/blog/2026-02-02-security-lessons.md +++ b/docs/src/content/docs/blog/2026-02-02-security-lessons.md @@ -37,7 +37,7 @@ Let's share what we've figured out so you can build secure agent ecosystems from Every workflow begins with `permissions: contents: read`. That's our default stance. Write permissions (`contents: write`, `pull-requests: write`, `issues: write`) get granted sparingly and only through safe output mechanisms. -**Example**: The [`audit-workflows`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) agent has read-only access to workflow runs but creates reports via discussions, which are append-only by nature. +**Example**: The [`audit-workflows`](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) agent has read-only access to workflow runs but creates reports via discussions, which are append-only by nature. **Why this works**: If an agent can only read, the worst it can do is waste compute time. It can't delete code, close important issues, or push malicious changes. @@ -77,7 +77,7 @@ safe_outputs: Not every mention or workflow event should trigger powerful agents. We use role-gating to ensure only authorized users can invoke sensitive operations. -**Example**: The [`q`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/q.md) optimizer requires the user commenting `/q` to be a repository maintainer. Random contributors can't trigger expensive optimization runs. +**Example**: The [`q`](https://github.com/githubnext/agentics/blob/main/.github/workflows/q.md) optimizer requires the user commenting `/q` to be a repository maintainer. Random contributors can't trigger expensive optimization runs. **Implementation**: @@ -148,7 +148,7 @@ Every agent action leaves a trail: - Artifacts are versioned - Workflow runs are logged -**Example**: The [`agent-performance-analyzer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/agent-performance-analyzer.md) creates weekly discussion posts. You can scroll back months to see how agent quality has evolved over time. +**Example**: The [`agent-performance-analyzer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md) creates weekly discussion posts. You can scroll back months to see how agent quality has evolved over time. **Why this works**: Transparency builds trust. When something goes wrong, the audit trail makes debugging straightforward. When something goes right, the evidence is right there for everyone to see. @@ -183,7 +183,7 @@ When agents need write access, use safe outputs with strict bounds. **Use case**: Issue triage, PR creation, documentation updates -**Example**: [`issue-triage-agent`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/issue-triage-agent.md) can add labels but can't close issues or modify code. +**Example**: [`issue-triage-agent`](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md) can add labels but can't close issues or modify code. ### Pattern 3: Human-in-the-Loop @@ -198,7 +198,7 @@ For high-impact operations, require human approval before execution. **Use case**: Code changes, dependency updates, configuration changes -**Example**: [`daily-workflow-updater`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/daily-workflow-updater.md) creates PRs for dependency updates but never merges them automatically. +**Example**: [`daily-workflow-updater`](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-workflow-updater.md) creates PRs for dependency updates but never merges them automatically. ### Pattern 4: Role-Gated ChatOps @@ -213,7 +213,7 @@ Interactive agents that require authorization to invoke. **Use case**: Code review, optimization, debugging assistance -**Example**: [`grumpy-reviewer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/grumpy-reviewer.md) requires collaborator access to invoke via `/grumpy`. +**Example**: [`grumpy-reviewer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md) requires collaborator access to invoke via `/grumpy`. ### Pattern 5: Network Restricted diff --git a/docs/src/content/docs/blog/2026-02-05-how-workflows-work.md b/docs/src/content/docs/blog/2026-02-05-how-workflows-work.md index a0637beef21..6ff61d54669 100644 --- a/docs/src/content/docs/blog/2026-02-05-how-workflows-work.md +++ b/docs/src/content/docs/blog/2026-02-05-how-workflows-work.md @@ -227,7 +227,7 @@ tools: ## Error Handling and Debugging -When workflows fail, detailed logs capture job, step, tool invocation, and error information. Safe output validation provides clear error messages and example corrections while allowing workflows to fail gracefully. The [`mcp-inspector`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mcp-inspector.md) workflow validates server availability and configuration. The [`audit-workflows`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) agent tracks runs, classifies failures, and creates issues for persistent problems. +When workflows fail, detailed logs capture job, step, tool invocation, and error information. Safe output validation provides clear error messages and example corrections while allowing workflows to fail gracefully. The [`mcp-inspector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md) workflow validates server availability and configuration. The [`audit-workflows`](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) agent tracks runs, classifies failures, and creates issues for persistent problems. ## Performance Considerations diff --git a/docs/src/content/docs/blog/2026-03-18-weekly-update.md b/docs/src/content/docs/blog/2026-03-18-weekly-update.md index 81db2d247c6..93e59ffe392 100644 --- a/docs/src/content/docs/blog/2026-03-18-weekly-update.md +++ b/docs/src/content/docs/blog/2026-03-18-weekly-update.md @@ -60,7 +60,7 @@ Across its recent runs it made 131 `search_repositories` calls. We're not sure w πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with a notify workflow on specific labels (e.g., `security` or `needs-repro`) so the right people get pinged automatically without anyone having to watch the inbox. -β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-03-23-weekly-update.md b/docs/src/content/docs/blog/2026-03-23-weekly-update.md index 2483681b50b..ffaf73f46cd 100644 --- a/docs/src/content/docs/blog/2026-03-23-weekly-update.md +++ b/docs/src/content/docs/blog/2026-03-23-weekly-update.md @@ -69,7 +69,7 @@ One earlier run also hit a minor hiccup: the pre-agent filter step forgot to wri πŸ’‘ **Usage tip**: The `contribution-check` pattern works best when your `CONTRIBUTING.md` is explicit and opinionated β€” the more specific your guidelines, the more actionable its feedback will be for contributors. -β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/contribution-check.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/contribution-check.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-03-30-weekly-update.md b/docs/src/content/docs/blog/2026-03-30-weekly-update.md index 78c01276604..a6d9d14622f 100644 --- a/docs/src/content/docs/blog/2026-03-30-weekly-update.md +++ b/docs/src/content/docs/blog/2026-03-30-weekly-update.md @@ -76,7 +76,7 @@ It's the classic overachiever problem β€” sometimes the issues that look the sim πŸ’‘ **Usage tip**: If your `auto-triage-issues` scheduled runs are consistently expensive, the new `agentic_fraction` metric in `gh aw audit` can help you identify which turns are pure data-gathering and could be moved to deterministic shell steps. -β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) --- diff --git a/docs/src/content/docs/blog/2026-04-06-weekly-update.md b/docs/src/content/docs/blog/2026-04-06-weekly-update.md index 0f59271a4ee..452d5a8550c 100644 --- a/docs/src/content/docs/blog/2026-04-06-weekly-update.md +++ b/docs/src/content/docs/blog/2026-04-06-weekly-update.md @@ -59,7 +59,7 @@ In a delightfully meta moment, the observability kit itself hit token-limit erro πŸ’‘ **Usage tip**: Pair `agentic-observability-kit` with Slack or email notifications so escalation issues trigger an alert β€” otherwise the issues it files can sit unread while the token bill quietly grows. -β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-observability-kit.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/agentic-observability-kit.md) --- diff --git a/docs/src/content/docs/blog/2026-04-13-weekly-update.md b/docs/src/content/docs/blog/2026-04-13-weekly-update.md index 527fb2c0122..533208ebda8 100644 --- a/docs/src/content/docs/blog/2026-04-13-weekly-update.md +++ b/docs/src/content/docs/blog/2026-04-13-weekly-update.md @@ -62,7 +62,7 @@ That "security" label is doing a lot of work β€” the workflow spotted MCP and co πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with label-based notification rules so your team gets automatically paged for `security` or `critical` issues without anyone having to babysit the issue tracker. -β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-04-20-weekly-update.md b/docs/src/content/docs/blog/2026-04-20-weekly-update.md index fcbd5527977..d6e26fccb7b 100644 --- a/docs/src/content/docs/blog/2026-04-20-weekly-update.md +++ b/docs/src/content/docs/blog/2026-04-20-weekly-update.md @@ -61,7 +61,7 @@ Even when it can't act, it doesn't just silently fail β€” it leaves a breadcrumb πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with a `notify` workflow on high-priority labels (like `security` or `breaking-change`) so your team gets paged for the things that actually matter. -β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-04-27-weekly-update.md b/docs/src/content/docs/blog/2026-04-27-weekly-update.md index 4b597d8a498..13ae672e166 100644 --- a/docs/src/content/docs/blog/2026-04-27-weekly-update.md +++ b/docs/src/content/docs/blog/2026-04-27-weekly-update.md @@ -43,7 +43,7 @@ One of its runs earned an honorable mention from the agentic assessment system: πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with a label-based notification workflow so the right team members get pinged the moment a new issue is categorized. -β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-05-04-weekly-update.md b/docs/src/content/docs/blog/2026-05-04-weekly-update.md index 90e21e9fb7e..35638f26938 100644 --- a/docs/src/content/docs/blog/2026-05-04-weekly-update.md +++ b/docs/src/content/docs/blog/2026-05-04-weekly-update.md @@ -52,7 +52,7 @@ It spent roughly 500k tokens per run carefully reading workflow files, thinking πŸ’‘ **Usage tip**: Use `ab-testing-advisor` as inspiration for your own repos β€” it's a great example of a meta-workflow that uses AI to drive continuous improvement of *other* AI workflows. -β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/ab-testing-advisor.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/ab-testing-advisor.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-05-11-weekly-update.md b/docs/src/content/docs/blog/2026-05-11-weekly-update.md index 2a7b381c444..d629e11f1d2 100644 --- a/docs/src/content/docs/blog/2026-05-11-weekly-update.md +++ b/docs/src/content/docs/blog/2026-05-11-weekly-update.md @@ -50,7 +50,7 @@ The run summary noted with mild concern that `auto-triage-issues` is so reliable πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with a `notify` or `discussion` workflow on high-priority labels so the right people are paged the moment a critical bug or security issue lands. -β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out From f30f0ae1cc7753caf68c089451b8cfc843c8c499 Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 22 May 2026 14:03:10 +0000 Subject: [PATCH 4/5] Validate and keep only working githubnext workflow URLs Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- ...3-meet-the-workflows-advanced-analytics.md | 16 ++-- ...2026-01-13-meet-the-workflows-campaigns.md | 8 +- ...et-the-workflows-continuous-improvement.md | 16 ++-- ...et-the-workflows-continuous-refactoring.md | 8 +- ...eet-the-workflows-continuous-simplicity.md | 8 +- ...-13-meet-the-workflows-continuous-style.md | 4 +- ...-13-meet-the-workflows-creative-culture.md | 20 ++--- ...-01-13-meet-the-workflows-documentation.md | 28 +++--- ...-meet-the-workflows-interactive-chatops.md | 12 +-- ...-13-meet-the-workflows-issue-management.md | 16 ++-- ...13-meet-the-workflows-metrics-analytics.md | 12 +-- ...3-meet-the-workflows-operations-release.md | 6 +- ...6-01-13-meet-the-workflows-organization.md | 12 +-- ...1-13-meet-the-workflows-quality-hygiene.md | 12 +-- ...-meet-the-workflows-security-compliance.md | 20 ++--- ...3-meet-the-workflows-testing-validation.md | 24 ++--- ...-meet-the-workflows-tool-infrastructure.md | 12 +-- .../blog/2026-01-13-meet-the-workflows.md | 4 +- .../docs/blog/2026-01-21-twelve-lessons.md | 12 +-- .../docs/blog/2026-01-24-design-patterns.md | 88 +++++++++---------- .../blog/2026-01-27-operational-patterns.md | 8 +- .../blog/2026-01-30-imports-and-sharing.md | 56 ++++++------ .../docs/blog/2026-02-02-security-lessons.md | 12 +-- .../blog/2026-02-05-how-workflows-work.md | 2 +- .../docs/blog/2026-03-18-weekly-update.md | 2 +- .../docs/blog/2026-03-23-weekly-update.md | 2 +- .../docs/blog/2026-03-30-weekly-update.md | 2 +- .../docs/blog/2026-04-06-weekly-update.md | 2 +- .../docs/blog/2026-04-13-weekly-update.md | 2 +- .../docs/blog/2026-04-20-weekly-update.md | 2 +- .../docs/blog/2026-04-27-weekly-update.md | 2 +- .../docs/blog/2026-05-04-weekly-update.md | 2 +- .../docs/blog/2026-05-11-weekly-update.md | 2 +- 33 files changed, 217 insertions(+), 217 deletions(-) diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-advanced-analytics.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-advanced-analytics.md index 7545e44d56a..0a221bdd2a8 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-advanced-analytics.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-advanced-analytics.md @@ -28,10 +28,10 @@ Beyond tracking basic metrics (run time, cost, success rate), we wanted deeper i These agents use sophisticated analysis techniques to extract insights: -- **[Copilot Session Insights](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-session-insights.md?plain=1)** - Analyzes Copilot coding agent usage patterns and metrics - **32 analysis discussions** -- **[Copilot PR NLP Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-pr-nlp-analysis.md?plain=1)** - Natural language processing on PR conversations -- **[Prompt Clustering Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/prompt-clustering-analysis.md?plain=1)** - Clusters and categorizes agent prompts using ML - **27 analysis discussions** -- **[Copilot Agent Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-agent-analysis.md?plain=1)** - Deep analysis of agent behavior patterns - **48 daily analysis discussions** +- **[Copilot Session Insights](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-session-insights.md?plain=1)** - Analyzes Copilot coding agent usage patterns and metrics - **32 analysis discussions** +- **[Copilot PR NLP Analysis](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-pr-nlp-analysis.md?plain=1)** - Natural language processing on PR conversations +- **[Prompt Clustering Analysis](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/prompt-clustering-analysis.md?plain=1)** - Clusters and categorizes agent prompts using ML - **27 analysis discussions** +- **[Copilot Agent Analysis](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-agent-analysis.md?plain=1)** - Deep analysis of agent behavior patterns - **48 daily analysis discussions** Prompt Clustering Analysis has created **27 analysis discussions** using ML to categorize thousands of agent prompts - for example, [#6918](https://github.com/github/gh-aw/discussions/6918) clustering agent prompts to identify patterns and optimization opportunities. It revealed patterns we never noticed ("oh, 40% of our prompts are about error handling"). @@ -50,25 +50,25 @@ You can add these workflows to your own repository and remix it as follows: **Copilot Session Insights:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-agent-analysis.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-agent-analysis.md ``` **Copilot PR NLP Analysis:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-pr-nlp-analysis +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-pr-nlp-analysis ``` **Prompt Clustering Analysis:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/prompt-clustering-analysis.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/prompt-clustering-analysis.md ``` **Copilot Agent Analysis:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-agent-analysis.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/copilot-agent-analysis.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-campaigns.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-campaigns.md index bc3b2b0ec85..e90fbb5027b 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-campaigns.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-campaigns.md @@ -28,8 +28,8 @@ But here's the ultimate challenge: how do you coordinate *multiple* agents worki These agents coordinate multi-agent plans and projects: -- **[Plan Command](https://github.com/githubnext/agentics/blob/main/.github/workflows/plan.md?plain=1)** - Breaks down issues into actionable sub-tasks via `/plan` command - **514 merged PRs out of 761 proposed (67% merge rate)** -- **[Discussion Task Miner](https://github.com/githubnext/agentics/blob/main/.github/workflows/discussion-task-miner.md?plain=1)** - Extracts actionable tasks from discussion threads - **60 merged PRs out of 105 proposed (57% merge rate)** +- **[Plan Command](https://github.com/githubnext/agentics/blob/main/workflows/plan.md?plain=1)** - Breaks down issues into actionable sub-tasks via `/plan` command - **514 merged PRs out of 761 proposed (67% merge rate)** +- **[Discussion Task Miner](https://github.com/githubnext/agentics/blob/main/workflows/discussion-task-miner.md?plain=1)** - Extracts actionable tasks from discussion threads - **60 merged PRs out of 105 proposed (57% merge rate)** Plan Command has contributed **514 merged PRs out of 761 proposed (67% merge rate)**, providing on-demand task decomposition that breaks complex issues into actionable sub-tasks. This is the **highest-volume workflow by attribution** in the entire factory. Developers can comment `/plan` on any issue to get an AI-generated breakdown into actionable sub-issues that agents can work on. A verified example causal chain: [Discussion #7631](https://github.com/github/gh-aw/discussions/7631) β†’ [Issue #8058](https://github.com/github/gh-aw/issues/8058) β†’ [PR #8110](https://github.com/github/gh-aw/pull/8110). @@ -46,13 +46,13 @@ You can add these workflows to your own repository and remix them. Get going wit **Plan Command:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/plan.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/plan.md ``` **Discussion Task Miner:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/discussion-task-miner.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/discussion-task-miner.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md index 2b5cda0477f..a7f8bde438e 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md @@ -24,10 +24,10 @@ In our [previous posts](/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-sim ## Continuous Improvement Workflows -- **[Go Module Usage Expert (aka Go Fan)](https://github.com/githubnext/agentics/blob/main/.github/workflows/go-fan.md?plain=1)** - Daily Go module usage reviewer -- **[Typist](https://github.com/githubnext/agentics/blob/main/.github/workflows/typist.md?plain=1)** - Analyzes type usage patterns for improved safety -- **[Functional Pragmatist](https://github.com/githubnext/agentics/blob/main/.github/workflows/functional-programming-enhancer.md?plain=1)** - Applies functional techniques pragmatically -- **[Repository Quality Improver](https://github.com/githubnext/agentics/blob/main/.github/workflows/repository-quality-improver.md?plain=1)** - Holistic code quality analysis +- **[Go Module Usage Expert (aka Go Fan)](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/go-fan.md?plain=1)** - Daily Go module usage reviewer +- **[Typist](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/typist.md?plain=1)** - Analyzes type usage patterns for improved safety +- **[Functional Pragmatist](https://github.com/github/gh-aw/blob/main/.github/workflows/functional-programming-enhancer.md?plain=1)** - Applies functional techniques pragmatically +- **[Repository Quality Improver](https://github.com/githubnext/agentics/blob/main/workflows/repository-quality-improver.md?plain=1)** - Holistic code quality analysis ### Go Module Usage Expert: The Dependency Enthusiast 🐹 @@ -119,25 +119,25 @@ You can add these workflows to your own repository and remix them. Get going wit **Go Module Usage Expert:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/go-fan.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/go-fan.md ``` **Typist:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/typist.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/typist.md ``` **Functional Pragmatist:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/functional-programming-enhancer.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/functional-programming-enhancer.md ``` **Repository Quality Improver:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/repository-quality-improver.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/repository-quality-improver.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-refactoring.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-refactoring.md index a7302702247..38bea6ad960 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-refactoring.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-refactoring.md @@ -26,8 +26,8 @@ In our [previous post](/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-simp Our next two agents continuously analyze code structure, suggesting systematic improvements: -- **[Semantic Function Refactor](https://github.com/githubnext/agentics/blob/main/.github/workflows/semantic-function-refactor.md?plain=1)** - Spots refactoring opportunities we might have missed -- **[Large File Simplifier](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-file-diet.md?plain=1)** - Monitors file sizes and proposes splitting oversized files +- **[Semantic Function Refactor](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/semantic-function-refactor.md?plain=1)** - Spots refactoring opportunities we might have missed +- **[Large File Simplifier](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-file-diet.md?plain=1)** - Monitors file sizes and proposes splitting oversized files The **Semantic Function Refactor** workflow combines agentic AI with code analysis tools to analyze and address the structure of the entire codebase. It analyzes all Go source files in the `pkg/` directory to identify functions that might be in the wrong place. @@ -69,13 +69,13 @@ You can add these workflows to your own repository and remix them. Get going wit **Semantic Function Refactor:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/semantic-function-refactor.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/semantic-function-refactor.md ``` **Large File Simplifier:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-file-diet.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-file-diet.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-simplicity.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-simplicity.md index 125d858041e..c6008f9fc73 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-simplicity.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-simplicity.md @@ -28,8 +28,8 @@ Now let's meet the agents that work quietly in the background to keep code simpl The next two agents represent different aspects of code simplicity: detecting *overcomplicated code* and *duplicated logic*: -- **[Automatic Code Simplifier](https://github.com/githubnext/agentics/blob/main/.github/workflows/code-simplifier.md?plain=1)** - Analyzes recently modified code and creates PRs with simplifications -- **[Duplicate Code Detector](https://github.com/githubnext/agentics/blob/main/.github/workflows/duplicate-code-detector.md?plain=1)** - Uses Serena's semantic analysis to identify duplicate code patterns +- **[Automatic Code Simplifier](https://github.com/githubnext/agentics/blob/main/workflows/code-simplifier.md?plain=1)** - Analyzes recently modified code and creates PRs with simplifications +- **[Duplicate Code Detector](https://github.com/githubnext/agentics/blob/main/workflows/duplicate-code-detector.md?plain=1)** - Uses Serena's semantic analysis to identify duplicate code patterns The **Automatic Code Simplifier** runs daily, analyzing recently modified code for opportunities to simplify without changing functionality. It looks at what changed in the last few commits and asks: "Could this be clearer? Could it be shorter? Could it be more idiomatic?" @@ -65,13 +65,13 @@ You can add these workflows to your own repository and remix them. Get going wit **Automatic Code Simplifier:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/code-simplifier.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/code-simplifier.md ``` **Duplicate Code Detector:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/duplicate-code-detector.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/duplicate-code-detector.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-style.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-style.md index 81ca1e2fd70..80ea1fa793c 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-style.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-style.md @@ -24,7 +24,7 @@ In our [previous posts](/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-sim ## A Continuous Style Workflow -Today's post is dedicated to one agent, and the larger concept it represents: the **[Terminal Stylist](https://github.com/githubnext/agentics/blob/main/.github/workflows/terminal-stylist.md?plain=1)** workflow. This agent's purpose is to **make things look better**, by reviewing and enhancing the style of command-line interface (CLI) output. +Today's post is dedicated to one agent, and the larger concept it represents: the **[Terminal Stylist](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/terminal-stylist.md?plain=1)** workflow. This agent's purpose is to **make things look better**, by reviewing and enhancing the style of command-line interface (CLI) output. Command-line interfaces are a primary interaction point for developer tools. When output is inconsistent or noisy, it still β€œworks,” but it adds friction. When it’s well-styled, information becomes scannable, color highlights what matters, layouts remain readable across light and dark themes, and the overall experience feels professional. @@ -51,7 +51,7 @@ You can add this workflow to your own repository and remix it as follows: **Terminal Stylist:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/terminal-stylist.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/terminal-stylist.md ``` Then edit and remix the workflow specification to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md index aca2bffe32d..468c8de48c3 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md @@ -28,11 +28,11 @@ But here's the thing: work doesn't have to be all business. While we've built se These agents facilitate team communication and remind us that work can be fun: -- **[Daily Team Status](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-team-status.md?plain=1)** - Shares team mood and status updates - **22 issues**, **17 discussions** (plus 2 causal chain PRs!) -- **[Daily News](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-news.md?plain=1)** - Curates relevant news for the team - **45 news digest discussions** -- **[Poem Bot](https://github.com/githubnext/agentics/blob/main/.github/workflows/poem-bot.md?plain=1)** - Responds to `/poem-bot` commands with creative verses (yes, really) -- **[Weekly Issue Summary](https://github.com/githubnext/agentics/blob/main/.github/workflows/weekly-issue-summary.md?plain=1)** - Creates digestible summaries complete with charts and trends - **5 weekly analysis discussions** -- **[Daily Repo Chronicle](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-repo-chronicle.md?plain=1)** - Narrates the day's activity like a storyteller - **6 chronicle discussions** +- **[Daily Team Status](https://github.com/githubnext/agentics/blob/main/workflows/daily-team-status.md?plain=1)** - Shares team mood and status updates - **22 issues**, **17 discussions** (plus 2 causal chain PRs!) +- **[Daily News](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-news.md?plain=1)** - Curates relevant news for the team - **45 news digest discussions** +- **[Poem Bot](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/poem-bot.md?plain=1)** - Responds to `/poem-bot` commands with creative verses (yes, really) +- **[Weekly Issue Summary](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/weekly-issue-summary.md?plain=1)** - Creates digestible summaries complete with charts and trends - **5 weekly analysis discussions** +- **[Daily Repo Chronicle](https://github.com/githubnext/agentics/blob/main/workflows/daily-repo-chronicle.md?plain=1)** - Narrates the day's activity like a storyteller - **6 chronicle discussions** The Poem Bot started as a whimsy in our Copilot for PRs project in 2022. Someone said "wouldn't it be funny if we had an agent that writes poems about our code?" and then we built it. Poem Bot responds to `/poem-bot` commands with creative verses about code, adding a touch of whimsy to the development workflow. We learned that AI agents don't have to be all business - they can build culture and create moments of joy. @@ -57,31 +57,31 @@ You can add these workflows to your own repository and remix them. Get going wit **Daily Team Status:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-team-status.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/daily-team-status.md ``` **Daily News:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-news.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-news.md ``` **Poem Bot:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/poem-bot.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/poem-bot.md ``` **Weekly Issue Summary:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/weekly-issue-summary.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/weekly-issue-summary.md ``` **Daily Repo Chronicle:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-repo-chronicle.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/daily-repo-chronicle.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md index f3c887017d0..afd2ee235e8 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md @@ -28,13 +28,13 @@ Now let's address one of software development's eternal challenges: keeping docu These agents maintain high-quality documentation and content: -- **[Daily Documentation Updater](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-doc-updater.md?plain=1)** - Reviews and updates documentation to ensure accuracy and completeness - **57 merged PRs out of 59 proposed (96% merge rate)** -- **[Glossary Maintainer](https://github.com/githubnext/agentics/blob/main/.github/workflows/glossary-maintainer.md?plain=1)** - Keeps glossary synchronized with codebase - **10 merged PRs out of 10 proposed (100% merge rate)** -- **[Documentation Unbloat](https://github.com/githubnext/agentics/blob/main/.github/workflows/unbloat-docs.md?plain=1)** - Reviews and simplifies documentation by reducing verbosity - **88 merged PRs out of 103 proposed (85% merge rate)** -- **[Documentation Noob Tester](https://github.com/githubnext/agentics/blob/main/.github/workflows/docs-noob-tester.md?plain=1)** - Tests documentation as a new user would, identifying confusing steps - **9 merged PRs (43% merge rate)** via causal chain -- **[Slide Deck Maintainer](https://github.com/githubnext/agentics/blob/main/.github/workflows/slide-deck-maintainer.md?plain=1)** - Maintains presentation slide decks - **2 merged PRs out of 5 proposed (40% merge rate)** -- **[Multi-device Docs Tester](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation site across mobile, tablet, and desktop devices - **2 merged PRs out of 2 proposed (100% merge rate)** -- **[Blog Auditor](https://github.com/githubnext/agentics/blob/main/.github/workflows/blog-auditor.md?plain=1)** - Verifies blog posts are accessible and contain expected content - **6 audits completed** (5 passed, 1 flagged issues) +- **[Daily Documentation Updater](https://github.com/githubnext/agentics/blob/main/workflows/daily-doc-updater.md?plain=1)** - Reviews and updates documentation to ensure accuracy and completeness - **57 merged PRs out of 59 proposed (96% merge rate)** +- **[Glossary Maintainer](https://github.com/githubnext/agentics/blob/main/workflows/glossary-maintainer.md?plain=1)** - Keeps glossary synchronized with codebase - **10 merged PRs out of 10 proposed (100% merge rate)** +- **[Documentation Unbloat](https://github.com/githubnext/agentics/blob/main/workflows/unbloat-docs.md?plain=1)** - Reviews and simplifies documentation by reducing verbosity - **88 merged PRs out of 103 proposed (85% merge rate)** +- **[Documentation Noob Tester](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/docs-noob-tester.md?plain=1)** - Tests documentation as a new user would, identifying confusing steps - **9 merged PRs (43% merge rate)** via causal chain +- **[Slide Deck Maintainer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/slide-deck-maintainer.md?plain=1)** - Maintains presentation slide decks - **2 merged PRs out of 5 proposed (40% merge rate)** +- **[Multi-device Docs Tester](https://github.com/githubnext/agentics/blob/main/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation site across mobile, tablet, and desktop devices - **2 merged PRs out of 2 proposed (100% merge rate)** +- **[Blog Auditor](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/blog-auditor.md?plain=1)** - Verifies blog posts are accessible and contain expected content - **6 audits completed** (5 passed, 1 flagged issues) Documentation is where we challenged conventional wisdom. Can AI agents write *good* documentation? @@ -59,43 +59,43 @@ You can add these workflows to your own repository and remix them. Get going wit **Daily Documentation Updater:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-doc-updater.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/daily-doc-updater.md ``` **Glossary Maintainer:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/glossary-maintainer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/glossary-maintainer.md ``` **Documentation Unbloat:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/unbloat-docs.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/unbloat-docs.md ``` **Documentation Noob Tester:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/docs-noob-tester.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/docs-noob-tester.md ``` **Slide Deck Maintainer:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/slide-deck-maintainer.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/slide-deck-maintainer.md ``` **Multi-device Docs Tester:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-multi-device-docs-tester.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/daily-multi-device-docs-tester.md ``` **Blog Auditor:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/blog-auditor.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/blog-auditor.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md index afa279ec1d3..9f407df1f5e 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md @@ -30,9 +30,9 @@ We learned that the right agent at the right moment with the right information i These agents respond to commands, providing on-demand assistance whenever you need it: -- **[Q](https://github.com/githubnext/agentics/blob/main/.github/workflows/q.md?plain=1)** - Workflow optimizer that investigates performance and creates PRs - **69 merged PRs out of 88 proposed (78% merge rate)** -- **[Grumpy Reviewer](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md?plain=1)** - Performs critical code reviews with personality - creates issues for downstream agents -- **[Workflow Generator](https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-generator.md?plain=1)** - Creates new workflows from issue requests - scaffolds workflow files +- **[Q](https://github.com/githubnext/agentics/blob/main/workflows/q.md?plain=1)** - Workflow optimizer that investigates performance and creates PRs - **69 merged PRs out of 88 proposed (78% merge rate)** +- **[Grumpy Reviewer](https://github.com/githubnext/agentics/blob/main/workflows/grumpy-reviewer.md?plain=1)** - Performs critical code reviews with personality - creates issues for downstream agents +- **[Workflow Generator](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-generator.md?plain=1)** - Creates new workflows from issue requests - scaffolds workflow files Interactive workflows changed how we think about agent invocation. Instead of everything running on a schedule, these respond to slash commands and reactions - `/q` summons the workflow optimizer, a πŸš€ reaction triggers analysis. Q (yes, named after the James Bond quartermaster) became our go-to troubleshooter - it has contributed **69 merged PRs out of 88 proposed (78% merge rate)**, responding to commands and investigating workflow issues on demand. Recent examples include [fixing the daily-fact workflow action-tag](https://github.com/github/gh-aw/pull/14127) and [configuring PR triage reports with 1-day expiration](https://github.com/github/gh-aw/pull/13903). @@ -49,19 +49,19 @@ You can add these workflows to your own repository and remix them. Get going wit **Q:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/q.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/q.md ``` **Grumpy Reviewer:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/grumpy-reviewer.md ``` **Workflow Generator:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-generator.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-generator.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md index 100a1a0b2ae..331df442ca4 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md @@ -28,10 +28,10 @@ Now let's talk about the daily rituals of software development: managing issues These agents enhance issue and pull request workflows: -- **[Issue Arborist](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-arborist.md?plain=1)** - Links related issues as sub-issues - **77 discussion reports** and **18 parent issues** created -- **[Issue Monster](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-monster.md?plain=1)** - Assigns issues to the asynchronous [GitHub Copilot coding agent](https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent) one at a time - **task dispatcher** for the whole system -- **[Mergefest](https://github.com/githubnext/agentics/blob/main/.github/workflows/mergefest.md?plain=1)** - Automatically merges main branch into PR branches - **orchestrator workflow** -- **[Sub Issue Closer](https://github.com/githubnext/agentics/blob/main/.github/workflows/sub-issue-closer.md?plain=1)** - Closes completed sub-issues automatically - **orchestrator workflow** +- **[Issue Arborist](https://github.com/githubnext/agentics/blob/main/workflows/issue-arborist.md?plain=1)** - Links related issues as sub-issues - **77 discussion reports** and **18 parent issues** created +- **[Issue Monster](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-monster.md?plain=1)** - Assigns issues to the asynchronous [GitHub Copilot coding agent](https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent) one at a time - **task dispatcher** for the whole system +- **[Mergefest](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mergefest.md?plain=1)** - Automatically merges main branch into PR branches - **orchestrator workflow** +- **[Sub Issue Closer](https://github.com/githubnext/agentics/blob/main/workflows/sub-issue-closer.md?plain=1)** - Closes completed sub-issues automatically - **orchestrator workflow** The Issue Arborist is an **organizational workflow** that has created **77 discussion reports** (titled "[Issue Arborist] Issue Arborist Report") and **18 parent issues** to group related sub-issues. It keeps the issue tracker organized by automatically linking related issues, building a dependency tree we'd never maintain manually. For example, [#12037](https://github.com/github/gh-aw/issues/12037) grouped engine documentation updates. @@ -50,25 +50,25 @@ You can add these workflows to your own repository and remix them. Get going wit **Issue Arborist:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-arborist.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/issue-arborist.md ``` **Issue Monster:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-monster.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-monster.md ``` **Mergefest:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/mergefest.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mergefest.md ``` **Sub Issue Closer:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/sub-issue-closer.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/sub-issue-closer.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-metrics-analytics.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-metrics-analytics.md index 10e2b2469d0..cbdf0caad26 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-metrics-analytics.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-metrics-analytics.md @@ -28,9 +28,9 @@ When you're running dozens of AI agents, how do you know if they're actually wor Let's take a look at these three workflows: -- **[Metrics Collector](https://github.com/githubnext/agentics/blob/main/.github/workflows/metrics-collector.md?plain=1)** - Tracks daily performance across the entire agent ecosystem -- **[Portfolio Analyst](https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md?plain=1)** - Identifies cost reduction opportunities -- **[Audit Workflows](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md?plain=1)** - A meta-agent that audits all the other agents' runs +- **[Metrics Collector](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/metrics-collector.md?plain=1)** - Tracks daily performance across the entire agent ecosystem +- **[Portfolio Analyst](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/portfolio-analyst.md?plain=1)** - Identifies cost reduction opportunities +- **[Audit Workflows](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/audit-workflows.md?plain=1)** - A meta-agent that audits all the other agents' runs The Metrics Collector has created **41 daily metrics discussions** tracking performance across the agent ecosystem - for example, [#6986](https://github.com/github/gh-aw/discussions/6986) with the daily code metrics report. It became our central nervous system, gathering performance data that feeds into higher-level orchestrators. @@ -47,19 +47,19 @@ You can add these workflows to your own repository and remix them. Get going wit **Metrics Collector:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/metrics-collector.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/metrics-collector.md ``` **Portfolio Analyst:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/portfolio-analyst.md ``` **Audit Workflows:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/audit-workflows.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-operations-release.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-operations-release.md index e33fd9981aa..df68110ebaa 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-operations-release.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-operations-release.md @@ -26,8 +26,8 @@ In our [previous post](/gh-aw/blog/2026-01-13-meet-the-workflows-metrics-analyti The agents that help us actually ship software: -- **[Changeset](https://github.com/githubnext/agentics/blob/main/.github/workflows/changeset.md?plain=1)** - Manages version bumps and changelog entries for releases - **22 merged PRs out of 28 proposed (78% merge rate)** -- **[Daily Workflow Updater](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-workflow-updater.md?plain=1)** - Keeps GitHub Actions and dependencies current +- **[Changeset](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/changeset.md?plain=1)** - Manages version bumps and changelog entries for releases - **22 merged PRs out of 28 proposed (78% merge rate)** +- **[Daily Workflow Updater](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-workflow-updater.md?plain=1)** - Keeps GitHub Actions and dependencies current Shipping software is stressful enough without worrying about whether you formatted your release notes correctly. @@ -42,7 +42,7 @@ You can add these workflows to your own repository and remix them. Get going wit **Changeset:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/changeset.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/changeset.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-organization.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-organization.md index 5a75ef104d3..b9b6274eb79 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-organization.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-organization.md @@ -28,9 +28,9 @@ But all that sophisticated functionality has focused on a single repository. Wha These agents work at organization scale, across multiple repositories: -- **[Org Health Report](https://github.com/githubnext/agentics/blob/main/.github/workflows/org-health-report.md?plain=1)** - Organization-wide repository health metrics - **4 organization health discussions** created -- **[Stale Repo Identifier](https://github.com/githubnext/agentics/blob/main/.github/workflows/stale-repo-identifier.md?plain=1)** - Identifies inactive repositories - **2 issues** flagging truly stale repos -- **[Ubuntu Image Analyzer](https://github.com/githubnext/agentics/blob/main/.github/workflows/ubuntu-image-analyzer.md?plain=1)** - Documents GitHub Actions runner environments - **4 merged PRs out of 8 proposed (50% merge rate)** +- **[Org Health Report](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/org-health-report.md?plain=1)** - Organization-wide repository health metrics - **4 organization health discussions** created +- **[Stale Repo Identifier](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/stale-repo-identifier.md?plain=1)** - Identifies inactive repositories - **2 issues** flagging truly stale repos +- **[Ubuntu Image Analyzer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/ubuntu-image-analyzer.md?plain=1)** - Documents GitHub Actions runner environments - **4 merged PRs out of 8 proposed (50% merge rate)** Scaling agents across an entire organization changes the game. Org Health Report has created **4 organization health discussions** analyzing dozens of repositories at scale - for example, [#6777](https://github.com/github/gh-aw/discussions/6777) with the December 2025 organization health report. It identifies patterns and outliers ("these three repos have no tests, these five haven't been updated in months"). @@ -47,19 +47,19 @@ You can add these workflows to your own repository and remix them. Get going wit **Org Health Report:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/org-health-report.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/org-health-report.md ``` **Stale Repo Identifier:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/stale-repo-identifier.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/stale-repo-identifier.md ``` **Ubuntu Image Analyzer:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/ubuntu-image-analyzer.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/ubuntu-image-analyzer.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md index 0f8f78fd6d0..c7f4953cf98 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md @@ -30,9 +30,9 @@ Now let's shift from collaboration ceremony to fault investigation. These are our diligent caretakers - the agents that spot problems before they become bigger problems: -- **[CI Doctor](https://github.com/githubnext/agentics/blob/main/.github/workflows/ci-doctor.md?plain=1)** - Investigates failed workflows and opens diagnostic issues - **9 merged PRs out of 13 proposed (69% merge rate)** -- **[Schema Consistency Checker](https://github.com/githubnext/agentics/blob/main/.github/workflows/schema-consistency-checker.md?plain=1)** - Detects when schemas, code, and docs drift apart - **55 analysis discussions** created -- **[Breaking Change Checker](https://github.com/githubnext/agentics/blob/main/.github/workflows/breaking-change-checker.md?plain=1)** - Watches for changes that might break things for users - creates alert issues +- **[CI Doctor](https://github.com/githubnext/agentics/blob/main/workflows/ci-doctor.md?plain=1)** - Investigates failed workflows and opens diagnostic issues - **9 merged PRs out of 13 proposed (69% merge rate)** +- **[Schema Consistency Checker](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/schema-consistency-checker.md?plain=1)** - Detects when schemas, code, and docs drift apart - **55 analysis discussions** created +- **[Breaking Change Checker](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/breaking-change-checker.md?plain=1)** - Watches for changes that might break things for users - creates alert issues The CI Doctor (also known as "CI Failure Doctor") was one of our most important workflows. Instead of drowning in CI failure notifications, we now get *timely*, *investigated* failures with actual diagnostic insights. The agent doesn't just tell us something broke - it analyzes logs, identifies patterns, searches for similar past issues, and even suggests fixes - even before the human has read the failure notification. CI Failure Doctor has contributed **9 merged PRs out of 13 proposed (69% merge rate)**, including fixes like [adding Go module download pre-flight checks](https://github.com/github/gh-aw/pull/13740) and [adding retry logic to prevent proxy 403 failures](https://github.com/github/gh-aw/pull/13155). We learned that agents excel at the tedious investigation work that humans find draining. @@ -51,19 +51,19 @@ You can add these workflows to your own repository and remix them. Get going wit **CI Doctor:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/ci-doctor.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/ci-doctor.md ``` **Schema Consistency Checker:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/schema-consistency-checker.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/schema-consistency-checker.md ``` **Breaking Change Checker:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/breaking-change-checker.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/breaking-change-checker.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md index 6740a1c0375..0d36d8f3f4c 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md @@ -28,11 +28,11 @@ But reliability alone isn't enough - we also need *security*. When AI agents can These agents are our security guards, keeping watch and enforcing the rules: -- **[Security Compliance](https://github.com/githubnext/agentics/blob/main/.github/workflows/security-compliance.md?plain=1)** - Runs vulnerability campaigns with deadline tracking -- **[Firewall](https://github.com/githubnext/agentics/blob/main/.github/workflows/firewall.md?plain=1)** - Tests network security and validates rules - **59 daily firewall report discussions**, **5 smoke test issues** -- **[Daily Secrets Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-secrets-analysis.md?plain=1)** - Scans for exposed credentials (yes, it happens) -- **[Daily Malicious Code Scan](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-malicious-code-scan.md?plain=1)** - Reviews recent code changes for suspicious patterns -- **[Static Analysis Report](https://github.com/githubnext/agentics/blob/main/.github/workflows/static-analysis-report.md?plain=1)** - Daily security scans using zizmor, poutine, and actionlint - **57 analysis discussions** plus **12 Zizmor security reports** +- **[Security Compliance](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/security-compliance.md?plain=1)** - Runs vulnerability campaigns with deadline tracking +- **[Firewall](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/firewall.md?plain=1)** - Tests network security and validates rules - **59 daily firewall report discussions**, **5 smoke test issues** +- **[Daily Secrets Analysis](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-secrets-analysis.md?plain=1)** - Scans for exposed credentials (yes, it happens) +- **[Daily Malicious Code Scan](https://github.com/githubnext/agentics/blob/main/workflows/daily-malicious-code-scan.md?plain=1)** - Reviews recent code changes for suspicious patterns +- **[Static Analysis Report](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/static-analysis-report.md?plain=1)** - Daily security scans using zizmor, poutine, and actionlint - **57 analysis discussions** plus **12 Zizmor security reports** Security Compliance manages vulnerability remediation campaigns with deadline tracking, ensuring security issues are addressed within defined SLAs - perfect for those "audit in 3 weeks" panic moments. @@ -51,31 +51,31 @@ You can add these workflows to your own repository and remix them. Get going wit **Security Compliance:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/security-compliance.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/security-compliance.md ``` **Firewall:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/firewall.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/firewall.md ``` **Daily Secrets Analysis:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-secrets-analysis.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-secrets-analysis.md ``` **Daily Malicious Code Scan:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-malicious-code-scan.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/daily-malicious-code-scan.md ``` **Static Analysis Report:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/static-analysis-report.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/static-analysis-report.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md index 687fffb1e60..d14345447be 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md @@ -30,19 +30,19 @@ These agents keep everything running smoothly through continuous testing: ### Code Quality & Test Validation -- **[Daily Testify Uber Super Expert](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-testify-uber-super-expert.md?plain=1)** - Analyzes test files daily and suggests testify-based improvements - **19 issues created**, **13 led to merged PRs (100% causal chain merge rate)** +- **[Daily Testify Uber Super Expert](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-testify-uber-super-expert.md?plain=1)** - Analyzes test files daily and suggests testify-based improvements - **19 issues created**, **13 led to merged PRs (100% causal chain merge rate)** - **[Daily Test Improver](https://github.com/githubnext/agentics/blob/main/workflows/daily-test-improver.md?plain=1)** - Identifies coverage gaps and implements new tests incrementally -- **[Daily Compiler Quality Check](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-compiler-quality.md?plain=1)** - Analyzes compiler code to ensure it meets quality standards +- **[Daily Compiler Quality Check](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-compiler-quality.md?plain=1)** - Analyzes compiler code to ensure it meets quality standards ### User Experience & Integration Testing -- **[Daily Multi-Device Docs Tester](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation across devices with Playwright - **2 merged PRs out of 2 proposed (100% merge rate)** -- **[CLI Consistency Checker](https://github.com/githubnext/agentics/blob/main/.github/workflows/cli-consistency-checker.md?plain=1)** - Inspects the CLI for inconsistencies, typos, and documentation gaps - **80 merged PRs out of 102 proposed (78% merge rate)** +- **[Daily Multi-Device Docs Tester](https://github.com/githubnext/agentics/blob/main/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation across devices with Playwright - **2 merged PRs out of 2 proposed (100% merge rate)** +- **[CLI Consistency Checker](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/cli-consistency-checker.md?plain=1)** - Inspects the CLI for inconsistencies, typos, and documentation gaps - **80 merged PRs out of 102 proposed (78% merge rate)** ### CI/CD Optimization -- **[CI Coach](https://github.com/githubnext/agentics/blob/main/.github/workflows/ci-coach.md?plain=1)** - Analyzes CI pipelines and suggests optimizations - **9 merged PRs out of 9 proposed (100% merge rate)** -- **[Workflow Health Manager](https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-health-manager.md?plain=1)** - Meta-orchestrator monitoring health of all agentic workflows - **40 issues created**, **5 direct PRs + 14 causal chain PRs merged** +- **[CI Coach](https://github.com/githubnext/agentics/blob/main/workflows/ci-coach.md?plain=1)** - Analyzes CI pipelines and suggests optimizations - **9 merged PRs out of 9 proposed (100% merge rate)** +- **[Workflow Health Manager](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-health-manager.md?plain=1)** - Meta-orchestrator monitoring health of all agentic workflows - **40 issues created**, **5 direct PRs + 14 causal chain PRs merged** The Daily Testify Expert has created **19 issues** analyzing test quality, and **13 of those issues led to merged PRs** by downstream agents - a perfect 100% causal chain merge rate. For example, [issue #13701](https://github.com/github/gh-aw/issues/13701) led to [#13722](https://github.com/github/gh-aw/pull/13722) modernizing console render tests with testify assertions. The Daily Test Improver works alongside it to identify coverage gaps and implement new tests. @@ -61,7 +61,7 @@ You can add these workflows to your own repository and remix them. Get going wit **Daily Testify Uber Super Expert:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-testify-uber-super-expert.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-testify-uber-super-expert.md ``` **Daily Test Improver:** @@ -73,31 +73,31 @@ gh aw add-wizard githubnext/agentics/daily-test-improver **Daily Compiler Quality Check:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-compiler-quality.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-compiler-quality.md ``` **Daily Multi-Device Docs Tester:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-multi-device-docs-tester.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/daily-multi-device-docs-tester.md ``` **CLI Consistency Checker:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/cli-consistency-checker.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/cli-consistency-checker.md ``` **CI Coach:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/ci-coach.md +gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/ci-coach.md ``` **Workflow Health Manager:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-health-manager.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-health-manager.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-tool-infrastructure.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-tool-infrastructure.md index 61ef7123c8f..ce935c0ac53 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-tool-infrastructure.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-tool-infrastructure.md @@ -28,9 +28,9 @@ But here's a question that kept us up at night: what if the *infrastructure itse These agents monitor and analyze the agentic infrastructure itself: -- **[MCP Inspector](https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md?plain=1)** - Validates Model Context Protocol configurations - ensures agents can access tools -- **[GitHub MCP Tools Report](https://github.com/githubnext/agentics/blob/main/.github/workflows/github-mcp-tools-report.md?plain=1)** - Analyzes available MCP tools - **5 merged PRs out of 6 proposed (83% merge rate)** -- **[Agent Performance Analyzer](https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md?plain=1)** - Meta-orchestrator for agent quality - **29 issues created, 14 leading to PRs (8 merged)** +- **[MCP Inspector](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mcp-inspector.md?plain=1)** - Validates Model Context Protocol configurations - ensures agents can access tools +- **[GitHub MCP Tools Report](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/github-mcp-tools-report.md?plain=1)** - Analyzes available MCP tools - **5 merged PRs out of 6 proposed (83% merge rate)** +- **[Agent Performance Analyzer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/agent-performance-analyzer.md?plain=1)** - Meta-orchestrator for agent quality - **29 issues created, 14 leading to PRs (8 merged)** Infrastructure for AI agents is different from traditional infrastructure - you need to validate that tools are available, properly configured, and actually working. The MCP Inspector continuously validates Model Context Protocol server configurations because a misconfigured MCP server means an agent can't access the tools it needs. @@ -49,19 +49,19 @@ You can add these workflows to your own repository and remix them. Get going wit **MCP Inspector:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mcp-inspector.md ``` **GitHub MCP Tools Report:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/github-mcp-tools-report.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/github-mcp-tools-report.md ``` **Agent Performance Analyzer:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/agent-performance-analyzer.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows.md index 14e0ca03deb..e537d38c687 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows.md @@ -32,7 +32,7 @@ Issue triage represents a "hello world" of automated agentic workflows: practica When a new issue is opened, the triage agent analyzes its content, does research in the codebase and other issues, responds with a comment, and applies appropriate labels based on predefined categories. This helps maintainers quickly understand the nature of incoming issues without manual review. -Let's take a look at the full **[Issue Triage Agent](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md?plain=1)**: +Let's take a look at the full **[Issue Triage Agent](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-triage-agent.md?plain=1)**: ```markdown --- @@ -87,7 +87,7 @@ You can add this workflow to your own repository and remix it as follows: **Issue Triage Agent:** ```bash -gh aw add-wizard https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md +gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-triage-agent.md ``` Then edit and remix the workflow specification to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-21-twelve-lessons.md b/docs/src/content/docs/blog/2026-01-21-twelve-lessons.md index bfd2c9e56ee..1a91545bda1 100644 --- a/docs/src/content/docs/blog/2026-01-21-twelve-lessons.md +++ b/docs/src/content/docs/blog/2026-01-21-twelve-lessons.md @@ -43,17 +43,17 @@ With clear boundaries in place, we can prototype new agents without worrying abo Agents that watch other agents? Sounds meta, but they've become some of our most valuable workflows. They catch issues early and help us understand what's happening across the entire ecosystem. -Once we passed 50 workflows, tracking everything manually became impossible. Meta-agents like [Audit Workflows](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) and [Agent Performance Analyzer](https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md) give us the observability layer we desperately needed. They spot patterns across runs, identify struggling agents, and surface systemic issues we'd never catch looking at individual workflows. +Once we passed 50 workflows, tracking everything manually became impossible. Meta-agents like [Audit Workflows](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) and [Agent Performance Analyzer](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/agent-performance-analyzer.md) give us the observability layer we desperately needed. They spot patterns across runs, identify struggling agents, and surface systemic issues we'd never catch looking at individual workflows. ### Personality Matters Turns out, agents with distinct personalities - like the meticulous auditor, the helpful janitor, the creative poet - are way easier for teams to understand and trust. -We noticed generic names like "issue-handler" or "code-checker" created confusion. But when we gave agents personalities - like [Grumpy Reviewer](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md) or [Poem Bot](https://github.com/githubnext/agentics/blob/main/.github/workflows/poem-bot.md) - their purpose became immediately clear. Team members actually started developing relationships with specific agents. It's kind of adorable. +We noticed generic names like "issue-handler" or "code-checker" created confusion. But when we gave agents personalities - like [Grumpy Reviewer](https://github.com/githubnext/agentics/blob/main/workflows/grumpy-reviewer.md) or [Poem Bot](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/poem-bot.md) - their purpose became immediately clear. Team members actually started developing relationships with specific agents. It's kind of adorable. ### Cost-Quality Tradeoffs Are Real -Longer, more thorough analyses cost more - but they're not always better. The [Portfolio Analyst](https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md) helps us figure out which agents actually deliver value. +Longer, more thorough analyses cost more - but they're not always better. The [Portfolio Analyst](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/portfolio-analyst.md) helps us figure out which agents actually deliver value. We discovered that some of our "thorough" agents were doing redundant work or generating reports nobody read. The Portfolio Analyst tracks cost-per-insight across all agents, revealing that simple, focused agents often deliver better ROI than complex ones. This led us to consolidate overlapping agents and tune prompt lengths to balance thoroughness with cost. AI isn't free, folks! @@ -73,11 +73,11 @@ Instead of remembering complex webhook URLs or GitHub Actions syntax, team membe Frequent, lightweight validation tests (every 12 hours) catch regressions quickly. These "heartbeat" agents keep the infrastructure healthy without manual monitoring. -Instead of waiting for production failures, we deploy multiple [smoke test workflows](https://github.com/githubnext/agentics/blob/main/.github/workflows/smoke-copilot.md) that continuously validate core functionality. When a smoke test fails, we know immediately which component broke. This proactive monitoring prevents cascading failures and gives us confidence that the ecosystem is actually stable. +Instead of waiting for production failures, we deploy multiple [smoke test workflows](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/smoke-copilot.md) that continuously validate core functionality. When a smoke test fails, we know immediately which component broke. This proactive monitoring prevents cascading failures and gives us confidence that the ecosystem is actually stable. ### MCP Inspection Is Essential -As workflows start using multiple MCP servers, having agents that can validate and report on tool availability becomes critical. The [MCP Inspector](https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md) pattern prevents those cryptic "tool not available" failures. +As workflows start using multiple MCP servers, having agents that can validate and report on tool availability becomes critical. The [MCP Inspector](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mcp-inspector.md) pattern prevents those cryptic "tool not available" failures. Early on, we'd see agents fail with vague errors like "connection refused." The MCP Inspector proactively checks all MCP server configurations, validates network access, and generates status reports. This visibility transformed debugging from hours of detective work into reading a dashboard. @@ -91,7 +91,7 @@ Whether managing a backlog of refactoring work, coordinating security fixes, or Applying clustering and NLP to agent interactions revealed usage patterns that weren't obvious from individual runs. This meta-analysis helped identify opportunities for consolidation and optimization. -The [Prompt Clustering Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/prompt-clustering-analysis.md) and [Copilot PR NLP Analysis](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-pr-nlp-analysis.md) workflows discovered that many agents were asking similar questions or performing redundant analyses. This insight led to shared component libraries and consolidation opportunities we wouldn't have spotted through manual review. +The [Prompt Clustering Analysis](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/prompt-clustering-analysis.md) and [Copilot PR NLP Analysis](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/copilot-pr-nlp-analysis.md) workflows discovered that many agents were asking similar questions or performing redundant analyses. This insight led to shared component libraries and consolidation opportunities we wouldn't have spotted through manual review. ## Challenges We've Encountered diff --git a/docs/src/content/docs/blog/2026-01-24-design-patterns.md b/docs/src/content/docs/blog/2026-01-24-design-patterns.md index 9b39b94d6cc..0bbdd133fcb 100644 --- a/docs/src/content/docs/blog/2026-01-24-design-patterns.md +++ b/docs/src/content/docs/blog/2026-01-24-design-patterns.md @@ -44,11 +44,11 @@ Use these when: Here are some examples: -- [`audit-workflows`](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) - Meta-agent that audits all other agents' runs -- [`portfolio-analyst`](https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md) - Spots cost optimization opportunities -- [`session-insights`](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-session-insights.md) - Analyzes Copilot usage patterns -- [`org-health-report`](https://github.com/githubnext/agentics/blob/main/.github/workflows/org-health-report.md) - Organization-wide health metrics -- [`scout`](https://github.com/githubnext/agentics/blob/main/.github/workflows/scout.md), [`archie`](https://github.com/githubnext/agentics/blob/main/.github/workflows/archie.md) - Deep research agents +- [`audit-workflows`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) - Meta-agent that audits all other agents' runs +- [`portfolio-analyst`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/portfolio-analyst.md) - Spots cost optimization opportunities +- [`session-insights`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/copilot-session-insights.md) - Analyzes Copilot usage patterns +- [`org-health-report`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/org-health-report.md) - Organization-wide health metrics +- [`scout`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/scout.md), [`archie`](https://github.com/githubnext/agentics/blob/main/workflows/archie.md) - Deep research agents Some key characteristics are: @@ -75,10 +75,10 @@ Use these when: Here are some examples: -- [`q`](https://github.com/githubnext/agentics/blob/main/.github/workflows/q.md) - Workflow optimizer (type `/q` and it investigates!) -- [`grumpy-reviewer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md) - Critical code review with personality -- [`poem-bot`](https://github.com/githubnext/agentics/blob/main/.github/workflows/poem-bot.md) - Creative verse generation (because why not?) -- [`mergefest`](https://github.com/githubnext/agentics/blob/main/.github/workflows/mergefest.md) - Branch merging automation +- [`q`](https://github.com/githubnext/agentics/blob/main/workflows/q.md) - Workflow optimizer (type `/q` and it investigates!) +- [`grumpy-reviewer`](https://github.com/githubnext/agentics/blob/main/workflows/grumpy-reviewer.md) - Critical code review with personality +- [`poem-bot`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/poem-bot.md) - Creative verse generation (because why not?) +- [`mergefest`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mergefest.md) - Branch merging automation - [`pr-fix`](https://github.com/githubnext/agentics/blob/main/workflows/pr-fix.md) - Fixes failing CI checks on demand Some key characteristics are: @@ -107,10 +107,10 @@ Use these when: Here are some examples: -- [`daily-workflow-updater`](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-workflow-updater.md) - Keeps actions and dependencies current -- [`glossary-maintainer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/glossary-maintainer.md) - Syncs glossary with codebase -- [`daily-file-diet`](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-file-diet.md) - Refactors oversized files -- [`hourly-ci-cleaner`](https://github.com/githubnext/agentics/blob/main/.github/workflows/hourly-ci-cleaner.md) - Repairs CI issues +- [`daily-workflow-updater`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/daily-workflow-updater.md) - Keeps actions and dependencies current +- [`glossary-maintainer`](https://github.com/githubnext/agentics/blob/main/workflows/glossary-maintainer.md) - Syncs glossary with codebase +- [`daily-file-diet`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/daily-file-diet.md) - Refactors oversized files +- [`hourly-ci-cleaner`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/hourly-ci-cleaner.md) - Repairs CI issues Some key characteristics are: @@ -138,10 +138,10 @@ Use these when: Here are some examples: -- Smoke tests for [`copilot`](https://github.com/githubnext/agentics/blob/main/.github/workflows/smoke-copilot.md), [`claude`](https://github.com/githubnext/agentics/blob/main/.github/workflows/smoke-claude.md), [`codex`](https://github.com/githubnext/agentics/blob/main/.github/workflows/smoke-codex.md) -- [`schema-consistency-checker`](https://github.com/githubnext/agentics/blob/main/.github/workflows/schema-consistency-checker.md) -- [`breaking-change-checker`](https://github.com/githubnext/agentics/blob/main/.github/workflows/breaking-change-checker.md) -- [`firewall`](https://github.com/githubnext/agentics/blob/main/.github/workflows/firewall.md), [`mcp-inspector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md) +- Smoke tests for [`copilot`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/smoke-copilot.md), [`claude`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/smoke-claude.md), [`codex`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/smoke-codex.md) +- [`schema-consistency-checker`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/schema-consistency-checker.md) +- [`breaking-change-checker`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/breaking-change-checker.md) +- [`firewall`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/firewall.md), [`mcp-inspector`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mcp-inspector.md) - [`daily-accessibility-review`](https://github.com/githubnext/agentics/blob/main/workflows/daily-accessibility-review.md) Some key characteristics are: @@ -170,10 +170,10 @@ Use these when: Here are some examples: -- [`issue-triage-agent`](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md) - Auto-labels and categorizes -- [`issue-arborist`](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-arborist.md) - Links related issues -- [`mergefest`](https://github.com/githubnext/agentics/blob/main/.github/workflows/mergefest.md) - Merge coordination -- [`sub-issue-closer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/sub-issue-closer.md) - Closes completed sub-issues +- [`issue-triage-agent`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/issue-triage-agent.md) - Auto-labels and categorizes +- [`issue-arborist`](https://github.com/githubnext/agentics/blob/main/workflows/issue-arborist.md) - Links related issues +- [`mergefest`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mergefest.md) - Merge coordination +- [`sub-issue-closer`](https://github.com/githubnext/agentics/blob/main/workflows/sub-issue-closer.md) - Closes completed sub-issues Some key characteristics are: @@ -233,11 +233,11 @@ Use these when: Here are some examples: -- [`duplicate-code-detector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/duplicate-code-detector.md) - Finds code duplicates -- [`semantic-function-refactor`](https://github.com/githubnext/agentics/blob/main/.github/workflows/semantic-function-refactor.md) - Refactoring opportunities -- [`terminal-stylist`](https://github.com/githubnext/agentics/blob/main/.github/workflows/terminal-stylist.md) - Console output analysis -- [`go-pattern-detector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/go-pattern-detector.md) - Go-specific patterns -- [`typist`](https://github.com/githubnext/agentics/blob/main/.github/workflows/typist.md) - Type analysis +- [`duplicate-code-detector`](https://github.com/githubnext/agentics/blob/main/workflows/duplicate-code-detector.md) - Finds code duplicates +- [`semantic-function-refactor`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/semantic-function-refactor.md) - Refactoring opportunities +- [`terminal-stylist`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/terminal-stylist.md) - Console output analysis +- [`go-pattern-detector`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/go-pattern-detector.md) - Go-specific patterns +- [`typist`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/typist.md) - Type analysis Some key characteristics are: @@ -265,10 +265,10 @@ Use these when: Here are some examples: -- [`glossary-maintainer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/glossary-maintainer.md) - Glossary synchronization -- [`technical-doc-writer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/technical-doc-writer.md) - Technical documentation -- [`slide-deck-maintainer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/slide-deck-maintainer.md) - Presentation maintenance -- [`ubuntu-image-analyzer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/ubuntu-image-analyzer.md) - Environment documentation +- [`glossary-maintainer`](https://github.com/githubnext/agentics/blob/main/workflows/glossary-maintainer.md) - Glossary synchronization +- [`technical-doc-writer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/technical-doc-writer.md) - Technical documentation +- [`slide-deck-maintainer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/slide-deck-maintainer.md) - Presentation maintenance +- [`ubuntu-image-analyzer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/ubuntu-image-analyzer.md) - Environment documentation Some key characteristics are: @@ -296,10 +296,10 @@ Use these when: Here are some examples: -- [`audit-workflows`](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) - Comprehensive workflow auditing -- [`agent-performance-analyzer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md) - Agent quality metrics -- [`portfolio-analyst`](https://github.com/githubnext/agentics/blob/main/.github/workflows/portfolio-analyst.md) - Cost optimization -- [`workflow-health-manager`](https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-health-manager.md) - Health monitoring +- [`audit-workflows`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) - Comprehensive workflow auditing +- [`agent-performance-analyzer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/agent-performance-analyzer.md) - Agent quality metrics +- [`portfolio-analyst`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/portfolio-analyst.md) - Cost optimization +- [`workflow-health-manager`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/workflow-health-manager.md) - Health monitoring Some key characteristics are: @@ -327,8 +327,8 @@ Use these when: Here are some examples: -- [`workflow-generator`](https://github.com/githubnext/agentics/blob/main/.github/workflows/workflow-generator.md) - Generates new workflows -- [`dev-hawk`](https://github.com/githubnext/agentics/blob/main/.github/workflows/dev-hawk.md) - Development monitoring +- [`workflow-generator`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/workflow-generator.md) - Generates new workflows +- [`dev-hawk`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/dev-hawk.md) - Development monitoring Some key characteristics are: @@ -356,9 +356,9 @@ Use these when: Here are some examples: -- [`copilot-session-insights`](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-session-insights.md) - Session usage analysis -- [`copilot-pr-nlp-analysis`](https://github.com/githubnext/agentics/blob/main/.github/workflows/copilot-pr-nlp-analysis.md) - NLP on PR conversations -- [`prompt-clustering`](https://github.com/githubnext/agentics/blob/main/.github/workflows/prompt-clustering-analysis.md) - Clusters and categorizes prompts +- [`copilot-session-insights`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/copilot-session-insights.md) - Session usage analysis +- [`copilot-pr-nlp-analysis`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/copilot-pr-nlp-analysis.md) - NLP on PR conversations +- [`prompt-clustering`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/prompt-clustering-analysis.md) - Clusters and categorizes prompts Some key characteristics are: @@ -386,11 +386,11 @@ Use these when: Here are some examples: -- [`security-compliance`](https://github.com/githubnext/agentics/blob/main/.github/workflows/security-compliance.md) - Vulnerability campaigns -- [`firewall`](https://github.com/githubnext/agentics/blob/main/.github/workflows/firewall.md) - Network security testing -- [`daily-secrets-analysis`](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-secrets-analysis.md) - Secret scanning -- [`ai-moderator`](https://github.com/githubnext/agentics/blob/main/.github/workflows/ai-moderator.md) - Comment spam filtering -- [`security-fix-pr`](https://github.com/githubnext/agentics/blob/main/.github/workflows/security-fix-pr.md) - Automated security fixes +- [`security-compliance`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/security-compliance.md) - Vulnerability campaigns +- [`firewall`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/firewall.md) - Network security testing +- [`daily-secrets-analysis`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/daily-secrets-analysis.md) - Secret scanning +- [`ai-moderator`](https://github.com/githubnext/agentics/blob/main/workflows/ai-moderator.md) - Comment spam filtering +- [`security-fix-pr`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/security-fix-pr.md) - Automated security fixes Some key characteristics are: diff --git a/docs/src/content/docs/blog/2026-01-27-operational-patterns.md b/docs/src/content/docs/blog/2026-01-27-operational-patterns.md index 484e45d681f..a278bb6b511 100644 --- a/docs/src/content/docs/blog/2026-01-27-operational-patterns.md +++ b/docs/src/content/docs/blog/2026-01-27-operational-patterns.md @@ -52,7 +52,7 @@ These workflows do the following: ### Example: Grumpy Reviewer -The [`grumpy-reviewer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md) workflow is a perfect example of this pattern: +The [`grumpy-reviewer`](https://github.com/githubnext/agentics/blob/main/workflows/grumpy-reviewer.md) workflow is a perfect example of this pattern: - Triggered by `/grumpy` on PR comments - Performs critical code review with distinctive personality @@ -150,7 +150,7 @@ These workflows do the following: ### Example: Issue Triage Agent -The [`issue-triage-agent`](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md) automatically labels and categorizes new issues: +The [`issue-triage-agent`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/issue-triage-agent.md) automatically labels and categorizes new issues: - Analyzes issue title and body - Applies relevant labels (bug, feature, documentation, etc.) @@ -315,7 +315,7 @@ These workflows do the following: ### Example: Duplicate Code Detection -The [`duplicate-code-detector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/duplicate-code-detector.md) uses ResearchPlanAssignOps: +The [`duplicate-code-detector`](https://github.com/githubnext/agentics/blob/main/workflows/duplicate-code-detector.md) uses ResearchPlanAssignOps: **Research**: Uses Serena MCP for semantic analysis, creates report **Plan**: Creates well-scoped issues (max 3 per run) with refactoring strategies @@ -364,7 +364,7 @@ These workflows do the following: ### Example: Org Health Report -The [`org-health-report`](https://github.com/githubnext/agentics/blob/main/.github/workflows/org-health-report.md) analyzes health metrics across all organization repositories: +The [`org-health-report`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/org-health-report.md) analyzes health metrics across all organization repositories: - Checks for outdated dependencies - Validates security policies diff --git a/docs/src/content/docs/blog/2026-01-30-imports-and-sharing.md b/docs/src/content/docs/blog/2026-01-30-imports-and-sharing.md index a7cea238b87..f5bbdf57096 100644 --- a/docs/src/content/docs/blog/2026-01-30-imports-and-sharing.md +++ b/docs/src/content/docs/blog/2026-01-30-imports-and-sharing.md @@ -37,7 +37,7 @@ Imports provide several game-changing benefits that transformed how we develop a When we improve report formatting or update an MCP server configuration, the change automatically propagates to all workflows that import it. No need to update 46 workflows individually. That's huge! -For example, when we enhanced the [`reporting.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/reporting.md) component with better formatting guidelines, all 46 workflows that imported it immediately benefited. One change, 46 workflows improved. Magic. +For example, when we enhanced the [`reporting.md`](https://github.com/githubnext/agentics/blob/main/workflows/shared/reporting.md) component with better formatting guidelines, all 46 workflows that imported it immediately benefited. One change, 46 workflows improved. Magic. ### 🧩 Composable Workflow Capabilities @@ -95,38 +95,38 @@ The factory organized shared components into two main directories: #### Most Popular Shared Components -**[`reporting.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/reporting.md?plain=1)** (46 imports) +**[`reporting.md`](https://github.com/githubnext/agentics/blob/main/workflows/shared/reporting.md?plain=1)** (46 imports) - Report formatting guidelines - Workflow run references - Footer standards - Consistent structure -**[`jqschema.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/jqschema.md?plain=1)** (17 imports) +**[`jqschema.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/jqschema.md?plain=1)** (17 imports) - JSON querying utilities - Schema validation - Data transformation patterns -**[`python-dataviz.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/python-dataviz.md?plain=1)** (7 imports) +**[`python-dataviz.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/python-dataviz.md?plain=1)** (7 imports) - Python environment with NumPy, Pandas, Matplotlib, Seaborn - Data visualization templates - Chart generation utilities -**[`trending-charts-simple.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/trending-charts-simple.md?plain=1)** (6 imports) +**[`trending-charts-simple.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/trending-charts-simple.md?plain=1)** (6 imports) - Quick setup for trend visualizations - Time-series analysis - Comparison charts -**[`gh.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/gh.md?plain=1)** (4 imports) +**[`gh.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/gh.md?plain=1)** (4 imports) - Safe-input wrapper for GitHub CLI - Authentication handling - Common gh commands -**[`copilot-pr-data-fetch.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/copilot-pr-data-fetch.md?plain=1)** (4 imports) +**[`copilot-pr-data-fetch.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/copilot-pr-data-fetch.md?plain=1)** (4 imports) - Fetch GitHub Copilot PR data - Cache management @@ -136,14 +136,14 @@ The factory organized shared components into two main directories: **Data Analysis** -- [`charts-with-trending.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/charts-with-trending.md) - Comprehensive trending with cache-memory -- [`ci-data-analysis.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/ci-data-analysis.md) - CI workflow analysis -- [`session-analysis-charts.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/session-analysis-charts.md) - Copilot session visualization +- [`charts-with-trending.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/charts-with-trending.md) - Comprehensive trending with cache-memory +- [`ci-data-analysis.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/ci-data-analysis.md) - CI workflow analysis +- [`session-analysis-charts.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/session-analysis-charts.md) - Copilot session visualization **Prompting & Output** -- [`keep-it-short.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/keep-it-short.md) - Guidance for concise responses -- [`safe-output-app.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/safe-output-app.md) - Safe output patterns +- [`keep-it-short.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/keep-it-short.md) - Guidance for concise responses +- [`safe-output-app.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/safe-output-app.md) - Safe output patterns ### MCP Server Configurations: `.github/workflows/shared/mcp/` @@ -151,31 +151,31 @@ The factory organized shared components into two main directories: #### Most Used MCP Servers -**[`gh-aw.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/gh-aw.md?plain=1)** (12 imports) +**[`gh-aw.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/gh-aw.md?plain=1)** (12 imports) - GH-AW as an MCP server - `logs` command for workflow debugging - Workflow metadata access -**[`tavily.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/tavily.md?plain=1)** (5 imports) +**[`tavily.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/tavily.md?plain=1)** (5 imports) - Web search via Tavily API - Research capabilities - Current information access -**[`markitdown.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/markitdown.md?plain=1)** (3 imports) +**[`markitdown.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/markitdown.md?plain=1)** (3 imports) - Document conversion (PDF, Office, images to Markdown) - Content extraction - Multimedia analysis -**[`ast-grep.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/ast-grep.md?plain=1)** (2 imports) +**[`ast-grep.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/ast-grep.md?plain=1)** (2 imports) - Structural code search and analysis - Pattern matching - Refactoring support -**[`brave.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/brave.md?plain=1)** (2 imports) +**[`brave.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/brave.md?plain=1)** (2 imports) - Alternative web search via Brave API - Privacy-focused search @@ -185,23 +185,23 @@ The factory organized shared components into two main directories: **Development Tools** -- [`jupyter.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/jupyter.md) - Jupyter notebook environment with Docker services -- [`skillz.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/skillz.md) - Dynamic skill loading from `.github/skills/` -- [`serena.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/serena.md) - Semantic code analysis +- [`jupyter.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/jupyter.md) - Jupyter notebook environment with Docker services +- [`skillz.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/skillz.md) - Dynamic skill loading from `.github/skills/` +- [`serena.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/serena.md) - Semantic code analysis **Knowledge & Search** -- [`context7.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/context7.md) - Context-aware search -- [`deepwiki.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/deepwiki.md) - Wikipedia deep search -- [`microsoft-docs.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/microsoft-docs.md) - Microsoft documentation -- [`arxiv.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/arxiv.md) - Academic paper research +- [`context7.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/context7.md) - Context-aware search +- [`deepwiki.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/deepwiki.md) - Wikipedia deep search +- [`microsoft-docs.md`](https://github.com/githubnext/agentics/blob/main/workflows/shared/mcp/microsoft-docs.md) - Microsoft documentation +- [`arxiv.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/arxiv.md) - Academic paper research **External Integrations** -- [`slack.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/slack.md) - Slack workspace integration -- [`notion.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/notion.md) - Notion workspace integration -- [`sentry.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/sentry.md) - Error tracking -- [`datadog.md`](https://github.com/githubnext/agentics/blob/main/.github/workflows/shared/mcp/datadog.md) - Observability platform +- [`slack.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/slack.md) - Slack workspace integration +- [`notion.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/notion.md) - Notion workspace integration +- [`sentry.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/sentry.md) - Error tracking +- [`datadog.md`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/shared/mcp/datadog.md) - Observability platform ## Import Statistics diff --git a/docs/src/content/docs/blog/2026-02-02-security-lessons.md b/docs/src/content/docs/blog/2026-02-02-security-lessons.md index f704af3210e..72a52f41eb8 100644 --- a/docs/src/content/docs/blog/2026-02-02-security-lessons.md +++ b/docs/src/content/docs/blog/2026-02-02-security-lessons.md @@ -37,7 +37,7 @@ Let's share what we've figured out so you can build secure agent ecosystems from Every workflow begins with `permissions: contents: read`. That's our default stance. Write permissions (`contents: write`, `pull-requests: write`, `issues: write`) get granted sparingly and only through safe output mechanisms. -**Example**: The [`audit-workflows`](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) agent has read-only access to workflow runs but creates reports via discussions, which are append-only by nature. +**Example**: The [`audit-workflows`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) agent has read-only access to workflow runs but creates reports via discussions, which are append-only by nature. **Why this works**: If an agent can only read, the worst it can do is waste compute time. It can't delete code, close important issues, or push malicious changes. @@ -77,7 +77,7 @@ safe_outputs: Not every mention or workflow event should trigger powerful agents. We use role-gating to ensure only authorized users can invoke sensitive operations. -**Example**: The [`q`](https://github.com/githubnext/agentics/blob/main/.github/workflows/q.md) optimizer requires the user commenting `/q` to be a repository maintainer. Random contributors can't trigger expensive optimization runs. +**Example**: The [`q`](https://github.com/githubnext/agentics/blob/main/workflows/q.md) optimizer requires the user commenting `/q` to be a repository maintainer. Random contributors can't trigger expensive optimization runs. **Implementation**: @@ -148,7 +148,7 @@ Every agent action leaves a trail: - Artifacts are versioned - Workflow runs are logged -**Example**: The [`agent-performance-analyzer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/agent-performance-analyzer.md) creates weekly discussion posts. You can scroll back months to see how agent quality has evolved over time. +**Example**: The [`agent-performance-analyzer`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/agent-performance-analyzer.md) creates weekly discussion posts. You can scroll back months to see how agent quality has evolved over time. **Why this works**: Transparency builds trust. When something goes wrong, the audit trail makes debugging straightforward. When something goes right, the evidence is right there for everyone to see. @@ -183,7 +183,7 @@ When agents need write access, use safe outputs with strict bounds. **Use case**: Issue triage, PR creation, documentation updates -**Example**: [`issue-triage-agent`](https://github.com/githubnext/agentics/blob/main/.github/workflows/issue-triage-agent.md) can add labels but can't close issues or modify code. +**Example**: [`issue-triage-agent`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/issue-triage-agent.md) can add labels but can't close issues or modify code. ### Pattern 3: Human-in-the-Loop @@ -198,7 +198,7 @@ For high-impact operations, require human approval before execution. **Use case**: Code changes, dependency updates, configuration changes -**Example**: [`daily-workflow-updater`](https://github.com/githubnext/agentics/blob/main/.github/workflows/daily-workflow-updater.md) creates PRs for dependency updates but never merges them automatically. +**Example**: [`daily-workflow-updater`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/daily-workflow-updater.md) creates PRs for dependency updates but never merges them automatically. ### Pattern 4: Role-Gated ChatOps @@ -213,7 +213,7 @@ Interactive agents that require authorization to invoke. **Use case**: Code review, optimization, debugging assistance -**Example**: [`grumpy-reviewer`](https://github.com/githubnext/agentics/blob/main/.github/workflows/grumpy-reviewer.md) requires collaborator access to invoke via `/grumpy`. +**Example**: [`grumpy-reviewer`](https://github.com/githubnext/agentics/blob/main/workflows/grumpy-reviewer.md) requires collaborator access to invoke via `/grumpy`. ### Pattern 5: Network Restricted diff --git a/docs/src/content/docs/blog/2026-02-05-how-workflows-work.md b/docs/src/content/docs/blog/2026-02-05-how-workflows-work.md index 6ff61d54669..a0637beef21 100644 --- a/docs/src/content/docs/blog/2026-02-05-how-workflows-work.md +++ b/docs/src/content/docs/blog/2026-02-05-how-workflows-work.md @@ -227,7 +227,7 @@ tools: ## Error Handling and Debugging -When workflows fail, detailed logs capture job, step, tool invocation, and error information. Safe output validation provides clear error messages and example corrections while allowing workflows to fail gracefully. The [`mcp-inspector`](https://github.com/githubnext/agentics/blob/main/.github/workflows/mcp-inspector.md) workflow validates server availability and configuration. The [`audit-workflows`](https://github.com/githubnext/agentics/blob/main/.github/workflows/audit-workflows.md) agent tracks runs, classifies failures, and creates issues for persistent problems. +When workflows fail, detailed logs capture job, step, tool invocation, and error information. Safe output validation provides clear error messages and example corrections while allowing workflows to fail gracefully. The [`mcp-inspector`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/mcp-inspector.md) workflow validates server availability and configuration. The [`audit-workflows`](https://github.com/github/gh-aw/tree/2c1f68a721ae7b3b67d0c2d93decf1fa5bcf7ee3/.github/workflows/audit-workflows.md) agent tracks runs, classifies failures, and creates issues for persistent problems. ## Performance Considerations diff --git a/docs/src/content/docs/blog/2026-03-18-weekly-update.md b/docs/src/content/docs/blog/2026-03-18-weekly-update.md index 93e59ffe392..81db2d247c6 100644 --- a/docs/src/content/docs/blog/2026-03-18-weekly-update.md +++ b/docs/src/content/docs/blog/2026-03-18-weekly-update.md @@ -60,7 +60,7 @@ Across its recent runs it made 131 `search_repositories` calls. We're not sure w πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with a notify workflow on specific labels (e.g., `security` or `needs-repro`) so the right people get pinged automatically without anyone having to watch the inbox. -β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-03-23-weekly-update.md b/docs/src/content/docs/blog/2026-03-23-weekly-update.md index ffaf73f46cd..e9264848ec7 100644 --- a/docs/src/content/docs/blog/2026-03-23-weekly-update.md +++ b/docs/src/content/docs/blog/2026-03-23-weekly-update.md @@ -69,7 +69,7 @@ One earlier run also hit a minor hiccup: the pre-agent filter step forgot to wri πŸ’‘ **Usage tip**: The `contribution-check` pattern works best when your `CONTRIBUTING.md` is explicit and opinionated β€” the more specific your guidelines, the more actionable its feedback will be for contributors. -β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/contribution-check.md) +β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/workflows/contribution-check.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-03-30-weekly-update.md b/docs/src/content/docs/blog/2026-03-30-weekly-update.md index a6d9d14622f..78c01276604 100644 --- a/docs/src/content/docs/blog/2026-03-30-weekly-update.md +++ b/docs/src/content/docs/blog/2026-03-30-weekly-update.md @@ -76,7 +76,7 @@ It's the classic overachiever problem β€” sometimes the issues that look the sim πŸ’‘ **Usage tip**: If your `auto-triage-issues` scheduled runs are consistently expensive, the new `agentic_fraction` metric in `gh aw audit` can help you identify which turns are pure data-gathering and could be moved to deterministic shell steps. -β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) --- diff --git a/docs/src/content/docs/blog/2026-04-06-weekly-update.md b/docs/src/content/docs/blog/2026-04-06-weekly-update.md index 452d5a8550c..0f59271a4ee 100644 --- a/docs/src/content/docs/blog/2026-04-06-weekly-update.md +++ b/docs/src/content/docs/blog/2026-04-06-weekly-update.md @@ -59,7 +59,7 @@ In a delightfully meta moment, the observability kit itself hit token-limit erro πŸ’‘ **Usage tip**: Pair `agentic-observability-kit` with Slack or email notifications so escalation issues trigger an alert β€” otherwise the issues it files can sit unread while the token bill quietly grows. -β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/agentic-observability-kit.md) +β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/agentic-observability-kit.md) --- diff --git a/docs/src/content/docs/blog/2026-04-13-weekly-update.md b/docs/src/content/docs/blog/2026-04-13-weekly-update.md index 533208ebda8..527fb2c0122 100644 --- a/docs/src/content/docs/blog/2026-04-13-weekly-update.md +++ b/docs/src/content/docs/blog/2026-04-13-weekly-update.md @@ -62,7 +62,7 @@ That "security" label is doing a lot of work β€” the workflow spotted MCP and co πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with label-based notification rules so your team gets automatically paged for `security` or `critical` issues without anyone having to babysit the issue tracker. -β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-04-20-weekly-update.md b/docs/src/content/docs/blog/2026-04-20-weekly-update.md index d6e26fccb7b..fcbd5527977 100644 --- a/docs/src/content/docs/blog/2026-04-20-weekly-update.md +++ b/docs/src/content/docs/blog/2026-04-20-weekly-update.md @@ -61,7 +61,7 @@ Even when it can't act, it doesn't just silently fail β€” it leaves a breadcrumb πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with a `notify` workflow on high-priority labels (like `security` or `breaking-change`) so your team gets paged for the things that actually matter. -β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-04-27-weekly-update.md b/docs/src/content/docs/blog/2026-04-27-weekly-update.md index 13ae672e166..4b597d8a498 100644 --- a/docs/src/content/docs/blog/2026-04-27-weekly-update.md +++ b/docs/src/content/docs/blog/2026-04-27-weekly-update.md @@ -43,7 +43,7 @@ One of its runs earned an honorable mention from the agentic assessment system: πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with a label-based notification workflow so the right team members get pinged the moment a new issue is categorized. -β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-05-04-weekly-update.md b/docs/src/content/docs/blog/2026-05-04-weekly-update.md index 35638f26938..90e21e9fb7e 100644 --- a/docs/src/content/docs/blog/2026-05-04-weekly-update.md +++ b/docs/src/content/docs/blog/2026-05-04-weekly-update.md @@ -52,7 +52,7 @@ It spent roughly 500k tokens per run carefully reading workflow files, thinking πŸ’‘ **Usage tip**: Use `ab-testing-advisor` as inspiration for your own repos β€” it's a great example of a meta-workflow that uses AI to drive continuous improvement of *other* AI workflows. -β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/ab-testing-advisor.md) +β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/ab-testing-advisor.md) ## Try It Out diff --git a/docs/src/content/docs/blog/2026-05-11-weekly-update.md b/docs/src/content/docs/blog/2026-05-11-weekly-update.md index d629e11f1d2..2a7b381c444 100644 --- a/docs/src/content/docs/blog/2026-05-11-weekly-update.md +++ b/docs/src/content/docs/blog/2026-05-11-weekly-update.md @@ -50,7 +50,7 @@ The run summary noted with mild concern that `auto-triage-issues` is so reliable πŸ’‘ **Usage tip**: Pair `auto-triage-issues` with a `notify` or `discussion` workflow on high-priority labels so the right people are paged the moment a critical bug or security issue lands. -β†’ [View the workflow on GitHub](https://github.com/githubnext/agentics/blob/main/.github/workflows/auto-triage-issues.md) +β†’ [View the workflow on GitHub](https://github.com/github/gh-aw/blob/main/.github/workflows/auto-triage-issues.md) ## Try It Out From 2957010726562c1adf6e93c094c850a45e3b11ff Mon Sep 17 00:00:00 2001 From: "copilot-swe-agent[bot]" <198982749+Copilot@users.noreply.github.com> Date: Fri, 22 May 2026 14:32:39 +0000 Subject: [PATCH 5/5] Replace remaining v0.45.5 workflow links with main in blog docs Co-authored-by: pelikhan <4175913+pelikhan@users.noreply.github.com> --- ...-meet-the-workflows-continuous-improvement.md | 8 ++++---- ...-01-13-meet-the-workflows-creative-culture.md | 12 ++++++------ ...026-01-13-meet-the-workflows-documentation.md | 12 ++++++------ ...-13-meet-the-workflows-interactive-chatops.md | 4 ++-- ...-01-13-meet-the-workflows-issue-management.md | 8 ++++---- ...6-01-13-meet-the-workflows-quality-hygiene.md | 8 ++++---- ...-13-meet-the-workflows-security-compliance.md | 16 ++++++++-------- ...1-13-meet-the-workflows-testing-validation.md | 16 ++++++++-------- 8 files changed, 42 insertions(+), 42 deletions(-) diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md index a7f8bde438e..ce6f8cdb945 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-continuous-improvement.md @@ -24,8 +24,8 @@ In our [previous posts](/gh-aw/blog/2026-01-13-meet-the-workflows-continuous-sim ## Continuous Improvement Workflows -- **[Go Module Usage Expert (aka Go Fan)](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/go-fan.md?plain=1)** - Daily Go module usage reviewer -- **[Typist](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/typist.md?plain=1)** - Analyzes type usage patterns for improved safety +- **[Go Module Usage Expert (aka Go Fan)](https://github.com/github/gh-aw/blob/main/.github/workflows/go-fan.md?plain=1)** - Daily Go module usage reviewer +- **[Typist](https://github.com/github/gh-aw/blob/main/.github/workflows/typist.md?plain=1)** - Analyzes type usage patterns for improved safety - **[Functional Pragmatist](https://github.com/github/gh-aw/blob/main/.github/workflows/functional-programming-enhancer.md?plain=1)** - Applies functional techniques pragmatically - **[Repository Quality Improver](https://github.com/githubnext/agentics/blob/main/workflows/repository-quality-improver.md?plain=1)** - Holistic code quality analysis @@ -119,13 +119,13 @@ You can add these workflows to your own repository and remix them. Get going wit **Go Module Usage Expert:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/go-fan.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/go-fan.md ``` **Typist:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/typist.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/typist.md ``` **Functional Pragmatist:** diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md index 468c8de48c3..3d3c200c1ea 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-creative-culture.md @@ -29,9 +29,9 @@ But here's the thing: work doesn't have to be all business. While we've built se These agents facilitate team communication and remind us that work can be fun: - **[Daily Team Status](https://github.com/githubnext/agentics/blob/main/workflows/daily-team-status.md?plain=1)** - Shares team mood and status updates - **22 issues**, **17 discussions** (plus 2 causal chain PRs!) -- **[Daily News](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-news.md?plain=1)** - Curates relevant news for the team - **45 news digest discussions** -- **[Poem Bot](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/poem-bot.md?plain=1)** - Responds to `/poem-bot` commands with creative verses (yes, really) -- **[Weekly Issue Summary](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/weekly-issue-summary.md?plain=1)** - Creates digestible summaries complete with charts and trends - **5 weekly analysis discussions** +- **[Daily News](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-news.md?plain=1)** - Curates relevant news for the team - **45 news digest discussions** +- **[Poem Bot](https://github.com/github/gh-aw/blob/main/.github/workflows/poem-bot.md?plain=1)** - Responds to `/poem-bot` commands with creative verses (yes, really) +- **[Weekly Issue Summary](https://github.com/github/gh-aw/blob/main/.github/workflows/weekly-issue-summary.md?plain=1)** - Creates digestible summaries complete with charts and trends - **5 weekly analysis discussions** - **[Daily Repo Chronicle](https://github.com/githubnext/agentics/blob/main/workflows/daily-repo-chronicle.md?plain=1)** - Narrates the day's activity like a storyteller - **6 chronicle discussions** The Poem Bot started as a whimsy in our Copilot for PRs project in 2022. Someone said "wouldn't it be funny if we had an agent that writes poems about our code?" and then we built it. Poem Bot responds to `/poem-bot` commands with creative verses about code, adding a touch of whimsy to the development workflow. We learned that AI agents don't have to be all business - they can build culture and create moments of joy. @@ -63,19 +63,19 @@ gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/dail **Daily News:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-news.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/daily-news.md ``` **Poem Bot:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/poem-bot.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/poem-bot.md ``` **Weekly Issue Summary:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/weekly-issue-summary.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/weekly-issue-summary.md ``` **Daily Repo Chronicle:** diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md index afd2ee235e8..34eb4c3f7f4 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-documentation.md @@ -31,10 +31,10 @@ These agents maintain high-quality documentation and content: - **[Daily Documentation Updater](https://github.com/githubnext/agentics/blob/main/workflows/daily-doc-updater.md?plain=1)** - Reviews and updates documentation to ensure accuracy and completeness - **57 merged PRs out of 59 proposed (96% merge rate)** - **[Glossary Maintainer](https://github.com/githubnext/agentics/blob/main/workflows/glossary-maintainer.md?plain=1)** - Keeps glossary synchronized with codebase - **10 merged PRs out of 10 proposed (100% merge rate)** - **[Documentation Unbloat](https://github.com/githubnext/agentics/blob/main/workflows/unbloat-docs.md?plain=1)** - Reviews and simplifies documentation by reducing verbosity - **88 merged PRs out of 103 proposed (85% merge rate)** -- **[Documentation Noob Tester](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/docs-noob-tester.md?plain=1)** - Tests documentation as a new user would, identifying confusing steps - **9 merged PRs (43% merge rate)** via causal chain -- **[Slide Deck Maintainer](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/slide-deck-maintainer.md?plain=1)** - Maintains presentation slide decks - **2 merged PRs out of 5 proposed (40% merge rate)** +- **[Documentation Noob Tester](https://github.com/github/gh-aw/blob/main/.github/workflows/docs-noob-tester.md?plain=1)** - Tests documentation as a new user would, identifying confusing steps - **9 merged PRs (43% merge rate)** via causal chain +- **[Slide Deck Maintainer](https://github.com/github/gh-aw/blob/main/.github/workflows/slide-deck-maintainer.md?plain=1)** - Maintains presentation slide decks - **2 merged PRs out of 5 proposed (40% merge rate)** - **[Multi-device Docs Tester](https://github.com/githubnext/agentics/blob/main/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation site across mobile, tablet, and desktop devices - **2 merged PRs out of 2 proposed (100% merge rate)** -- **[Blog Auditor](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/blog-auditor.md?plain=1)** - Verifies blog posts are accessible and contain expected content - **6 audits completed** (5 passed, 1 flagged issues) +- **[Blog Auditor](https://github.com/github/gh-aw/blob/main/.github/workflows/blog-auditor.md?plain=1)** - Verifies blog posts are accessible and contain expected content - **6 audits completed** (5 passed, 1 flagged issues) Documentation is where we challenged conventional wisdom. Can AI agents write *good* documentation? @@ -77,13 +77,13 @@ gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/unbl **Documentation Noob Tester:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/docs-noob-tester.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/docs-noob-tester.md ``` **Slide Deck Maintainer:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/slide-deck-maintainer.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/slide-deck-maintainer.md ``` **Multi-device Docs Tester:** @@ -95,7 +95,7 @@ gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/dail **Blog Auditor:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/blog-auditor.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/blog-auditor.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md index 9f407df1f5e..66aad804f2d 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-interactive-chatops.md @@ -32,7 +32,7 @@ These agents respond to commands, providing on-demand assistance whenever you ne - **[Q](https://github.com/githubnext/agentics/blob/main/workflows/q.md?plain=1)** - Workflow optimizer that investigates performance and creates PRs - **69 merged PRs out of 88 proposed (78% merge rate)** - **[Grumpy Reviewer](https://github.com/githubnext/agentics/blob/main/workflows/grumpy-reviewer.md?plain=1)** - Performs critical code reviews with personality - creates issues for downstream agents -- **[Workflow Generator](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-generator.md?plain=1)** - Creates new workflows from issue requests - scaffolds workflow files +- **[Workflow Generator](https://github.com/github/gh-aw/blob/main/.github/workflows/workflow-generator.md?plain=1)** - Creates new workflows from issue requests - scaffolds workflow files Interactive workflows changed how we think about agent invocation. Instead of everything running on a schedule, these respond to slash commands and reactions - `/q` summons the workflow optimizer, a πŸš€ reaction triggers analysis. Q (yes, named after the James Bond quartermaster) became our go-to troubleshooter - it has contributed **69 merged PRs out of 88 proposed (78% merge rate)**, responding to commands and investigating workflow issues on demand. Recent examples include [fixing the daily-fact workflow action-tag](https://github.com/github/gh-aw/pull/14127) and [configuring PR triage reports with 1-day expiration](https://github.com/github/gh-aw/pull/13903). @@ -61,7 +61,7 @@ gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/grum **Workflow Generator:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-generator.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/workflow-generator.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md index 331df442ca4..f11620b83ac 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-issue-management.md @@ -29,8 +29,8 @@ Now let's talk about the daily rituals of software development: managing issues These agents enhance issue and pull request workflows: - **[Issue Arborist](https://github.com/githubnext/agentics/blob/main/workflows/issue-arborist.md?plain=1)** - Links related issues as sub-issues - **77 discussion reports** and **18 parent issues** created -- **[Issue Monster](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-monster.md?plain=1)** - Assigns issues to the asynchronous [GitHub Copilot coding agent](https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent) one at a time - **task dispatcher** for the whole system -- **[Mergefest](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mergefest.md?plain=1)** - Automatically merges main branch into PR branches - **orchestrator workflow** +- **[Issue Monster](https://github.com/github/gh-aw/blob/main/.github/workflows/issue-monster.md?plain=1)** - Assigns issues to the asynchronous [GitHub Copilot coding agent](https://docs.github.com/en/copilot/concepts/agents/coding-agent/about-coding-agent) one at a time - **task dispatcher** for the whole system +- **[Mergefest](https://github.com/github/gh-aw/blob/main/.github/workflows/mergefest.md?plain=1)** - Automatically merges main branch into PR branches - **orchestrator workflow** - **[Sub Issue Closer](https://github.com/githubnext/agentics/blob/main/workflows/sub-issue-closer.md?plain=1)** - Closes completed sub-issues automatically - **orchestrator workflow** The Issue Arborist is an **organizational workflow** that has created **77 discussion reports** (titled "[Issue Arborist] Issue Arborist Report") and **18 parent issues** to group related sub-issues. It keeps the issue tracker organized by automatically linking related issues, building a dependency tree we'd never maintain manually. For example, [#12037](https://github.com/github/gh-aw/issues/12037) grouped engine documentation updates. @@ -56,13 +56,13 @@ gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/issu **Issue Monster:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/issue-monster.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/issue-monster.md ``` **Mergefest:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/mergefest.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/mergefest.md ``` **Sub Issue Closer:** diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md index c7f4953cf98..582ac7a4e57 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-quality-hygiene.md @@ -31,8 +31,8 @@ Now let's shift from collaboration ceremony to fault investigation. These are our diligent caretakers - the agents that spot problems before they become bigger problems: - **[CI Doctor](https://github.com/githubnext/agentics/blob/main/workflows/ci-doctor.md?plain=1)** - Investigates failed workflows and opens diagnostic issues - **9 merged PRs out of 13 proposed (69% merge rate)** -- **[Schema Consistency Checker](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/schema-consistency-checker.md?plain=1)** - Detects when schemas, code, and docs drift apart - **55 analysis discussions** created -- **[Breaking Change Checker](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/breaking-change-checker.md?plain=1)** - Watches for changes that might break things for users - creates alert issues +- **[Schema Consistency Checker](https://github.com/github/gh-aw/blob/main/.github/workflows/schema-consistency-checker.md?plain=1)** - Detects when schemas, code, and docs drift apart - **55 analysis discussions** created +- **[Breaking Change Checker](https://github.com/github/gh-aw/blob/main/.github/workflows/breaking-change-checker.md?plain=1)** - Watches for changes that might break things for users - creates alert issues The CI Doctor (also known as "CI Failure Doctor") was one of our most important workflows. Instead of drowning in CI failure notifications, we now get *timely*, *investigated* failures with actual diagnostic insights. The agent doesn't just tell us something broke - it analyzes logs, identifies patterns, searches for similar past issues, and even suggests fixes - even before the human has read the failure notification. CI Failure Doctor has contributed **9 merged PRs out of 13 proposed (69% merge rate)**, including fixes like [adding Go module download pre-flight checks](https://github.com/github/gh-aw/pull/13740) and [adding retry logic to prevent proxy 403 failures](https://github.com/github/gh-aw/pull/13155). We learned that agents excel at the tedious investigation work that humans find draining. @@ -57,13 +57,13 @@ gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/ci-d **Schema Consistency Checker:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/schema-consistency-checker.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/schema-consistency-checker.md ``` **Breaking Change Checker:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/breaking-change-checker.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/breaking-change-checker.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md index 0d36d8f3f4c..6f413b2e5d3 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-security-compliance.md @@ -28,11 +28,11 @@ But reliability alone isn't enough - we also need *security*. When AI agents can These agents are our security guards, keeping watch and enforcing the rules: -- **[Security Compliance](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/security-compliance.md?plain=1)** - Runs vulnerability campaigns with deadline tracking -- **[Firewall](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/firewall.md?plain=1)** - Tests network security and validates rules - **59 daily firewall report discussions**, **5 smoke test issues** -- **[Daily Secrets Analysis](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-secrets-analysis.md?plain=1)** - Scans for exposed credentials (yes, it happens) +- **[Security Compliance](https://github.com/github/gh-aw/blob/main/.github/workflows/security-compliance.md?plain=1)** - Runs vulnerability campaigns with deadline tracking +- **[Firewall](https://github.com/github/gh-aw/blob/main/.github/workflows/firewall.md?plain=1)** - Tests network security and validates rules - **59 daily firewall report discussions**, **5 smoke test issues** +- **[Daily Secrets Analysis](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-secrets-analysis.md?plain=1)** - Scans for exposed credentials (yes, it happens) - **[Daily Malicious Code Scan](https://github.com/githubnext/agentics/blob/main/workflows/daily-malicious-code-scan.md?plain=1)** - Reviews recent code changes for suspicious patterns -- **[Static Analysis Report](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/static-analysis-report.md?plain=1)** - Daily security scans using zizmor, poutine, and actionlint - **57 analysis discussions** plus **12 Zizmor security reports** +- **[Static Analysis Report](https://github.com/github/gh-aw/blob/main/.github/workflows/static-analysis-report.md?plain=1)** - Daily security scans using zizmor, poutine, and actionlint - **57 analysis discussions** plus **12 Zizmor security reports** Security Compliance manages vulnerability remediation campaigns with deadline tracking, ensuring security issues are addressed within defined SLAs - perfect for those "audit in 3 weeks" panic moments. @@ -51,19 +51,19 @@ You can add these workflows to your own repository and remix them. Get going wit **Security Compliance:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/security-compliance.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/security-compliance.md ``` **Firewall:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/firewall.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/firewall.md ``` **Daily Secrets Analysis:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-secrets-analysis.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/daily-secrets-analysis.md ``` **Daily Malicious Code Scan:** @@ -75,7 +75,7 @@ gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/dail **Static Analysis Report:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/static-analysis-report.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/static-analysis-report.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions. diff --git a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md index d14345447be..97d2aeb6502 100644 --- a/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md +++ b/docs/src/content/docs/blog/2026-01-13-meet-the-workflows-testing-validation.md @@ -30,19 +30,19 @@ These agents keep everything running smoothly through continuous testing: ### Code Quality & Test Validation -- **[Daily Testify Uber Super Expert](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-testify-uber-super-expert.md?plain=1)** - Analyzes test files daily and suggests testify-based improvements - **19 issues created**, **13 led to merged PRs (100% causal chain merge rate)** +- **[Daily Testify Uber Super Expert](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-testify-uber-super-expert.md?plain=1)** - Analyzes test files daily and suggests testify-based improvements - **19 issues created**, **13 led to merged PRs (100% causal chain merge rate)** - **[Daily Test Improver](https://github.com/githubnext/agentics/blob/main/workflows/daily-test-improver.md?plain=1)** - Identifies coverage gaps and implements new tests incrementally -- **[Daily Compiler Quality Check](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-compiler-quality.md?plain=1)** - Analyzes compiler code to ensure it meets quality standards +- **[Daily Compiler Quality Check](https://github.com/github/gh-aw/blob/main/.github/workflows/daily-compiler-quality.md?plain=1)** - Analyzes compiler code to ensure it meets quality standards ### User Experience & Integration Testing - **[Daily Multi-Device Docs Tester](https://github.com/githubnext/agentics/blob/main/workflows/daily-multi-device-docs-tester.md?plain=1)** - Tests documentation across devices with Playwright - **2 merged PRs out of 2 proposed (100% merge rate)** -- **[CLI Consistency Checker](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/cli-consistency-checker.md?plain=1)** - Inspects the CLI for inconsistencies, typos, and documentation gaps - **80 merged PRs out of 102 proposed (78% merge rate)** +- **[CLI Consistency Checker](https://github.com/github/gh-aw/blob/main/.github/workflows/cli-consistency-checker.md?plain=1)** - Inspects the CLI for inconsistencies, typos, and documentation gaps - **80 merged PRs out of 102 proposed (78% merge rate)** ### CI/CD Optimization - **[CI Coach](https://github.com/githubnext/agentics/blob/main/workflows/ci-coach.md?plain=1)** - Analyzes CI pipelines and suggests optimizations - **9 merged PRs out of 9 proposed (100% merge rate)** -- **[Workflow Health Manager](https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-health-manager.md?plain=1)** - Meta-orchestrator monitoring health of all agentic workflows - **40 issues created**, **5 direct PRs + 14 causal chain PRs merged** +- **[Workflow Health Manager](https://github.com/github/gh-aw/blob/main/.github/workflows/workflow-health-manager.md?plain=1)** - Meta-orchestrator monitoring health of all agentic workflows - **40 issues created**, **5 direct PRs + 14 causal chain PRs merged** The Daily Testify Expert has created **19 issues** analyzing test quality, and **13 of those issues led to merged PRs** by downstream agents - a perfect 100% causal chain merge rate. For example, [issue #13701](https://github.com/github/gh-aw/issues/13701) led to [#13722](https://github.com/github/gh-aw/pull/13722) modernizing console render tests with testify assertions. The Daily Test Improver works alongside it to identify coverage gaps and implement new tests. @@ -61,7 +61,7 @@ You can add these workflows to your own repository and remix them. Get going wit **Daily Testify Uber Super Expert:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-testify-uber-super-expert.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/daily-testify-uber-super-expert.md ``` **Daily Test Improver:** @@ -73,7 +73,7 @@ gh aw add-wizard githubnext/agentics/daily-test-improver **Daily Compiler Quality Check:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/daily-compiler-quality.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/daily-compiler-quality.md ``` **Daily Multi-Device Docs Tester:** @@ -85,7 +85,7 @@ gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/dail **CLI Consistency Checker:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/cli-consistency-checker.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/cli-consistency-checker.md ``` **CI Coach:** @@ -97,7 +97,7 @@ gh aw add-wizard https://github.com/githubnext/agentics/blob/main/workflows/ci-c **Workflow Health Manager:** ```bash -gh aw add-wizard https://github.com/github/gh-aw/blob/v0.45.5/.github/workflows/workflow-health-manager.md +gh aw add-wizard https://github.com/github/gh-aw/blob/main/.github/workflows/workflow-health-manager.md ``` Then edit and remix the workflow specifications to meet your needs, regenerate the lock file using `gh aw compile`, and push to your repository. See our [Quick Start](https://github.github.com/gh-aw/setup/quick-start/) for further installation and setup instructions.