agentic-devtools 0.2.301__tar.gz → 0.2.302__tar.gz

agentic_devtools-0.2.302/.github/agents/agdt.add-jira-comment.agent.md

@@ -0,0 +1,45 @@
+---
+description: "Add Jira Comment: Add a comment to a Jira issue"
+agdt:
+  requires:
+    issue_adapter: jira
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Add a comment to a Jira issue.
+
+## Prerequisites
+
+- **Required state**: `jira.issue_key`
+- **Required state**: `jira.comment`
+- **Set state** (if not already set):
+
+  ```bash
+  agdt-set jira.issue_key <value>
+  agdt-set jira.comment <value>
+  ```
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-add-jira-comment
+   ```
+
+## Expected Outcome
+
+A comment is added to the Jira issue (background task).
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.add-pull-request-comment.agent.md

@@ -0,0 +1,45 @@
+---
+description: "Add PR Comment: Post a comment on a pull request"
+agdt:
+  requires:
+    code_hosting: azure_devops
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Add a new comment to a pull request in Azure DevOps.
+
+## Prerequisites
+
+- **Required state**: `pull_request_id`
+- **Required state**: `content`
+- **Set state** (if not already set):
+
+  ```bash
+  agdt-set pull_request_id <value>
+  agdt-set content <value>
+  ```
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-add-pull-request-comment
+   ```
+
+## Expected Outcome
+
+A comment is posted to the pull request (background task).
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.add-users-to-project-role-batch.agent.md

@@ -0,0 +1,47 @@
+---
+description: "Add Users to Role Batch: Batch add users to a role"
+agdt:
+  requires:
+    issue_adapter: jira
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Batch add multiple users to a Jira project role.
+
+## Prerequisites
+
+- **Required state**: `jira.project_key`
+- **Required state**: `jira.role_id`
+- **Required state**: `jira.usernames`
+- **Set state** (if not already set):
+
+  ```bash
+  agdt-set jira.project_key <value>
+  agdt-set jira.role_id <value>
+  agdt-set jira.usernames <value>
+  ```
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-add-users-to-project-role-batch
+   ```
+
+## Expected Outcome
+
+Users are batch-added to the role (background task).
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.add-users-to-project-role.agent.md

@@ -0,0 +1,47 @@
+---
+description: "Add Users to Role: Add users to a Jira project role"
+agdt:
+  requires:
+    issue_adapter: jira
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Add users to a Jira project role.
+
+## Prerequisites
+
+- **Required state**: `jira.project_key`
+- **Required state**: `jira.role_id`
+- **Required state**: `jira.usernames`
+- **Set state** (if not already set):
+
+  ```bash
+  agdt-set jira.project_key <value>
+  agdt-set jira.role_id <value>
+  agdt-set jira.usernames <value>
+  ```
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-add-users-to-project-role
+   ```
+
+## Expected Outcome
+
+Users are added to the role (background task).
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.address-copilot-review.agent.md

@@ -0,0 +1,33 @@
+---
+description: "Address Copilot Review: Automatically address GitHub Copilot PR review comments by URL"
+agdt:
+  requires:
+    code_hosting: github
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+The expected input is a GitHub PR review comment URL of the form:
+`https://github.com/{owner}/{repo}/pull/{pr_number}#pullrequestreview-{review_id}`
+
+## Purpose
+
+Automate the full end-to-end workflow for addressing Copilot PR review comments:
+parse the review URL, fetch comments, triage, make code changes, post replies with
+`agdt-gh-reply-to-review-comments`, resolve threads with
+`agdt-gh-resolve-review-threads`, and re-request Copilot review with
+`agdt-gh-request-copilot-review`.
+
+## Instructions
+
+Follow the detailed instructions in the corresponding prompt file
+(`.github/prompts/agdt.address-copilot-review.prompt.md`).
+
+## Next Step
+
+Task is complete.

agentic_devtools-0.2.302/.github/agents/agdt.address-copilot-review.ci-repair.agent.md

@@ -0,0 +1,43 @@
+---
+description: "Address Copilot Review (CI Repair): Automatically address GitHub Copilot PR review comments and CI failures in a CI environment"
+agdt:
+  requires:
+    code_hosting: github
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+The expected input is a GitHub PR review comment URL of the form:
+`https://github.com/{owner}/{repo}/pull/{pr_number}#pullrequestreview-{review_id}`
+
+## Purpose
+
+CI-safe variant of the address-copilot-review agent designed to run on a
+GitHub-hosted runner within the AI PR Loop workflow. This agent:
+
+- Addresses Copilot review comments and/or CI failures
+- Applies lint fixes using only pinned trusted tooling (ruff, markdownlint-cli2)
+- Commits and pushes changes
+- Replies to review comments and resolves threads
+- Re-requests Copilot review
+
+**Scope limitations** (CI repair mode):
+
+- Does NOT run tests (`agdt-test`, `pytest`, or any test runner)
+- Does NOT install packages from the PR branch
+- Does NOT execute PR-sourced scripts
+- Does NOT approve or merge the PR
+
+## Instructions
+
+Follow the detailed instructions in the corresponding prompt file
+(`.github/prompts/agdt.address-copilot-review.ci-repair.prompt.md`).
+
+## Next Step
+
+Task is complete.

agentic_devtools-0.2.302/.github/agents/agdt.address-copilot-review.evaluate-and-respond.agent.md

@@ -0,0 +1,71 @@
+---
+description: "Address Copilot Review (Evaluate and Respond): Evaluate review comments, make targeted changes, and post a structured resolution summary"
+agdt:
+  requires:
+    code_hosting: github
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+The expected input is the body of the `@copilot` trigger comment posted on the PR, which
+contains collapsible `<details>` blocks with review comment links (and any suppressed
+comment excerpts), optional CI failure links, and a reference to this skill.
+
+## Purpose
+
+Orchestrate the full end-to-end workflow for addressing a GitHub Copilot PR review in a CI
+environment:
+
+1. Parse the structured trigger comment to extract the review link, per-comment links, and
+   any CI failure info.
+2. For each comment (visible and suppressed): read the comment body and surrounding code
+   context, evaluate whether to implement, partially implement, or reject with rationale.
+3. Make targeted code changes for accepted suggestions.
+4. After all comments are processed, post a **single structured summary comment** on the PR.
+5. If CI failures are listed, also address those (delegating to the CI repair sub-skill
+   instructions).
+6. Commit and push. The post-push automation handles thread resolution, review re-request,
+   and squashing.
+
+**Scope limitations** (CI repair mode):
+
+- Does NOT run the full test suite (`agdt-test`, `pytest`) — use only targeted
+  `agdt-test-pattern` or `agdt-test-file` for verification.
+- Does NOT install packages from the PR branch.
+- Does NOT execute PR-sourced scripts.
+- Does NOT approve or merge the PR.
+
+**Copilot Cloud Agent Restrictions**:
+
+- Cannot force-push (`git push --force`) — only regular `git push` is allowed.
+- Cannot resolve PR review comment threads via UI/API.
+- Cannot merge PRs.
+
+**Pre-push Hook Behavior**:
+
+Git hooks are pre-configured via `copilot-setup-steps.yml` — no manual setup needed.
+After running `git push`, the pre-push hook automatically runs targeted checks (ruff format,
+ruff check, per-file coverage, mypy, test structure validation). This can take up to
+**2 minutes**. Do NOT interrupt the push or re-push during this time. If the push is
+rejected because ruff reformatted files (look for "❌ Files were reformatted by ruff" in
+the output or `.pre-push-output.log`), stage the reformatted files, amend the commit, and
+push again.
+
+You do NOT need to manually run `ruff format`, `ruff check`, or `mypy` before pushing.
+The pre-push hook handles all of this automatically. Focus only on code changes that
+address the review feedback.
+
+## Instructions
+
+Follow the detailed instructions in the corresponding prompt file
+(`.github/prompts/agdt.address-copilot-review.evaluate-and-respond.prompt.md`).
+
+## Next Step
+
+Task is complete.

agentic_devtools-0.2.302/.github/agents/agdt.apply-pr-suggestions.initiate.agent.md

@@ -0,0 +1,43 @@
+---
+description: "Apply PR Suggestions - Initiate: Apply PR review suggestions"
+agdt:
+  requires:
+    code_hosting: azure_devops
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Start the apply PR suggestions workflow.
+
+## Prerequisites
+
+- **Required state**: `pull_request_id`
+- **Set state** (if not already set):
+
+  ```bash
+  agdt-set pull_request_id <value>
+  ```
+
+## Actions
+
+1. Initiate apply PR suggestions:
+
+   ```bash
+   agdt-initiate-apply-pr-suggestions-workflow
+   ```
+
+## Expected Outcome
+
+The workflow starts and is ready to apply suggestions.
+
+## Next Step
+
+Workflow is complete.

agentic_devtools-0.2.302/.github/agents/agdt.approve-pull-request.agent.md

@@ -0,0 +1,45 @@
+---
+description: "Approve PR: Approve a pull request with sentinel banner"
+agdt:
+  requires:
+    code_hosting: azure_devops
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Approve a pull request with an approval sentinel banner in Azure DevOps.
+
+## Prerequisites
+
+- **Required state**: `pull_request_id`
+- **Required state**: `content`
+- **Set state** (if not already set):
+
+  ```bash
+  agdt-set pull_request_id <value>
+  agdt-set content <value>
+  ```
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-approve-pull-request
+   ```
+
+## Expected Outcome
+
+The pull request is approved with a sentinel banner (background task).
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.break-down-issue-into-subtasks.initiate.agent.md

@@ -0,0 +1,52 @@
+---
+description: "Break Down Issue - Initiate: Break down a Jira issue into subtasks"
+agdt:
+  requires:
+    issue_adapter: jira
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Start the break-down-issue-into-subtasks workflow to decompose a Jira issue into actionable subtasks.
+
+## Prerequisites
+
+- **Issue context (required)**: one of the following must be provided:
+  - Pass `--issue-key <KEY>` to `agdt-initiate-break-down-issue-into-subtasks-workflow`, or
+  - Ensure `jira.issue_key` is already set in state (for example: `agdt-set jira.issue_key PROJECT-1234`)
+- **Optional CLI arguments**:
+  - `--user-request "<TEXT>"` to pass the user's natural-language request or constraints into the workflow
+  - `--interactive true` to run the workflow in interactive mode; default is non-interactive/headless (`false`)
+
+## Actions
+
+1. Run the workflow initiation command using one of the following options:
+
+   **Option A — Explicit issue key via CLI argument (recommended for clarity):**
+
+   ```bash
+   agdt-initiate-break-down-issue-into-subtasks-workflow --issue-key <KEY> [--user-request "<TEXT>"] [--interactive true]
+   ```
+
+   **Option B — Use `jira.issue_key` from state (no `--issue-key` flag):**
+
+   ```bash
+   # Assumes jira.issue_key is already set in state (e.g. via: agdt-set jira.issue_key PROJECT-1234)
+   agdt-initiate-break-down-issue-into-subtasks-workflow
+   ```
+
+## Expected Outcome
+
+The workflow starts and the issue is ready for subtask decomposition.
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.check-user-exists.agent.md

@@ -0,0 +1,43 @@
+---
+description: "Check User Exists: Check if a Jira user exists"
+agdt:
+  requires:
+    issue_adapter: jira
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Check if a specific Jira user account exists.
+
+## Prerequisites
+
+- **Required state**: `jira.username`
+- **Set state** (if not already set):
+
+  ```bash
+  agdt-set jira.username <value>
+  ```
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-check-user-exists
+   ```
+
+## Expected Outcome
+
+User existence is confirmed or denied (background task).
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.check-users-exist.agent.md

@@ -0,0 +1,43 @@
+---
+description: "Check Users Exist: Check if multiple Jira users exist"
+agdt:
+  requires:
+    issue_adapter: jira
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Check if multiple Jira user accounts exist.
+
+## Prerequisites
+
+- **Required state**: `jira.usernames`
+- **Set state** (if not already set):
+
+  ```bash
+  agdt-set jira.usernames <value>
+  ```
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-check-users-exist
+   ```
+
+## Expected Outcome
+
+User existence results are returned (background task).
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.confirm-suggestion-addressed.agent.md

@@ -0,0 +1,43 @@
+---
+description: "Confirm Suggestion: Confirm a review suggestion was addressed"
+agdt:
+  requires:
+    code_hosting: azure_devops
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Confirm that a review suggestion has been addressed by the PR author.
+
+## Prerequisites
+
+- **Required state**: `pull_request_id`
+- **Set state** (if not already set):
+
+  ```bash
+  agdt-set pull_request_id <value>
+  ```
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-confirm-suggestion-addressed
+   ```
+
+## Expected Outcome
+
+The suggestion is marked as addressed (background task).
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.create-agdt-bug-issue.agent.md

@@ -0,0 +1,37 @@
+---
+description: "Create Bug Issue: Create a bug issue in agentic-devtools"
+agdt:
+  always: true
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Create a new bug report issue in the agentic-devtools repository.
+
+## Prerequisites
+
+No prerequisites required.
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-create-agdt-bug-issue
+   ```
+
+## Expected Outcome
+
+A new bug issue is created (background task).
+
+## Next Step
+
+Command is complete.

agentic_devtools-0.2.302/.github/agents/agdt.create-agdt-documentation-issue.agent.md

@@ -0,0 +1,37 @@
+---
+description: "Create Doc Issue: Create a documentation issue in agentic-devtools"
+agdt:
+  always: true
+---
+
+## User Input
+
+```text
+$ARGUMENTS
+```
+
+You **MUST** consider the user input before proceeding (if not empty).
+
+## Purpose
+
+Create a new documentation issue in the agentic-devtools repository.
+
+## Prerequisites
+
+No prerequisites required.
+
+## Actions
+
+1. Run the command:
+
+   ```bash
+   agdt-create-agdt-documentation-issue
+   ```
+
+## Expected Outcome
+
+A new documentation issue is created (background task).
+
+## Next Step
+
+Command is complete.