decision-crafters

ADR Analysis Plugin for Claude Code

AI-powered Architectural Decision Record (ADR) analysis, generation, and management for intelligent development workflows.

Overview

This Claude Code plugin integrates the MCP ADR Analysis Server to provide 55+ specialized tools for architectural analysis, ADR management, deployment validation, and security assessment.

Features

• ADR Management: Generate, discover, review, and validate Architectural Decision Records
• Architectural Analysis: Comprehensive project ecosystem analysis with AST parsing for 12+ languages
• Deployment Validation: Zero-tolerance deployment readiness checks with hard blocking
• Security Analysis: Detect threats and apply content masking for sensitive data
• Research Integration: Web research with AI-powered analysis
• Rules Engine: Generate and validate architectural rules

Installation

From Claude Marketplace

# Add the marketplace
/plugin marketplace add decision-crafters/claude-plugin-adr-analysis

# Install the plugin
/plugin install adr-analysis@decision-crafters

Manual Installation

# Clone the repository
git clone https://github.com/decision-crafters/claude-plugin-adr-analysis.git

# Add as local marketplace
/plugin marketplace add ./claude-plugin-adr-analysis

# Install
/plugin install adr-analysis@decision-crafters

Requirements

• Claude Code CLI
• Node.js >= 20.0.0
• (Optional) OpenRouter API key for AI-powered analysis

Configuration

The plugin uses environment variables for configuration. Set these in your shell or .env file:

# Required for AI execution
export OPENROUTER_API_KEY="your-api-key"

# Optional configuration
export EXECUTION_MODE="full"        # full | prompt-only | ce-mcp | hybrid
export LOG_LEVEL="info"             # debug | info | warn | error
export ADR_DIRECTORY="docs/adrs"    # ADR storage location
export AI_MODEL="anthropic/claude-3.5-sonnet"
export AI_TEMPERATURE="0.7"

Slash Commands

Command	Description
/analyze	Analyze project architecture and patterns
/adr	Generate, discover, and manage ADRs
/deploy	Check deployment readiness
/research	Perform web research and integrate findings
/security	Analyze security threats and apply masking
/rules	Generate and validate architectural rules

Specialized Agents

The plugin provides four specialized agents that Claude can invoke:

ADR Expert (adr-expert)

• Generates high-quality ADRs with 95%+ confidence scoring
• Discovers and reviews existing ADRs
• Suggests new ADRs based on code analysis

Deployment Validator (deployment-validator)

• Enforces zero-tolerance deployment policies
• Validates test coverage and security
• Blocks unsafe deployments

Architecture Analyst (architecture-analyst)

• Comprehensive ecosystem analysis
• Pattern detection and anti-pattern identification
• Code quality metrics and recommendations

Security Analyst (security-analyst)

• Threat detection and vulnerability assessment
• Content masking for sensitive data
• Compliance validation

Available Tools (55+)

Analysis & Discovery

• analyze_project_ecosystem - Comprehensive project analysis
• get_architectural_context - Context for files/components
• analyze_content_security - Security threat detection
• smart_score - Architectural decision scoring

ADR Management

• generate_adr_from_decision - Create ADRs from decisions
• generate_adrs_from_prd - Generate from requirements
• discover_existing_adrs - Find existing ADRs
• suggest_adrs - AI-powered suggestions
• validate_adr / validate_all_adrs - Validation

Deployment

• deployment_readiness - Zero-tolerance validation
• smart_git_push - Safe git operations
• generate_deployment_guidance - Recommendations

Security

• analyze_content_security - Detect sensitive content
• generate_content_masking - Create masking strategies
• apply_basic_content_masking - Apply masking

Research

• perform_research - Web research
• llm_web_search - LLM-powered search
• incorporate_research - Integrate findings

Rules

• generate_rules - Create architectural rules
• validate_rules - Check compliance
• create_rule_set - Organize rules

Usage Examples

Analyze Project Architecture

User: /analyze

Claude: I'll analyze your project architecture...
[Uses analyze_project_ecosystem tool]
[Provides comprehensive analysis with patterns, recommendations]

Generate ADRs

User: /adr generate a decision about using PostgreSQL for the database

Claude: I'll create an ADR for the PostgreSQL decision...
[Uses generate_adr_from_decision tool]
[Creates structured ADR with context, decision, and consequences]

Check Deployment Readiness

User: /deploy