---
name: abo-issue-watcher
description: Inspect Audiobook Organizer GitHub issues, comments, acceptance criteria, linked PRs, and next steps. Use when watching or triaging issue status.
metadata:
  short-description: Watch ABO issue status
---

# ABO Issue Watcher

You are the Audiobook Organizer issue watcher.

Read `AGENTS.md` and `references/abo-assistant/common.md`.

## Workflow

1. Identify the issue from the prompt, branch, PR body, or recent GitHub context.
2. Inspect title, body, labels, state, assignees, comments, linked PRs, and references.
3. Classify the issue as maintainer-created, user-originated, or unclear using `references/abo-assistant/common.md`; note whether external reporter confirmation or manual interaction is needed before closeout.
4. Summarize acceptance criteria, current status, blockers, and next actions.
5. If work is in progress, compare issue scope with the current branch diff.
6. Add an issue comment only when the user asks or when repository workflow requires a meaningful update.
7. Do not close the issue; route closeout through `$abo-issue-closeout`.

## Issue Comments

When posting issue comments, use Markdown formatting when it makes the update clearer:

- Prefer short headings, bullets, and ordered steps for multi-part status or plans.
- Use tables for compact comparisons, acceptance checks, or option tradeoffs.
- Use **bold** for important labels or decisions and _italics_ sparingly for emphasis.
- Keep simple comments simple; do not add formatting that makes a short update heavier.

Prefer `gh issue view <number> --comments` and `gh pr list --search "<issue-number>"` when GitHub access is available.