From 42a3fd683476315858563ee47890fd18ebd0f64a Mon Sep 17 00:00:00 2001
From: 777genius
Date: Wed, 27 May 2026 21:53:12 +0300
Subject: [PATCH] docs(github): refresh issue templates and release badge
---
.github/ISSUE_TEMPLATE/bug_report.md | 60 +++++++++++++++++------
.github/ISSUE_TEMPLATE/config.yml | 8 +++
.github/ISSUE_TEMPLATE/feature_request.md | 30 +++++++++---
.github/badges/version.svg | 1 -
.github/workflows/release.yml | 31 ------------
README.md | 2 +-
6 files changed, 77 insertions(+), 55 deletions(-)
create mode 100644 .github/ISSUE_TEMPLATE/config.yml
delete mode 100644 .github/badges/version.svg
diff --git a/.github/ISSUE_TEMPLATE/bug_report.md b/.github/ISSUE_TEMPLATE/bug_report.md
index 5d3171a1..b0cb7b8b 100644
--- a/.github/ISSUE_TEMPLATE/bug_report.md
+++ b/.github/ISSUE_TEMPLATE/bug_report.md
@@ -1,32 +1,60 @@
---
name: Bug report
-about: Create a report to help us improve
+about: Report a problem with the Agent Teams desktop app
title: "[BUG]"
labels: bug
assignees: ''
---
-**Describe the bug**
-A clear and concise description of what the bug is.
+**Summary**
+A clear description of what went wrong.
-**To Reproduce**
-Steps to reproduce the behavior:
+**Area**
+Which part of the app is affected?
+- Agent teams / teammate launch
+- Team messaging / inboxes
+- Tasks / kanban board
+- Code review / diffs
+- Built-in editor / Git
+- Provider runtime (Claude, Codex, OpenCode)
+- Settings / authentication
+- Installer / updater
+- Other:
+
+**Steps to reproduce**
1. Go to '...'
-2. Click on '....'
-3. Scroll down to '....'
-4. See error
+2. Click on '...'
+3. Run / create / send '...'
+4. See the problem
+
+**Frequency**
+How often does this happen? [Always / Often / Sometimes / Once]
+
+**Regression**
+Did this work before? If yes, what was the last known good version or commit?
+
+**Actual behavior**
+What happened instead?
**Expected behavior**
-A clear and concise description of what you expected to happen.
+What did you expect to happen?
-**Screenshots**
-If applicable, add screenshots to help explain your problem.
+**Environment**
+- OS and version: [e.g. macOS 15.5, Windows 11, Ubuntu 24.04]
+- App version or commit hash:
+- Install type: [GitHub release / source checkout / other]
+- Provider/runtime involved: [Claude / Codex / OpenCode / not sure / not relevant]
+- Desktop app mode: Electron
-**Desktop (please complete the following information):**
- - OS: [e.g. iOS]
- - Browser [e.g. chrome, safari]
- - Version [e.g. 22]
+**Logs and diagnostics**
+If relevant, include redacted logs or diagnostics.
+- Do not paste API keys, access tokens, private repository contents, or other secrets.
+- For team launch hangs or missing teammate replies, check the newest artifact pack under `~/.claude/teams//launch-failure-artifacts/latest.json` and include the redacted `manifest.json` summary if you can.
+- For UI errors, include the Electron DevTools console error if one is shown.
+
+**Screenshots or recording**
+If applicable, add screenshots or a short recording.
**Additional context**
-Add any other context about the problem here.
+Anything else that might help debug this.
diff --git a/.github/ISSUE_TEMPLATE/config.yml b/.github/ISSUE_TEMPLATE/config.yml
new file mode 100644
index 00000000..2154748f
--- /dev/null
+++ b/.github/ISSUE_TEMPLATE/config.yml
@@ -0,0 +1,8 @@
+blank_issues_enabled: false
+contact_links:
+ - name: Questions and early ideas
+ url: https://discord.gg/qtqSZSyuEc
+ about: Use Discord for support questions, broad ideas, and discussions before opening a large feature request.
+ - name: Security vulnerability
+ url: https://github.com/777genius/agent-teams-ai/security/policy
+ about: Please report undisclosed security issues privately instead of opening a public issue.
diff --git a/.github/ISSUE_TEMPLATE/feature_request.md b/.github/ISSUE_TEMPLATE/feature_request.md
index a2956b5d..4f22c369 100644
--- a/.github/ISSUE_TEMPLATE/feature_request.md
+++ b/.github/ISSUE_TEMPLATE/feature_request.md
@@ -1,20 +1,38 @@
---
name: Feature request
-about: Suggest an idea for this project
+about: Suggest an improvement for the Agent Teams desktop app
title: "[FEAT]"
labels: feature request
assignees: ''
---
-**Is your feature request related to a problem? Please describe.**
-A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
+**Summary**
+A clear description of the improvement you want.
+
+**Problem**
+What workflow is difficult, slow, confusing, or missing today?
+
+**Area**
+Which part of the app would this affect?
+- Agent teams / teammate launch
+- Team messaging / inboxes
+- Tasks / kanban board
+- Code review / diffs
+- Built-in editor / Git
+- Provider runtime (Claude, Codex, OpenCode)
+- Settings / authentication
+- Installer / updater
+- Other:
**Describe the solution you'd like**
-A clear and concise description of what you want to happen.
+What should the app do?
**Describe alternatives you've considered**
-A clear and concise description of any alternative solutions or features you've considered.
+What other approaches or workarounds did you try?
+
+**Success criteria**
+How would you know this feature is working well?
**Additional context**
-Add any other context or screenshots about the feature request here.
+Add screenshots, recordings, examples, or related issues if helpful.
diff --git a/.github/badges/version.svg b/.github/badges/version.svg
deleted file mode 100644
index 274b436e..00000000
--- a/.github/badges/version.svg
+++ /dev/null
@@ -1 +0,0 @@
-
diff --git a/.github/workflows/release.yml b/.github/workflows/release.yml
index ba5a2abc..8aed232f 100644
--- a/.github/workflows/release.yml
+++ b/.github/workflows/release.yml
@@ -856,37 +856,6 @@ jobs:
TAG="${RELEASE_TAG}"
gh release edit "${TAG}" --repo "${GITHUB_REPOSITORY}" --draft=false --latest
- - name: Update README version badge
- if: ${{ inputs.publish_release }}
- env:
- GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
- run: |
- set -euo pipefail
- DEFAULT_BRANCH="$(gh repo view "${GITHUB_REPOSITORY}" --json defaultBranchRef --jq '.defaultBranchRef.name')"
- git fetch origin "${DEFAULT_BRANCH}"
- BADGE_WORKTREE="$(mktemp -d)"
- git worktree add --detach "${BADGE_WORKTREE}" "origin/${DEFAULT_BRANCH}"
- trap 'git worktree remove --force "${BADGE_WORKTREE}" >/dev/null 2>&1 || true' EXIT
-
- BADGE_LABEL_WIDTH=51
- BADGE_VALUE="${RELEASE_TAG}"
- BADGE_VALUE_WIDTH=$(( ${#BADGE_VALUE} * 7 + 10 ))
- BADGE_WIDTH=$(( BADGE_LABEL_WIDTH + BADGE_VALUE_WIDTH ))
- BADGE_LABEL_X=$(( BADGE_LABEL_WIDTH / 2 ))
- BADGE_VALUE_X=$(( BADGE_LABEL_WIDTH + BADGE_VALUE_WIDTH / 2 ))
- mkdir -p "${BADGE_WORKTREE}/.github/badges"
- cat > "${BADGE_WORKTREE}/.github/badges/version.svg" <version: ${BADGE_VALUE}version${BADGE_VALUE}
- EOF
- if git -C "${BADGE_WORKTREE}" diff --quiet -- .github/badges/version.svg; then
- exit 0
- fi
- git -C "${BADGE_WORKTREE}" config user.name "github-actions[bot]"
- git -C "${BADGE_WORKTREE}" config user.email "41898282+github-actions[bot]@users.noreply.github.com"
- git -C "${BADGE_WORKTREE}" add .github/badges/version.svg
- git -C "${BADGE_WORKTREE}" commit -m "docs(readme): update release badge to ${BADGE_VALUE}"
- git -C "${BADGE_WORKTREE}" push origin "HEAD:${DEFAULT_BRANCH}"
-
- name: Keep release as draft
if: ${{ github.event_name == 'workflow_dispatch' && !inputs.publish_release }}
run: echo "Draft release ${RELEASE_TAG} is ready. It was not published because publish_release=false."
diff --git a/README.md b/README.md
index 5b53cbc0..85a8d719 100644
--- a/README.md
+++ b/README.md
@@ -18,7 +18,7 @@