shepherd-sync
SolidSync triage results back into Jira, Linear, or GitHub Issues using the matching tracker adapter. Use after a triage run to update the tracker.
AI & Automation 17 stars
4 forks Updated today MIT
Install
Quality Score: 80/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# /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...
Details
- Author
- mshadmanrahman
- Repository
- mshadmanrahman/pm-pilot
- Created
- 5 months ago
- Last Updated
- today
- Language
- TypeScript
- License
- MIT
Integrates with
Similar Skills
Semantically similar based on skill content — not just same category
AI & Automation Solid
shepherd-triage
Launch parallel agents to check whether old bugs still reproduce on the live site, turning a stale backlog into a prioritized verified list. Use when a bug backlog needs cleaning without reading code.
17 Updated today
mshadmanrahman AI & Automation Solid
shepherd-start
Set up Bug Shepherd for a project: create the triage config, identify the tracker, and establish the backlog baseline. Use when starting bug triage on a new project.
17 Updated today
mshadmanrahman AI & Automation Solid
shepherd-review
Review triage results before syncing, so a human confirms verdicts on bugs that will be closed or reprioritized. Use between triage and sync.
17 Updated today
mshadmanrahman