use claude:

Author: dsyme

.github/copilot-instructions.md

@@ -5,7 +5,7 @@ This repository defines autonomous GitHub agents using the [gh-aw](https://githu
 ## Repository Structure
 
 - `workflows/` - Agent definitions in markdown format
-- `workflows/outputs/` - Reusable components for agent outputs and reporting
+- `workflows/shared/` - Reusable components for agent outputs and reporting
 
 ## Agent Definition Format
 
@@ -26,7 +26,7 @@ Agents are defined as markdown files with YAML frontmatter specifying:
 ### Components System
 Use `@include` directives to incorporate reusable components:
 ```markdown
-@include outputs/shared-team-issue.md
+@include shared/shared-team-issue.md
 ```
 
 ## Agent Patterns
@@ -72,7 +72,7 @@ Agents coordinate through a daily "Team Status DD/MM/YYYY" issue for progress re
 1. **Create agent file** - Add a new `.md` file in `workflows/` directory
 2. **Define YAML frontmatter** - Configure timeout, permissions, and tools
 3. **Write job description** - Numbered steps with clear exit conditions
-4. **Include components** - Use `@include outputs/shared-team-issue.md` for coordination
+4. **Include components** - Use `@include shared/shared-team-issue.md` for coordination
 5. **Test and compile** - Run `gh aw compile` to validate syntax
 
 ### Agent Development Process

workflows/agentic-coder.md

@@ -22,34 +22,27 @@ tools:
         add_issue_comment,
         create_pull_request,
       ]
-  Bash:
-    allowed: [":*"] # Allow all bash commands
-  Task:
-  Glob:
-  Grep:
-  LS:
-  Read:
-  Edit:
-  MultiEdit:
-  Write:
-  NotebookRead:
-  NotebookEdit:
-  WebFetch:
-  WebSearch:
+  claude:
+    Bash:
+      allowed: [":*"] # Allow all bash commands
+    Edit:
+    MultiEdit:
+    Write:
+    NotebookEdit:
+    WebFetch:
+    WebSearch:
 ---
 
 # Agentic Coder
 
 ## Components
 
-<!-- Includes https://github.com/githubnext/gh-aw/blob/main/components/samples/outputs/shared-team-issue.md -->
+<!-- Includes https://github.com/githubnext/gh-aw-samples/blob/main/workflows/samples/shared/shared-team-issue.md -->
 
-@include outputs/shared-team-issue.md
+@include shared/shared-team-issue.md
 
 ## Job Description
 
-<!-- https://github.com/githubnext/gh-aw/blob/main/components/samples/jobs/coder.md -->
-
 Your name is "${{ github.workflow }}". Your job is to act as an agentic coder for the GitHub repository `${{ env.GITHUB_REPOSITORY }}`. You're really good at all kinds of tasks. You're excellent at everything.
 
 1. Look for the issue labelled "swarm-plan". Read the plan, and any comments on the plan. If no issue is labelled "swarm-plan" ignore this step.
@@ -99,12 +92,8 @@ Your name is "${{ github.workflow }}". Your job is to act as an agentic coder fo
 
 > NOTE: You can use the tools to list, get and add issue comments to add comments to pull reqests too.
 
-> NOTE: If you are refused permission to run particular 'bash' commands, or need to request access to other tools or resources, include a request for access in the output report, explaining the exact prefix of bash commands needed or other resources you need access to, and file an issue to request access.
-
-> NOTE: Include a link like this at the end of each new issue, issue comment or pull request you create:
+@include shared/bash-refused.md
 
-```markdown
-> AI-generated content by [${{ github.workflow }}](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}) may contain mistakes.
-```
+@include shared/include-link.md
 
 <!-- Note - this file can be customized to your needs. Replace this section directly, or add further instructions here. After editing run 'gh aw compile' -->

workflows/agentic-dependency-updater.md

@@ -33,26 +33,18 @@ tools:
         get_dependabot_alert,
         list_dependabot_alerts,
       ]
-  Bash:
-    allowed: [":*"] # Allow all bash commands for now, will be reviewed later
-  Task:
-  Glob:
-  Grep:
-  LS:
-  Read:
-  Edit:
-  MultiEdit:
-  Write:
-  NotebookRead:
-  NotebookEdit:
-  WebFetch:
-  WebSearch:
+  claude:
+    Bash:
+        allowed: [":*"] # Allow all bash commands for now, will be reviewed later
+    Edit:
+    MultiEdit:
+    Write:
+    WebFetch:
+    WebSearch:
 ---
 
 # Agentic Dependency Updater
 
-<!-- https://github.com/githubnext/gh-aw/blob/main/components/samples/jobs/coder.md -->
-
 Your name is "${{ github.workflow }}". Your job is to act as an agentic coder for the GitHub repository `${{ env.GITHUB_REPOSITORY }}`. You're really good at all kinds of tasks. You're excellent at everything.
 
 1. Check the dependabot alerts in the repository. If there are any that aren't already covered by existing non-Dependabot pull requests, update the dependencies to the latest versions, by updating actual dependencies in dependency declaration files (package.json etc), not just lock files, and create a pull request with the changes. Try to bundle as many dependency updates as possible into one PR. Test the changes to ensure they work correctly, if the tests don't pass then divide and conquer and create separate pull requests for each dependency update. If the tests do pass close any Dependabot PRs that are already open for the same dependency updates with a note that the changes have been made in a different PR.
@@ -76,11 +68,7 @@ Your name is "${{ github.workflow }}". Your job is to act as an agentic coder fo
 
 > NOTE: You can use the tools to list, get and add issue comments to add comments to pull reqests too.
 
-> NOTE: If you are refused permission to run particular 'bash' commands, or need to request access to other tools or resources, include a request for access in the output report, explaining the exact prefix of bash commands needed or other resources you need access to, and file an issue to request access.
-
-> NOTE: Include a link like this at the end of each new issue, issue comment or pull request you create:
+@include shared/bash-refused.md
 
-```markdown
-> AI-generated content by [${{ github.workflow }}](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}) may contain mistakes.
-```
+@include shared/include-link.md
 

workflows/agentic-planner.md

@@ -18,29 +18,24 @@ tools:
         create_issue_comment,
         create_or_update_file,
       ]
-  Bash:
-    allowed: ["gh:*", "git:*"]
-  Task:
-  Glob:
-  Grep:
-  LS:
-  Read:
-  Edit:
-  MultiEdit:
-  Write:
-  NotebookRead:
-  NotebookEdit:
-  WebFetch:
-  WebSearch:
+  claude:
+    Bash:
+      allowed: ["gh:*", "git:*"]
+    Edit:
+    MultiEdit:
+    Write:
+    NotebookEdit:
+    WebFetch:
+    WebSearch:
 ---
 
 # Agentic Planner
 
 ## Components
 
-<!-- Includes https://github.com/githubnext/gh-aw/blob/main/components/samples/outputs/shared-team-issue.md -->
+<!-- Includes https://github.com/githubnext/gh-aw-samples/blob/main/workflows/samples/shared/shared-team-issue.md -->
 
-@include outputs/shared-team-issue.md
+@include shared/shared-team-issue.md
 
 ## Job Description
 
@@ -79,10 +74,7 @@ Your job is to act as an agentic planner for the GitHub repository ${{ env.GITHU
 
    Sometimes agentic coders leave labels on issues or pull requests they've "claimed". These labels will usually start with "Agentic Coder". Look around the repo to see if there are any stale labels. You can tell a stale label by whether the agentic coder left an "I'm working on it" comment on the issue or pull request over 20 minutes ago. In this case remove the label and add a comment saying that the agentic coder didn't seem to make progress on the issue and the issue is now open for anyone to work on.
 
-> NOTE: If you are refused permission to run particular 'bash' commands, or need to request access to other tools or resources, include a request for access in the output report, explaining the exact prefix of bash commands needed or other resources you need access to.
+@include shared/bash-refused.md
 
-> NOTE: Include a link like this at the end of each new issue, issue comment or pull request created:
+@include shared/include-link.md
 
-```
-> AI-generated content by [${{ github.workflow }}](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}) may contain mistakes.
-```

workflows/agentic-qa.md

@@ -24,29 +24,24 @@ tools:
         add_issue_comment,
         create_pull_request,
       ]
-  Bash:
-    allowed: [":*"] # Allow all bash commands
-  Task:
-  Glob:
-  Grep:
-  LS:
-  Read:
-  Edit:
-  MultiEdit:
-  Write:
-  NotebookRead:
-  NotebookEdit:
-  WebFetch:
-  WebSearch:
+  claude:
+    Bash:
+      allowed: [":*"] # Allow all bash commands
+    Edit:
+    MultiEdit:
+    Write:
+    NotebookEdit:
+    WebFetch:
+    WebSearch:
 ---
 
 # Agentic QA Engineer
 
 ## Components
 
-<!-- Includes https://github.com/githubnext/gh-aw/blob/main/components/samples/outputs/shared-team-issue.md -->
+<!-- Includes https://github.com/githubnext/gh-aw-samples/blob/main/workflows/samples/shared/shared-team-issue.md -->
 
-@include outputs/shared-team-issue.md
+@include shared/shared-team-issue.md
 
 ## Job Description
 
@@ -73,24 +68,7 @@ Your name is ${{ github.workflow }}. Your job is to act as an agentic QA enginee
 
    If the repository is empty or doesn't have any implementation code just yet, then exit without doing anything.
 
-2. You have access to the following tools:
-
-   - **GitHub**: To interact with the GitHub API, e.g. to list issues, create issues, add comments, etc.
-   - **Bash**: To run shell commands, e.g. to run tests, build the code, etc.
-   - **Task**: To create and manage tasks.
-   - **Glob**: To match files using glob patterns.
-   - **Grep**: To search for text in files.
-   - **LS**: To list files in a directory.
-   - **Read**: To read files.
-   - **Edit**: To edit files.
-   - **MultiEdit**: To edit multiple files at once.
-   - **Write**: To write files.
-   - **NotebookRead**: To read Jupyter notebooks.
-   - **NotebookEdit**: To edit Jupyter notebooks.
-   - **WebFetch**: To fetch web pages.
-   - **WebSearch**: To search the web.
-
-   You can use these tools to perform your tasks. For example, you can use the GitHub tool to list issues, create issues, add comments, etc. You can use the Bash tool to run shell commands, e.g. to run tests, build the code, etc.
+2. You have access to various tools. You can use these tools to perform your tasks. For example, you can use the GitHub tool to list issues, create issues, add comments, etc.
 
 3. If you find one or more problems, you should create new issues or add a comment on an existing issue. For each distinct problem:
 
@@ -100,10 +78,6 @@ Your name is ${{ github.workflow }}. Your job is to act as an agentic QA enginee
 
    - If you think the fix to a problem is simple, also create a pull request to fix it.
 
-> NOTE: If you are refused permission to run particular 'bash' commands, or need to request access to other tools or resources, include a request for access in the output report, explaining the exact prefix of bash commands needed or other resources you need access to, and file an issue to request access.
+@include shared/bash-refused.md
 
-> NOTE: Include a link like this at the end of each new issue, issue comment or pull request you create:
-
-```
-> AI-generated content by [${{ github.workflow }}](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}) may contain mistakes.
-```
+@include shared/include-link.md

workflows/agentic-researcher.md

@@ -20,14 +20,9 @@ permissions:
 tools:
   github:
     allowed: [create_issue]
-  Task:
-  Glob:
-  Grep:
-  LS:
-  Read:
-  NotebookRead:
-  WebFetch:
-  WebSearch:
+  claude:
+    WebFetch:
+    WebSearch:
 ---
 
 # Agentic Researcher

workflows/agentic-triage.md

@@ -15,18 +15,13 @@ permissions:
 tools:
   github:
     allowed: [update_issue]
-  Task:
-  Glob:
-  Grep:
-  LS:
-  Read:
-  Edit:
-  MultiEdit:
-  Write:
-  NotebookRead:
-  NotebookEdit:
-  WebFetch:
-  WebSearch:
+  claude:
+    Edit:
+    MultiEdit:
+    Write:
+    NotebookEdit:
+    WebFetch:
+    WebSearch:
 
 timeout_minutes: 10
 ---
@@ -88,10 +83,7 @@ You're a triage assistant for GitHub issues. Your task is to analyze issue #${{
    - If appropriate break the issue down to sub-tasks and write a checklist of things to do.
    - Use collapsed-by-default sections in the GitHub markdown to keep the comment tidy. Collapse all sections except the short main summary at the top.
 
-> NOTE: If you are refused permission to run particular 'bash' commands, or need to request access to other tools or resources, include a request for access in the output report, explaining the exact prefix of bash commands needed or other resources you need access to.
+@include shared/bash-refused.md
 
-> NOTE: Include a link like this at the end of each new issue, issue comment or pull request you create:
+@include shared/include-link.md
 
-```markdown
-> AI-generated content by [${{ github.workflow }}](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}) may contain mistakes.
-```

workflows/shared/bash-refused.md

@@ -0,0 +1,9 @@
+---
+tools:
+  github:
+    allowed:
+      [
+        create_issue,
+      ]
+---
+> NOTE: If you are refused permission to run particular 'bash' commands, or need to request access to other tools or resources, include a request for access in the output report, explaining the exact prefix of bash commands needed or other resources you need access to. Also open an issue to request access if one is not already open.

workflows/shared/include-link.md

@@ -0,0 +1,5 @@
+> NOTE: Include a footer link like this at the end of each new issue, issue comment or pull request you create. Do this in addition to any other footers you are instructed to include.
+
+```markdown
+> AI-generated content by [${{ github.workflow }}](https://github.com/${{ github.repository }}/actions/runs/${{ github.run_id }}) may contain mistakes.
+```