ai-software-architect

Overview

AI Software Architect is a structured markdown-based framework for implementing rigorous software architecture practices. It provides tools for documenting architectural decisions (ADRs), conducting architecture reviews, tracking progress, and integrating with AI coding assistants. The project includes an MCP server that exposes tools for architecture management, ADR creation, specialist reviews, and status tracking across multiple AI assistants.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• setup_architect

  Sets up the AI Software Architect framework in a project

  Try:Setup ai-software-architectTry:Initialize the architecture framework
• create_adr

  Creates Architectural Decision Records

  Try:Create ADR for PostgreSQL database choiceTry:Document architectural decision about microservices
• architecture_review

  Conducts comprehensive multi-perspective architecture reviews

  Try:Start architecture review for version 2.0.0Try:Review authentication feature architecture
• specialist_review

  Gets focused reviews from specific architecture experts

  Try:Ask Security Specialist to review API authenticationTry:Have Performance Specialist evaluate caching strategy
• list_members

  Shows the architecture review team members

  Try:List architecture membersTry:Who are our architecture reviewers?
• architecture_status

  Displays current documentation state of the architecture

  Try:What's our architecture status?Try:Show architecture documentation status
• enable_pragmatic_mode

  Enables pragmatic YAGNI mode for architecture implementation

  Try:Enable pragmatic modeTry:Turn on YAGNI for architecture decisions
• implement_as_architects

  Implements features following the architectural methodology

  Try:Implement authentication as the architectsTry:Build user registration following architecture guidelines
• architecture_recalibration

  Starts the recalibration process to translate reviews into implementation plans

  Try:Start architecture recalibration for the authentication featureTry:Recalibrate architecture based on review findings

Note: Tools are explicitly documented in the 'Standard Commands' and 'Available Skills' sections with clear names and descriptions.

Comparable tools

Installation

npm install -g ai-software-architect

{
  "mcpServers": {
    "ai-software-architect": {
      "command": "mcp",
      "args": []
    }
  }
}

FAQ

What is an ADR?

ADR stands for Architecture Decision Record. It's a document that captures important architectural decisions along with their context, consequences, and rationale.

Which AI assistants support this MCP server?

The MCP server primarily supports Claude and Cursor. Traditional setup works with GitHub Copilot and other assistants.

On Hacker News

Recent discussion from the developer community.

• The AI Software Architect▲ 1💬 1
  Story by codenamev · 2025-05-28

Compare ai-software-architect with