macropodhq/bugherd

Core BugHerd concepts for agents using the BugHerd MCP. Use before any BugHerd work to find the right project, and when the user asks about projects, websites, design assets, team members versus clients, or share links.

Create BugHerd tasks from reviews, audits, checklists or user requests, including feedback pinned to a page element with a screenshot. Use when the user asks to log, report, raise or capture feedback, bugs or issues in BugHerd.

Take BugHerd feedback through to a code fix with a human approving each step, from triage and a proposed fix to the code change, pull request and sign-off. Use when the user asks to fix, resolve or work through BugHerd tasks in a codebase.

Read a BugHerd task to understand the issue, the page and element it was left on, its screenshot, attachments and discussion. Use when the user shares a BugHerd task, asks what a task is about, or before fixing, triaging or replying to one.

Summarise BugHerd activity and workload for standups, client meetings and status reports, covering what got done, what's stuck and who's doing what. Use when the user asks for a summary, report, update, recap or overview of BugHerd projects or tasks.

Review and organise BugHerd feedback by changing status, assigning people, tagging, commenting and flagging what needs a human. Use when the user asks to triage, sort, assign, tag, prioritise, close or follow up on BugHerd tasks, or to reply on a task.