By codenamev
Create and review software architecture documentation using AI specialist agents that assess design decisions, security, performance, maintainability, and simplicity, then record decisions as ADRs while enforcing YAGNI principles to prevent over-engineering.
AI Engineer architecture reviewer. Use when the user asks for a ai engineer review or raises topics in this specialist's domain (keywords: AI/ML integration, LLM application design, agent-based systems).
Domain Expert architecture reviewer. Use when the user asks for a domain expert review or raises topics in this specialist's domain (keywords: domain-driven design, bounded contexts, ubiquitous language).
Implementation Strategist architecture reviewer. Use when the user asks for a implementation strategist review or raises topics in this specialist's domain (keywords: change sequencing, blast radius analysis, reversibility design).
Maintainability Expert architecture reviewer. Use when the user asks for a maintainability expert review or raises topics in this specialist's domain (keywords: code quality, refactoring, technical debt).
Performance Specialist architecture reviewer. Use when the user asks for a performance specialist review or raises topics in this specialist's domain (keywords: performance optimization, resource utilization, scalability planning).
Conducts a comprehensive multi-perspective architecture review using ALL architecture team members. Use when the user requests "Start architecture review", "Full architecture review", "Review architecture for version X.Y.Z", "Conduct comprehensive review", or when they want assessment from multiple perspectives. Do NOT use for single-specialist reviews (use specialist-review instead) or for status checks (use architecture-status instead).
Reports on the health and state of architecture documentation (counts of ADRs, reviews, activity levels, documentation gaps). Use when the user asks "What's our architecture status?", "Show architecture documentation", "How many ADRs do we have?", "What decisions are documented?", "Architecture health check", or wants an overview/summary of documentation state. Do NOT use for listing team members (use list-members), creating new documents (use create-adr), or conducting reviews (use architecture-review or specialist-review).
Creates a NEW Architectural Decision Record (ADR) documenting a specific architectural decision. Use when the user requests "Create ADR for [topic]", "Document decision about [topic]", "Write ADR for [choice]", or when documenting technology choices, patterns, or architectural approaches. Do NOT use for reviews (use architecture-review or specialist-review), checking existing ADRs (use architecture-status), or general documentation.
Displays the roster of architecture team members with their specialties and expertise areas. Use when the user asks "Who's on the architecture team?", "List architecture members", "Show me the architects", "What specialists are available?", "Who can I ask for reviews?", or wants to discover available experts. Do NOT use for requesting reviews (use specialist-review or architecture-review) or checking documentation status (use architecture-status).
Enables and configures Pragmatic Guard Mode (YAGNI Enforcement) to prevent over-engineering. Use when the user requests "Enable pragmatic mode", "Turn on YAGNI enforcement", "Activate simplicity guard", "Challenge complexity", or similar phrases.
Modifies files
Hook triggers on file write and edit operations
Uses power tools
Uses Bash, Write, or Edit tools
Own this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimOwn this plugin?
Verify ownership to unlock analytics, metadata editing, and a verified badge. GitHub access is read-only (username + org membership).
Sign in to claimBased on adoption, maintenance, documentation, and repository signals. Not a security audit or endorsement.
A markdown-based framework for implementing rigorous software architecture practices in any project, with specialized AI assistant integration.
This framework provides a structured approach to:
For detailed usage instructions, see USAGE.md. For troubleshooting and advanced usage, see TROUBLESHOOTING.md.
Choose the installation method for your AI assistant:
Claude Code supports three installation methods:
Option 1: Claude Code Plugin (Recommended) 🆕
Install via the Claude Code plugin system with automatic updates:
# In Claude Code, run these commands:
/plugin marketplace add codenamev/ai-software-architect
/plugin install ai-software-architect@ai-software-architect
That's it! The framework is now available in all your projects — including the seven skills, MCP server, and generated subagents as a single unit.
See USAGE-WITH-CLAUDE-PLUGIN.md for detailed installation guide, troubleshooting, and comparison with other methods.
Benefits: Simplest installation, automatic updates, works across all projects, no manual file management, ships skills + MCP + hooks as a unit
When to use: You use Claude Code and want the most streamlined experience with automatic updates.
Option 2: MCP Server
npm install -g ai-software-architect
Then configure in ~/.claude/config.json:
{
"mcpServers": {
"ai-software-architect": {
"command": "mcp",
"args": []
}
}
}
Benefits: Programmatic automation, external tool integration, advanced project analysis
When to use: You need programmatic access or integration with other MCP-compatible tools.
Option 3: Traditional Setup
Setup architecture using: https://github.com/codenamev/ai-software-architect
See USAGE-WITH-CLAUDE.md for detailed instructions.
Benefits: No installation required, works immediately, maximum flexibility
When to use: Quick experiments, no installation permissions, or maximum customization needs.
If you're using Cursor, you have two options:
Option 1: MCP Server (Recommended)
npm install -g ai-software-architect
Then configure in Cursor settings (settings.json):
{
"mcp.servers": {
"ai-software-architect": {
"command": "mcp",
"args": []
}
}
}
Option 2: Traditional Setup
Setup architecture using @https://github.com/codenamev/ai-software-architect
See USAGE-WITH-CURSOR.md for detailed traditional setup instructions.
MCP Support: GitHub Copilot and Codex currently have limited MCP support. Use the traditional setup method:
Setup architecture using: https://github.com/codenamev/ai-software-architect
See USAGE-WITH-CODEX.md for detailed setup instructions. The framework will be configured with context files that GitHub Copilot and Codex can automatically understand.
Choose the right installation method for your workflow:
npx claudepluginhub codenamev/ai-software-architect --plugin ai-software-architectLong-term memory for Claude Code. Recalls architecture, conventions, and decisions across sessions — so Claude explains your codebase without file traversal, follows your patterns, and never re-asks what it already learned.
Make your AI agent code with your project's architecture, rules, and decisions.
Architecture Deep Research — scan a repo, draft a PRD, run live deep research, get a cited handoff. Use when picking a topology, retrieval architecture, event bus, storage engine, auth pattern, or any system-design decision before code lands.
Architecture Decision Records authoring and management
[Beta] 6つの専門エージェントチームでコードベースのアーキテクチャを多角的に分析するスキル
Enforces best-practice software design & architecture
Editorial "Architecture & Design" bundle for Claude Code from Antigravity Awesome Skills.