agentics

dsyme · dsyme · commit ebedab5169a6 · 2025-10-11T23:46:39.000+01:00
diff --git a/docs/ci-doctor.md b/docs/ci-doctor.md
@@ -7,10 +7,18 @@ The [CI Doctor workflow](../workflows/ci-doctor.md?plain=1) monitors your GitHub
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the CI Doctor workflow to your repository
 gh aw add githubnext/agentics/ci-doctor --pr
 ```
 
-This creates a pull request to add the workflow to your repository. After merging the PR, the workflow will automatically trigger when monitored CI workflows fail. You cannot start this workflow manually as it responds to workflow failure events.
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR, the workflow will automatically trigger when monitored CI workflows fail. You cannot start this workflow manually as it responds to workflow failure events.
 
 **Mandatory Checklist**
 
diff --git a/docs/daily-accessibility-review.md b/docs/daily-accessibility-review.md
@@ -7,11 +7,19 @@ The [daily accessibility review workflow](../workflows/daily-accessibility-revie
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Daily Accessibility Review workflow to your repository
 gh aw add githubnext/agentics/daily-accessibility-review --pr
 ```
 
 This creates an issue in your repository recording accessibility problems found.
 
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
+
 ```bash
 gh aw run daily-accessibility-review
 ```
diff --git a/docs/daily-dependency-updates.md b/docs/daily-dependency-updates.md
@@ -7,6 +7,10 @@ The [daily dependency updater workflow](../workflows/daily-dependency-updates.md
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Daily Dependency Updater workflow to your repository
 gh aw add githubnext/agentics/daily-dependency-updates --pr
 ```
 
diff --git a/docs/daily-perf-improver.md b/docs/daily-perf-improver.md
@@ -7,10 +7,18 @@ The [daily performance improver workflow](../workflows/daily-perf-improver.md?pl
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Daily Performance Improver workflow to your repository
 gh aw add githubnext/agentics/daily-perf-improver --pr
 ```
 
-This creates a pull request to add the workflow to your repository. After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
 
 ```bash
 gh aw run daily-perf-improver
diff --git a/docs/daily-plan.md b/docs/daily-plan.md
@@ -7,10 +7,18 @@ The [daily plan workflow](../workflows/daily-plan.md?plain=1) will run daily to
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Daily Plan workflow to your repository
 gh aw add githubnext/agentics/daily-plan --pr
 ```
 
-This creates a pull request to add the workflow to your repository. After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
 
 ```bash
 gh aw run daily-plan
diff --git a/docs/daily-progress.md b/docs/daily-progress.md
@@ -7,10 +7,18 @@ The [daily progress workflow](../workflows/daily-progress.md?plain=1) is an auto
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Daily Progress workflow to your repository
 gh aw add githubnext/agentics/daily-progress --pr
 ```
 
-This creates a pull request to add the workflow to your repository. After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
 
 ```bash
 gh aw run daily-progress
diff --git a/docs/daily-qa.md b/docs/daily-qa.md
@@ -7,10 +7,18 @@ The [daily Adhoc QA workflow](../workflows/daily-qa.md?plain=1) will perform adh
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Daily QA workflow to your repository
 gh aw add githubnext/agentics/daily-qa --pr
 ```
 
-This creates a pull request to add the workflow to your repository. After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
 
 ```bash
 gh aw run daily-qa
diff --git a/docs/daily-team-status.md b/docs/daily-team-status.md
@@ -7,10 +7,18 @@ The [daily team status workflow](../workflows/daily-team-status.md?plain=1) will
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Daily Team Status workflow to your repository
 gh aw add githubnext/agentics/daily-team-status --pr
 ```
 
-This creates a pull request to add the workflow to your repository. After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
 
 ```bash
 gh aw run daily-team-status
diff --git a/docs/daily-test-improver.md b/docs/daily-test-improver.md
@@ -7,10 +7,18 @@ The [daily test coverage improver workflow](../workflows/daily-test-improver.md?
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Daily Test Coverage Improver workflow to your repository
 gh aw add githubnext/agentics/daily-test-improver --pr
 ```
 
-This creates a pull request to add the workflow to your repository. After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
 
 ```bash
 gh aw run daily-test-improver
diff --git a/docs/issue-triage.md b/docs/issue-triage.md
@@ -7,10 +7,18 @@ The [issue triage workflow](../workflows/issue-triage.md?plain=1) will when issu
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Issue Triage workflow to your repository
 gh aw add githubnext/agentics/issue-triage --pr
 ```
 
-This creates a pull request to add the workflow to your repository. You can't start a run of this workflow directly as it is triggered in the context of an issue.
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+You can't start a run of this workflow directly as it is triggered in the context of an issue.
 
 **Mandatory Checklist**
 
diff --git a/docs/pr-fix.md b/docs/pr-fix.md
@@ -19,10 +19,18 @@ or by writing a comment:
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the PR Fix workflow to your repository
 gh aw add githubnext/agentics/pr-fix --pr
 ```
 
-This creates a pull request to add the workflow to your repository. You can't start a run of this workflow directly as it is triggered in the context of a pull request with failing checks.
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+You can't start a run of this workflow directly as it is triggered in the context of a pull request with failing checks.
 
 To trigger the workflow on a specific pull request, add a comment with the command:
 
diff --git a/docs/repo-ask.md b/docs/repo-ask.md
@@ -19,10 +19,18 @@ or by writing a comment with a specific question:
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Repo Ask workflow to your repository
 gh aw add githubnext/agentics/repo-ask --pr
 ```
 
-This creates a pull request to add the workflow to your repository. You can't start a run of this workflow directly as it is triggered in the context of an issue or pull request comment.
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+You can't start a run of this workflow directly as it is triggered in the context of an issue or pull request comment.
 
 To trigger the workflow on a specific issue or pull request, add a comment with the command:
 
diff --git a/docs/update-docs.md b/docs/update-docs.md
@@ -7,10 +7,18 @@ The [update documentation workflow](../workflows/update-docs.md?plain=1) will ru
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Update Docs workflow to your repository
 gh aw add githubnext/agentics/update-docs --pr
 ```
 
-This creates a pull request to add the workflow to your repository. After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
+This creates a pull request to add the workflow to your repository.
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
 
 ```bash
 gh aw run update-docs
diff --git a/docs/weekly-research.md b/docs/weekly-research.md
@@ -7,10 +7,18 @@ The [weekly research workflow](../workflows/weekly-research.md?plain=1) will run
 ## Installation
 
 ```bash
+# Install the 'gh aw' extension
+gh aw extension install githubnext/agentics
+
+# Add the Weekly Research workflow to your repository
 gh aw add githubnext/agentics/weekly-research --pr
 ```
 
-This creates a pull request to add the workflow to your repository. After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
+This creates a pull request to add the workflow to your repository. 
+
+You must also add [choose a coding agent](https://githubnext.github.io/gh-aw/reference/engines/) and add an API key secret for the agent to your repository.
+
+After merging the PR and syncing to main, you can start a run of this workflow immediately by running:
 
 ```bash
 gh aw run weekly-research
diff --git a/workflows/daily-accessibility-review.md b/workflows/daily-accessibility-review.md
@@ -16,6 +16,7 @@ safe-outputs:
     category: "q-a"
     max: 5
   add-comment:
+    discussion: true
     max: 5
 
 tools:
diff --git a/workflows/daily-backlog-burner.md b/workflows/daily-backlog-burner.md
@@ -16,6 +16,7 @@ safe-outputs:
     category: "ideas"
     max: 3
   add-comment:
+    discussion: true
     target: "*" # all issues and PRs
     max: 3
   create-pull-request:
diff --git a/workflows/daily-perf-improver.md b/workflows/daily-perf-improver.md
@@ -18,6 +18,7 @@ safe-outputs:
     category: "ideas"
     max: 5
   add-comment:
+    discussion: true
     target: "*" # can add a comment to any one single issue or pull request
   create-pull-request:
     draft: true
diff --git a/workflows/daily-progress.md b/workflows/daily-progress.md
@@ -16,6 +16,7 @@ safe-outputs:
     category: "ideas"
     max: 3
   add-comment:
+    discussion: true
     target: "*" # all issues and PRs
     max: 3
   create-pull-request:
diff --git a/workflows/daily-qa.md b/workflows/daily-qa.md
@@ -18,6 +18,7 @@ safe-outputs:
     title-prefix: "${{ github.workflow }}"
     category: "q-a"
   add-comment:
+    discussion: true
     target: "*" # all issues and PRs
     max: 5
   create-pull-request:
diff --git a/workflows/daily-test-improver.md b/workflows/daily-test-improver.md
@@ -17,6 +17,7 @@ safe-outputs:
     title-prefix: "${{ github.workflow }}"
     category: "ideas"
   add-comment:
+    discussion: true
     target: "*" # can add a comment to any one single issue or pull request
   create-pull-request: # can create a pull request
     draft: true
diff --git a/workflows/pr-fix.md b/workflows/pr-fix.md
@@ -32,7 +32,7 @@ You are an AI assistant specialized in fixing pull requests with failing CI chec
 
 1. Read the pull request and the comments
 
-2. Take heed of these instructions: "${{ needs.task.outputs.text }}"
+2. Take heed of these instructions: "${{ needs.activation.outputs.text }}"
 
   - (If there are no particular instructions there, your instructions are to fix the PR based on CI failures. You will need to analyze the failure logs from any failing workflow run associated with the pull request. Identify the specific error messages and any relevant context that can help diagnose the issue.  Based on your analysis, determine the root cause of the failure. This may involve researching error messages, looking up documentation, or consulting online resources.)
 
diff --git a/workflows/repo-ask.md b/workflows/repo-ask.md
@@ -29,7 +29,7 @@ You are an AI assistant specialized in researching and answering questions in th
 
 You have been invoked in the context of the pull request or issue #${{ github.event.issue.number }} in the repository ${{ github.repository }}.
 
-Take heed of these instructions: "${{ needs.task.outputs.text }}"
+Take heed of these instructions: "${{ needs.activation.outputs.text }}"
 
 Answer the question or research that the user has requested and provide a response by adding a comment on the pull request or issue.
 
