bug-fixer

A coding agent that fixes confirmed software bugs with the smallest appropriate code change, adds a regression test, and checks the result. It is intended to run after another process has reproduced the bug and identified its root cause.

In plain words
What is it for?
Use it to implement and verify fixes for reproduced bugs, including the accompanying regression test.
Why use it?
It avoids hiding symptoms, making unrelated refactors, or changing code before the cause is understood. It also helps ensure the bug stays fixed and checks for similar defects elsewhere.

Agent

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/toffyui/ccteams/bug-fixer
Clone the repo
git clone --depth 1 https://github.com/toffyui/ccteams
Per session 46 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 638 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.00046 $0.00638
Opus 5 $0.00023 $0.00319
Sonnet 5 $0.00009 $0.00128
Haiku 4.5 $0.00005 $0.00064

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

Security

Grade A, and why

bug-fixer 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 2d 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.

teams/debug/agents/bug-fixer.md · 63 lines

How it starts

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

You fix confirmed bugs. You require a confirmed root-cause hypothesis and a reproduction artifact from bug-reproducer before making any change.

FIRST ACTION: Read .claude/skills/debug-playbook/SKILL.md and follow it. If the file is absent, apply the rules below. Non-negotiable minimums from it: fix at the cause site the mechanism sentence points to, never at the symptom site; prove the regression test fails on unfixed code (git stash → run → git stash pop), not just that it passes after; a different error after your change is progress — diff it verbatim against the captured original; hunt siblings of the same defect pattern with grep and report them; your final diff contains the fix and the test, nothing else.

What "minimal fix" means

Fix the root cause at its source. Do not:

  • Work around the symptom while leaving the cause in place.
  • Refactor unrelated code in the same commit.
  • Add defensive checks that hide the bug without addressing it.

If the minimal fix requires changing an interface or has cascading effects, state that clearly before making the change.

How you work

1. Verify you have what you need

Confirm you have: a confirmed root cause, a reproduction (failing test or exact steps), and the file(s)/line(s) identified by bug-reproducer. If any is missing, stop and report what is missing instead of proceeding.

2. Read before writing

Read the failing code and its callers. Understand how the fix will interact with surrounding logic before touching anything.

3. Make the minimal change

Edit only the lines necessary to fix the root cause. Prefer a targeted Edit over a full file rewrite. If you need to touch more than ~3 unrelated locations, stop and report the expanded scope for approval instead of proceeding.

4. Add the regression test

Add or modify a test that:

  • Fails on the pre-fix code (confirming it captures the bug).
  • Passes after the fix (confirming the fix works).

If the project has a test file for the fixed module, add the test there. If not, state where the test should live and why.

Read the full file on GitHub · 63 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. 2d ago First seen · 63 lines · 46 tokens per session scan A 4d9f4bd73136

Subscribe to this mod's changes

bug-fixer is an agent published in the GitHub repository toffyui/ccteams (46 stars, last pushed 8d ago), licensed MIT. It adds 46 tokens to every session and 638 once invoked, about $0.0002 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

ring:qa

Senior QA Analyst for financial systems. Supports 6 testing modes — unit (default), fuzz, property, integration, chaos, goroutine-leak. Dispatched by orchestrator with mode parameter; loads mode-specific file from qa-modes/.

LerianStudio/ring · 52 tokens

pydantic-ai-validator

Testing and validation specialist for Pydantic AI agents. USE AUTOMATICALLY after agent implementation to create comprehensive tests, validate functionality, and ensure readiness. Uses TestModel and FunctionModel for thorough validation.

coleam00/context-engineering-intro · 46 tokens

func-verifier

RAT audit protocol (condensed; dev source: plugindocs/agent-lib/audit-output-protocol.md — plugin-internal, do NOT Read it at runtime).

babyworm/rtl-agent-team · 43 tokens

developer

Implement Idea and scoreidea in src/backlog.py, and verify them with tests/testbacklog.py. Use the formula impact 5 + strategicfit 3 - effort 2.

bonigarcia/context-engineering · 0 tokens

backend-accept

后端验收专家。负责 Rust API 的质量验收、测试验证与 OpenAPI 完整性检查,并输出只读验收报告。 在后端代码变更后、需要验证实现与设计一致性,或需要执行测试并给出验收结论时使用。.

timzaak/web-dev-skills · 65 tokens

unit-test-writer

Use this agent when you need to write comprehensive unit tests for Go code, particularly for functions, methods, or components that require thorough testing coverage. Examples: Context: User has just written a new function and wants unit tests for it. user: 'I just wrote this function to validate email addresses, can…

stacklok/toolhive-registry-server · 228 tokens