arch-decision

Q: How to install arch-decision?

Create the agents directory: mkdir -p .claude/agents. Then add the config to .claude/agents/arch-decision.md. Finally, @arch-decision in Claude Code.

Q: What is arch-decision best for?

arch-decision is categorized under General.

New

3GitHub TrendingGeneralby jsingh6

Open-source ADR orchestrator — explores your codebase, proposes approaches, writes Architecture Decision Records automatically

First seen 6/2/2026

Summary

This skill automatically explores your codebase to understand its architecture, proposes design approaches, and generates Architecture Decision Records (ADRs) to document key technical decisions.

It helps teams maintain a clear decision history and avoid repeating past discussions.

Install & Usage

Create the agents directory

mkdir -p .claude/agents

Save the agent file

Add the configuration to .claude/agents/arch-decision.md

Invoke with @agent-name

@arch-decision

Use Cases

When starting a new feature, use the skill to propose architectural approaches and generate an ADR for the chosen design.

When onboarding to an unfamiliar codebase, ask the skill to summarize past architectural decisions from existing ADRs.

When refactoring a module, let the skill analyze dependencies and generate an ADR documenting the refactoring strategy.

When evaluating a technology choice, have the skill compare options and produce an ADR with rationale and trade-offs.

When a team disagrees on an approach, use the skill to structure the decision with pros/cons and generate a formal ADR.

When updating a legacy system, ask the skill to identify outdated decisions and propose new ADRs for modernization.

Usage Examples

/arch-decision analyze the current authentication flow and propose an alternative using OAuth2, then generate an ADR.

Explore the codebase and suggest a strategy for migrating from REST to GraphQL, documenting the decision in an ADR.

Review the existing ADRs in the docs/adr folder and identify any decisions that need revisiting due to recent code changes.

View source on GitHub

Security Audits

LicenseUnknownSourceWarnRepositoryPass

Frequently Asked Questions

What is arch-decision?

This skill automatically explores your codebase to understand its architecture, proposes design approaches, and generates Architecture Decision Records (ADRs) to document key technical decisions. It helps teams maintain a clear decision history and avoid repeating past discussions.

How to install arch-decision?

To install arch-decision: create the agents directory (mkdir -p .claude/agents), then add the config to .claude/agents/arch-decision.md. Finally, @arch-decision in Claude Code.

What is arch-decision best for?

arch-decision is a agent categorized under General. Created by jsingh6.

What can I use arch-decision for?

arch-decision is useful for: When starting a new feature, use the skill to propose architectural approaches and generate an ADR for the chosen design.; When onboarding to an unfamiliar codebase, ask the skill to summarize past architectural decisions from existing ADRs.; When refactoring a module, let the skill analyze dependencies and generate an ADR documenting the refactoring strategy.; When evaluating a technology choice, have the skill compare options and produce an ADR with rationale and trade-offs.; When a team disagrees on an approach, use the skill to structure the decision with pros/cons and generate a formal ADR.; When updating a legacy system, ask the skill to identify outdated decisions and propose new ADRs for modernization..