ai-multi-agent-system: Skill for Claude Code

.agents/skills/debugging-discipline/SKILL.md

debugging-discipline is a skill for Claude Code, Codex from radif-ru/ai-multi-agent-system. It costs 47 tokens per session (745 once invoked), scanned A, original, MIT.

A step-by-step method for finding and fixing software bugs. It requires reproducing the problem, writing a test before the fix, correcting the underlying cause, and checking for regressions.

In plain words
What is it for?
Use it when tests fail, a bug is reported, an error appears in logs, or previously working behaviour stops working.
Why use it?
It prevents guesses and symptom-only fixes from hiding the original defect or creating new ones.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one. Also seen: installed under .agents/ (shared by several agents); mentions AGENTS.md.

This is radif-ru/ai-multi-agent-system's own configuration. It tells Claude Code and Codex how to work on ai-multi-agent-system itself, so it is not a mod to install elsewhere. Copy it as a starting point and replace the rules that are about this project. Everything ai-multi-agent-system configures →

Reuse

Borrowing it

Nothing to install: this file belongs to radif-ru/ai-multi-agent-system. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.

Copy the file
curl -O https://raw.githubusercontent.com/radif-ru/ai-multi-agent-system/main/.agents/skills/debugging-discipline/SKILL.md
Clone the repo
git clone --depth 1 https://github.com/radif-ru/ai-multi-agent-system

Made for: Claude Code, Codex.

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 debugging-discipline

README.md
[![agentmods](https://agentmods.dev/badge/skills/radif-ru/ai-multi-agent-system/debugging-discipline.svg)](https://agentmods.dev/skills/radif-ru/ai-multi-agent-system/debugging-discipline)
Your own site
<a href="https://agentmods.dev/skills/radif-ru/ai-multi-agent-system/debugging-discipline"><img src="https://agentmods.dev/badge/skills/radif-ru/ai-multi-agent-system/debugging-discipline.svg" alt="Measured on agentmods" height="20"></a>
Per session 47 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 745 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.1 $0.00047 $0.00745
Opus 5 $0.00023 $0.00373
Sonnet 5 $0.00009 $0.00149
Haiku 4.5 $0.00005 $0.00075

Measured 6d ago against content hash aed3a86e18ff, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-06, from the pricing page.

Security

Grade A, and why

debugging-discipline 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 6d 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.

.agents/skills/debugging-discipline/SKILL.md · 34 lines

How it starts

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

Skill: debugging-discipline

Систематическая отладка вместо угадывания. Дополняет testing-discipline (как писать тесты) и промпт debug-issue.prompt.md (разовая формулировка задачи ассистенту); источник поведенческих правил — AGENTS.md §3–§4.

Когда использовать

  • Упали тесты после правки или на чистой ветке.
  • Поведение системы не соответствует ожиданиям; ошибка в логах.
  • Пришёл баг-репорт от пользователя.
  • Что-то работало раньше, но перестало.

Алгоритм

  1. Стоп-линия. Прекрати добавлять новое поверх сбоя: неисправленный дефект делает недостоверными все последующие шаги. Сначала чинится сбой, потом продолжается задача.
  2. Сохрани доказательства. Текст ошибки, stacktrace, шаги воспроизведения, окружение — до любых правок, пока состояние не потеряно.
  3. Воспроизведи стабильно. pytest tests/<модуль> -q или минимальный сценарий. Плавающий сбой — сузь причину: зависимость от времени (добавь логи с метками), от окружения (сравни версии, чистую БД), от состояния (утечки между тестами, синглтоны, общие кэши). Не воспроизвёл — не чини «наугад»: зафиксируй условия и добавь наблюдаемость (logger.debug, не print).
  4. Напиши воспроизводящий тест до фикса. Красный тест — критерий успеха: после фикса он зелёный и остаётся в наборе как защита от регрессии.
  5. Найди первопричину. Конкретное место (файл, строка, условие): сузь диапазон по git log/git bisect, читай код от симптома вверх по стеку. Отличай причину от симптома — заплатка ниже по потоку не считается фиксом.
  6. Исправь минимально. Точечная правка у источника проблемы; несвязанный код не трогать (AGENTS.md §3). Попутные находки — в _docs/current-state.md §2, не в фикс-коммит.
  7. Проверь и защити. Баг-тест зелёный, полный pytest -q зелёный, flake8 чистый на изменённых файлах. Коммит — fix(<scope>): ... с тестом в том же коммите.

Чего избегать

  • Обходить сбой ради следующей фичи (skip, pytest -k, ослабление ассертов, try/except pass).
  • Чинить симптом downstream-заплаткой вместо первопричины.
  • Править «по гипотезе» без воспроизведения и красного теста.
  • Смешивать фикс с рефакторингом и попутными улучшениями.
  • Отлаживать через print вместо точечных структурных логов.

Read the full file on GitHub · 34 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. 6d ago First seen · 34 lines · 47 tokens per session scan A aed3a86e18ff

Subscribe to this mod's changes

debugging-discipline is a skill published in the GitHub repository radif-ru/ai-multi-agent-system (6 stars, last pushed 1mo ago), licensed MIT. It adds 47 tokens to every session and 745 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-31.