bug-triagelisted
Install: claude install-skill agentlab-in/hosted-ao
# Bug Triage Skill
Triage bugs into well-structured GitHub issues on the correct upstream repo.
## 1. Pre-flight
- **Pull latest code:** `git pull origin main`. Stale code = bad triage.
- **Target repo:** Always file on the **current repo** (`Untrivial-ai/agent-orchestrator`), not forks.
- **Record source:** chat URL, reporter name, attachments.
## 2. Gather Context
### 2a. Extract the report
| Source | How to gather |
|--------|---------------|
| **Discord/Slack thread** | Read full thread. Extract: reporter name, original description (the thread starter, not whoever tagged you), screenshots, follow-ups |
| **GitHub issue** | `gh issue view <number> --repo <repo> --json body,comments` |
| **Live observation** | Pull live state via observability tools |
### 2b. Minimum viable report gate
Before tracing code, verify the report has enough substance:
**Required (ALL):** what happened, where (page/command/feature), when (after upgrade? first time?)
**Required (2 of 4):** OS/shell/runtime, AO version (`ao --version`), reproducibility (consistent vs intermittent), reproduction steps
If insufficient, ask:
> "I'd like to triage this but need more info: (1) **What happened?** (error/behavior), (2) **Where?** (page/command), (3) **When did it start?**, (4) **How to reproduce?**"
### 2c. Local diagnostics (if bug is on same machine)
Gather everything yourself before asking the reporter:
```bash
# Environment
ao --version && node --version && echo $SHELL && uname -a
cat age