Bug Shepherd v1.0.0 — Zero-Code Bug Triage for PMs

Bug Shepherd v1.0.0

Zero-code bug triage for PMs, designers, and anyone who doesn't live in the codebase.

What's Included

5 Slash Commands

• /shepherd-sync — Pull open bugs from your tracker into a local backlog
• /shepherd-start {ID} — Begin a focused bug investigation session
• /shepherd-triage — Mass-check reproducibility with parallel AI agents
• /shepherd-review — Quality gate before pushing a fix
• /shepherd-learn — Capture lessons into institutional memory

3 Tracker Adapters

• Jira (via Atlassian MCP) — full support
• Linear (via Linear MCP) — adapter included
• GitHub Issues (via gh CLI) — adapter included

Parallel Agent Architecture

Launch up to 5 agents simultaneously to check 30 bugs in ~5 minutes. Each agent navigates your live site with Playwright, attempts reproduction, and reports findings.

Safety Gates (Learned from Real Incidents)

• Human approval required before any bug is cancelled
• High false-negative categories (scroll, touch, animation) always go to human review
• Bugs with recent activity or active assignees are never auto-cancelled
• Full audit trail via triage logs

Institutional Memory

Every session captures lessons. These lessons load at the start of the next session, preventing repeated mistakes and building project-specific knowledge over time.

Quick Start

git clone https://github.com/mshadmanrahman/bug-shepherd.git
cd bug-shepherd
chmod +x install.sh
./install.sh

The installer asks 4 questions (tracker, project name, URL, team email) and sets everything up.

Requirements

• Claude Code
• A bug tracker: Jira, Linear, or GitHub Issues
• Optional: Playwright MCP for automated reproduction

Documentation

• Architecture — How the system works
• Safety Rules — Why human gates exist (the real incident story)
• Customization — Adding project-specific rules

---

Built by a PM who triaged 240+ bugs across 28 locales without writing a single line of product code.