Arch Debugger — Development agent for Claude Code
Isolate a bug to a specific module or contract boundary, produce a minimal repro, and fix it without breaking black-box boundaries.
How to install Arch Debugger
Installs to ~/.claude/agents/gl0bal01-black-box-architecture-arch-debugger.md
mkdir -p ~/.claude/agents && curl -fsSL https://raw.githubusercontent.com/gl0bal01/black-box-architecture/HEAD/agents/arch-debugger.md -o ~/.claude/agents/gl0bal01-black-box-architecture-arch-debugger.md Restart Claude Code, or start a new session, for it to be picked up.
What Arch Debugger does
name: arch-debugger description: Isolate a bug to a specific module or contract boundary, produce a minimal repro, and fix it without breaking black-box boundaries. Use when debugging issues that may involve architectural violations. tools: Read, Glob, Grep, Bash, Edit, Write model: sonnet
Black Box Architecture — Debugger Agent v2.0
**Role**: Isolate bugs to module/contract boundaries, produce minimal repro, fix without breaking boundaries.
Follows `BLACKBOX_CONTRACT.md`.
Alternatives in Development
- Arch Linux Expert.Agent 31k ★
- Arch Reviewer 518 ★
- Shep Clean Arch Auditor — Read-only clean architecture auditor for shep 247 ★
Full documentation available on GitHub
View Source RepositoryRelated Agents
Arch Implementer
Execute an approved plan by making small, verifiable code changes that preserve black-box boundaries. Use afte
Arch Orchestrator
Coordinate architectural work by classifying requests, delegating to specialist sub-agents (analyzer, planner,
Sub Arch Health
Dept 2 sub. Audits boundary and dependency-direction violations plus tech-debt signals. Read-only.
Worker Validator
Black-box runtime validator (#256). Given a PR + its validation-contract.md, RE-RUNS each assertion's command
Council Haiku
Council seat - black box. Walks the Profile's Client path as a client would, using the Browser MCP server only
Validate Decomposition Agent
Validates architecture decomposition against SOLID principles. Adjusts arch.json if violations found.
Related Skills
Isolate Dependency Process Boundary
Use a GPL-incompatible-but-needed dependency by running it in a separate process the app talks to over IPC, so
4layer
/4layer - Four-Layer Minimal Repro Testing Protocol
Diagnose Bug
Diagnose the root cause of a bug -- evidence, minimal repro, one hypothesis at a time