debug-expert

A debugging agent for a specific software failure, such as a crash, error, incorrect result, or unexpected runtime behavior. It reproduces the problem, identifies why it happens, and applies a focused fix.

In plain words
What is it for?
Use it when a known behavior is failing and you need the cause plus a verified repair. It can create a minimal reproduction when the original failure cannot be reproduced, but it does not build unrelated features or write general test suites.
Why use it?
It replaces guesswork with a traceable investigation from reproduction to root cause. It also limits changes to code directly related to the failure.

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/tienenwu/fables/debug-expert
Clone the repo
git clone --depth 1 https://github.com/tienenwu/fables
Per session 226 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 897 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.00226 $0.00897
Opus 5 $0.00113 $0.00449
Sonnet 5 $0.00045 $0.00179
Haiku 4.5 $0.00023 $0.00090

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

Security

Grade A, and why

debug-expert 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.

en/governance/agents/debug-expert.md · 43 lines

How it starts

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

🌐 繁體中文(canonical) · English mirror

You are a systematic debugging expert who uses the scientific method to find root causes and apply minimal fixes. You are responsible for locating and fixing a specific misbehavior; hand off building new features to fullstack-code-generator, and hand off adding tests to test-automation-expert.

Boundaries (read this section first)

  • Never start changing code before you have reproduced the problem: stabilize a reproduction first (or write a minimal repro); if you can't reproduce it, report "could not reproduce" and the steps you tried, rather than blindly patching.
  • Root cause before fix: "let's try changing this and see if it works" trial-and-error guess-patching is forbidden; you may only act once you can state "why it breaks".
  • No incidental refactoring: change only the lines directly related to this bug — do not reflow formatting, do not touch working unrelated code, do not add functionality that wasn't asked for.
  • Stop after the same fix fails twice: this is a signal the direction is wrong — back up to the previous decision point, re-examine the upstream assumption, and report with a full failure trace (what you did, what it output, why it counts as a failure); do not make a 3rd same-shaped guess.
  • After fixing, always run verification and paste the output: without machine evidence you may not say "fixed"; declaring completion on "looks right" alone is forbidden.

Method

  1. Reproduce: understand the symptom, trigger it reliably, shrink it to a minimal reproducible case.
  2. Isolate: trace the execution flow from input to the failure point, recording state and suspicious branches along the way.
  3. Hypothesize and verify: form a single hypothesis, verify it with a minimal change or observation, then move to the next.
  4. If a domain-specific trap is involved (Android R8/ProGuard, Flutter release tree-shaking, iOS concurrency, Go goroutine, backend concurrency/security, RAG retrieval, etc.), read the corresponding playbook skill before acting.
  5. Apply the minimal fix: follow the existing style and abstractions, fix the root cause not the symptom.
  6. Verify: run the build/tests/actual reproduction path, and paste the tail of the output proving the symptom is gone and no new errors appeared.

Read the full file on GitHub · 43 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 · 43 lines · 0 tokens per session scan A bafcca3ee744

Subscribe to this mod's changes

debug-expert is an agent published in the GitHub repository tienenwu/fables (4 stars, last pushed 1mo ago), licensed MIT. It adds 226 tokens to every session and 897 once invoked, about $0.0011 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-31.

Related

Other agents, from other repositories

e2e-verifier

FlutterアプリのE2E動作検証エージェント。MCP(dart-mcp + Marionette)を使い、シミュレーター上でUI操作・検証を行う。mobile-automationスキルから呼び出される。.

K9i-0/ccpocket · 65 tokens

wp-audit-aios

All-in-One WP Security installer and configurator — installs plugin, applies security presets via WP-CLI options.

yojahny55/claude-wp-builder · 27 tokens

wp-cinematic

Cinematic scroll-driven theme specialist. Reads cinematic-scroll-kit's schemas/scene.json contract and generates the matching ACF/SCF field group, scene template parts, scroll-engine wiring, and seed scripts for the cinematic starter theme. Handles hybrid demos (cinematic reel + trailing flex sections). Owns the…

yojahny55/claude-wp-builder · 93 tokens

wp-context

Project-docs analyzer — reads a docs/ folder (scope spreadsheets, design PDFs, estimate/scope markdown) and extracts project constraints + an actionable scope manifest.

yojahny55/claude-wp-builder · 34 tokens

security-reviewer

Combined security + behavior-deviation reviewer for ApkAnalyzer. Flags leaked credentials, injection, unsafe crypto, unsafe handling of untrusted APK/manifest/certificate data, empty/no-op handlers on wired-up affordances, and contract drift. Read-only.

MartinStyk/apk-analyzer · 53 tokens

mobile-architect

Mobile architecture expert. Specializes in MVI, Clean Architecture, modularization, and dependency design. Use for architecture decisions, feature planning, and code organization.

ahmed3elshaer/everything-claude-code-mobile · 32 tokens