bug-triage-agent

bug-triage-agent is an agent for Claude Code from lglucas/ai-dev-operating-system. It costs 71 tokens per session (858 once invoked), scanned A, original, MIT.

An automated first responder for broken builds, failed tests, crashed deployments, or features that no longer work.

In plain words
What is it for?
Use it to capture exact errors and commands, classify failures, compare recent working states with git log, isolate the cause, and propose a cautious fix.
Why use it?
It focuses on reproducing the failure and finding the smallest safe fix, helping avoid unnecessary redesign when a simple mistake caused the problem.

Agent for Claude Code

Part of the ai-dev-operating-system plugin — 28 skills, 11 commands, 12 agents, 1 hook shipped together

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add agents/lglucas/ai-dev-operating-system/bug-triage-agent
Clone the repo
git clone --depth 1 https://github.com/lglucas/ai-dev-operating-system

Made for: Claude Code.

Or install ai-dev-operating-system, the plugin that ships this one along with the rest of its 28 skills, 11 commands, 12 agents, 1 hook.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for bug-triage-agent

README.md
[![agentmods](https://agentmods.dev/badge/agents/lglucas/ai-dev-operating-system/bug-triage-agent.svg)](https://agentmods.dev/agents/lglucas/ai-dev-operating-system/bug-triage-agent)
Your own site
<a href="https://agentmods.dev/agents/lglucas/ai-dev-operating-system/bug-triage-agent"><img src="https://agentmods.dev/badge/agents/lglucas/ai-dev-operating-system/bug-triage-agent.svg" alt="Measured on agentmods" height="20"></a>
Per session 71 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 858 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00071 $0.00858
Opus 5 $0.00036 $0.00429
Sonnet 5 $0.00014 $0.00172
Haiku 4.5 $0.00007 $0.00086

Measured 4d ago against content hash e993624390fe, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

bug-triage-agent scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 4d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

.claude/agents/bug-triage-agent.md · 90 lines

How it starts

The opening of the file, as written. The whole thing — 90 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Bug Triage Agent

When to invoke

  • Build / install / dev-server fails.
  • Tests fail.
  • A deploy crashes after a successful local build.
  • A feature that worked yesterday no longer works.
  • The user pastes an error message or a stack trace.
  • The user says "deu erro" / "quebrou" / "tá dando ruim" / "não funciona mais".

Mindset

The vibe coder is not equipped to debug. Your job is to:

  1. Stay calm and stay simple. Don't propose architectural changes when a typo broke the build.
  2. Reproduce before fixing. Confirm the failure first.
  3. Bisect time. What was the last working state? git log is the tool.
  4. Smallest possible fix first. Revert > patch > refactor.
  5. Explain in plain Portuguese at every step, using the plain-portuguese-explainer skill if needed.

Workflow

Step 1 — Capture

Get exact error text, exact command run, exact file edited last. Do not paraphrase the error.

Step 2 — Classify

Pick one and only one:

  • 🟢 Cosmetic (warning, lint, deprecated)
  • 🟡 Functional (feature broken but app runs)
  • 🟠 Build (won't compile / install)
  • 🔴 Runtime (crashes when used)
  • Data loss risk (DB, file system, irreversible)

Step 3 — Locate

  • For build/runtime: read the trace, find the first line that points to project code (not node_modules).
  • For functional: identify which feature, which user flow, which file owns it.

Step 4 — Bisect

  • "When was this last working?" Use git log --oneline -20.
  • If a recent commit introduced the break, propose a revert as option A.

Step 5 — Propose fixes (ranked by safety)

A) [SAFEST] Revert the last change that broke this. Restores known-good state.
B) [MEDIUM] Targeted patch on the failing line.
C) [LARGER] Refactor the affected area. Only if A and B can't work.

Never go to C without explicit user approval and explaining why A and B don't fit.

Step 6 — Apply with verification

  • Make the change.
  • Run the same command that failed.
  • Confirm the failure is gone.
  • Run a broader smoke check (build + dev server starts + main page loads).
  • Use the verify-build-works skill.

Read the full file on GitHub · 90 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 4d ago First seen · 90 lines · 71 tokens per session scan A e993624390fe

Subscribe to this mod's changes

bug-triage-agent is an agent published in the GitHub repository lglucas/ai-dev-operating-system (11 stars, last pushed 26d ago), licensed MIT. It adds 71 tokens to every session and 858 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other agents, from other repositories

api-designer

REST and GraphQL API design - endpoint design, request/response schemas, versioning, and documentation. Use for designing new APIs or evolving existing ones.

AgentWorkforce/relay · 35 tokens

project-implementer

Implementation specialist - executes tasks from plans with TDD methodology, writes tests, and validates acceptance criteria. Use for executing phased implementation plans generated by attune:plan.

athola/claude-night-market · 38 tokens

external-system-integration-expert

你负责把当前项目与外部 API、API 网关及业务系统安全地连接起来:识别集成边界、整理接口与环境差异、验证请求和响应、定位认证或数据契约问题。.

agents-universe/agents-universe · 33 tokens

release-reviewer

Independently review all proposed release changes (version bumps, changelog, documentation updates) before they are committed. Catch errors, inconsistencies, and omissions that the individual agents may have missed.

luongnv89/skills · 0 tokens

Audit

Deep security + performance audit of a specific diff. Wraps /skill:security-hardening and /skill:performance-optimization (analysis phase only). Use when a change touches auth, untrusted input, secrets, webhooks, PII, or a latency/throughput budget — a focused, read-only risk pass that returns findings the parent…

BlackBeltTechnology/pi-agent-dashboard · 98 tokens

python-pro

Write idiomatic Python code with advanced features like decorators, generators, and async/await. Optimizes performance, implements design patterns, and ensures comprehensive testing. Use PROACTIVELY for Python refactoring, optimization, or complex Python features.

echoVic/blade-code · 51 tokens