{"slug": "arch-decision-a-multi-agent-architecture-tool-for-claude-code", "title": "Arch-Decision – A multi-agent architecture tool for Claude Code", "summary": "Arch-decision, an open-source AI orchestrator, produces formal Architecture Decision Records (ADRs) from codebases in minutes by using a multi-agent system to explore code, generate approaches, and recommend solutions. The tool, built as a Claude Code plugin, requires human approval before writing any ADR and has demonstrated accuracy by independently reaching the same conclusion as a human engineer on a real GitHub issue.", "body_md": "**arch-decision** is an open-source AI orchestrator that runs inside any codebase, explores it deeply, and produces a formal Architecture Decision Record — in minutes, not hours.\n\nEvery team faces the same gap: a decision gets made, the code gets written, but nobody wrote down *why*. Six months later a new engineer changes it — and the same debate happens all over again.\n\nArchitecture Decision Records (ADRs) solve this. But writing them is friction. It takes a senior engineer 2–4 hours to research the codebase, draft approaches, build a trade-off table, and write it up clearly. So it almost never happens.\n\n**arch-decision removes that friction entirely.**\n\nGive it a GitHub issue, a Jira ticket, or a plain description. It handles the rest:\n\n```\n/arch-decision https://github.com/owner/repo/issues/42\nPhase 0   Detects repo language, framework, existing ADRs\nPhase 1   Understands the problem from the issue or description\nPhase 2   Launches 3 parallel agents — prior art, impact map, constraints\nPhase 3   Asks clarifying questions before designing anything\nPhase 4   Generates 3 approaches simultaneously (Minimal / Clean / Pragmatic)\nPhase 5   Synthesizes a trade-off table and recommends the best path\nPhase 6   Waits for your approval — nothing is written without sign-off\nPhase 7   Writes a formal ADR to docs/decisions/ with full context\nPhase 8   Links the ADR back to the original issue\n```\n\nWorks on any language. Any framework. Any team.\n\n| GitHub Copilot / Cursor | arch-decision | |\n|---|---|---|\n| Operates on | Files and lines | The full decision lifecycle |\nKnows why you're building |\nNo | Yes — starts from the problem |\n| Produces documentation | No | Yes — formal ADR, committed to git |\n| Human approval gate | No | Yes — cannot proceed without sign-off |\n| Resumable across sessions | No | Yes — checkpoints after every phase |\n| Independently validated | — | Yes — community PRs confirm recommendations |\n\nRan against [ refinedev/refine](https://github.com/refinedev/refine) on issue\n\n[#7338](https://github.com/refinedev/refine/issues/7338)— a feature request for reverse filter mapping in\n\n`useTable`\n\nwith `syncWithLocation`\n\n.The tool explored the codebase cold, found prior art in `crudFiltersToColumnFilters`\n\n, identified the framework-agnostic constraint in `packages/core`\n\n, and recommended an `onParse`\n\ncallback scoped to the antd wrapper.\n\nA community contributor independently opened [PR #7385](https://github.com/refinedev/refine/pull/7385) with the same callback name, same scope, same placement — without seeing this output.\n\n**The tool reached the same conclusion a human engineer did, from a cold start, in under 5 minutes.**\n\narch-decision is a [Claude Code](https://claude.ai/code) plugin built on a multi-agent architecture:\n\n**Orchestrator**(`skills/arch-decision/SKILL.md`\n\n) — coordinates all 8 phases, maintains a context bus, enforces the human approval gate**Explorer agents**(`agents/arch-explorer/`\n\n) — 3 run in parallel during Phase 2, each focused on a different angle: prior art, impact map, and constraints**Synthesizer agent**(`agents/arch-synthesizer/`\n\n) — produces the trade-off table and recommendation from all three approaches\n\nThe human approval gate in Phase 6 means the agent cannot write the ADR without your explicit sign-off. It is designed to accelerate human judgment, not replace it.\n\n**Requires Claude Code.** Install it first if you haven't already.\n\nThen install the plugin:\n\n```\nclaude plugin install arch-decision\n```\n\nOpen Claude Code inside any repo and run:\n\n```\n/arch-decision <GitHub issue URL, Jira description, or plain text>\n```\n\nThat's it. Examples of what you can pass:\n\n```\n# GitHub issue\n/arch-decision https://github.com/owner/repo/issues/42\n\n# Paste your Jira ticket summary or description directly\n/arch-decision We need reverse filter mapping in useTable so URL params sync back to filter state on page load\n\n# Or just describe the problem in plain English\n/arch-decision add rate limiting to the public API\n```\n\nThe tool asks you clarifying questions, shows you 3 approaches with a trade-off table, and waits for your approval before writing anything. The ADR is saved to `docs/decisions/`\n\nin your repo.\n\nIf the problem is still vague and you want to frame it first, use\n\n`/arch-intake your problem here`\n\nbefore running`/arch-decision`\n\n.\n\nMetrics are tracked automatically on every ADR merge.\n\n[View the full Impact Dashboard](/jsingh6/arch-decision/blob/main/DASHBOARD.md)\n\n```\narch-decision/\n├── skills/\n│   ├── arch-decision/SKILL.md      — 8-phase orchestrator\n│   └── arch-intake/SKILL.md        — problem framing pre-skill\n├── agents/\n│   ├── arch-explorer/agent.md      — parallel codebase exploration\n│   └── arch-synthesizer/agent.md   — trade-off synthesis\n├── example-output/                 — real ADR examples\n├── scripts/generate_dashboard.py   — auto-generates DASHBOARD.md\n└── .github/workflows/              — updates dashboard on every ADR merge\n```\n\nMIT", "url": "https://wpnews.pro/news/arch-decision-a-multi-agent-architecture-tool-for-claude-code", "canonical_source": "https://github.com/jsingh6/arch-decision", "published_at": "2026-05-30 22:45:31+00:00", "updated_at": "2026-05-30 23:15:42.938501+00:00", "lang": "en", "topics": ["ai-tools", "ai-agents", "ai-products", "ai-startups", "generative-ai"], "entities": ["arch-decision", "GitHub", "Jira", "Architecture Decision Record", "Claude Code"], "alternates": {"html": "https://wpnews.pro/news/arch-decision-a-multi-agent-architecture-tool-for-claude-code", "markdown": "https://wpnews.pro/news/arch-decision-a-multi-agent-architecture-tool-for-claude-code.md", "text": "https://wpnews.pro/news/arch-decision-a-multi-agent-architecture-tool-for-claude-code.txt", "jsonld": "https://wpnews.pro/news/arch-decision-a-multi-agent-architecture-tool-for-claude-code.jsonld"}}