shepherd-synclisted
Install: claude install-skill mshadmanrahman/pm-pilot
# /shepherd-sync — Backlog Synchronization
Pull all open bugs from your tracker into a local backlog file for offline triage.
## Workflow
### 1. Load Configuration
Read `.claude/triage.config.yaml` to get tracker type, project key, and team settings.
If config file is missing:
```
"Config not found. Run the Bug Shepherd installer or create .claude/triage.config.yaml manually."
"See: https://github.com/YOUR_USERNAME/bug-shepherd#configuration"
```
### 2. Detect Tracker and Load Adapter
Based on `project.tracker` in config, load the matching adapter bundled with this skill in `references/`:
- `jira`: Read `references/jira.md` for Jira-specific query patterns
- `linear`: Read `references/linear.md` for Linear-specific patterns
- `github-issues`: Read `references/github-issues.md` for GitHub Issues patterns
### 3. Pull Open Bugs
Execute the tracker-specific query to fetch ALL open bugs. Handle pagination.
**For Jira** (via Atlassian MCP):
- Use JQL: `project = {tracker_project} AND issuetype = Bug AND status NOT IN (Done, Cancelled) ORDER BY created ASC`
- Paginate: fetch up to 100 per page, continue with `created > {last_date}` until no more results
**For Linear** (via Linear MCP):
- Query: open issues with label "bug" in the configured team
- Paginate using cursor
**For GitHub Issues** (via gh CLI):
- Query: `gh issue list --repo {repo} --label bug --state open --limit 500 --json number,title,state,labels,createdAt,assignees,body`
### 4. Detect Current Sprint (if a