ai-software-architect
🥈SilverAI-powered architecture documentation framework for software projects. Generates ADRs, conducts reviews, and offers pragmatic mode. Integrates with Claude Code Plugin for easy installation. Benefits operations teams by automating architecture documentation and reviews.
7050Updated 2mo ago
Intermediate30min to implementautomation
Saves ~240 min per use
Quick InstallView Source
git clone https://github.com/codenamev/ai-software-architect.gitWorks with:
Claude
Overview
About This Skill
AI Software Architect is a markdown-based framework that helps teams implement rigorous software architecture practices through structured documentation, reviews, and progress tracking. It provides templates and processes for creating Architecture Decision Records (ADRs), conducting multi-perspective architecture reviews, and translating feedback into implementation plans. The framework integrates seamlessly with Claude Code, Cursor, and other AI coding assistants via three installation methods: Claude Code Plugin (recommended for simplest setup), MCP Server (for programmatic automation), or traditional setup (for maximum flexibility). It supports a pragmatic mode for practical decision-making and offers advanced project analysis capabilities across all installation paths.
How to Use
Install via Claude Code Plugin with two commands (`/plugin marketplace add` and `/plugin install`), or via npm for MCP Server integration, or use traditional setup by referencing the GitHub repository. The framework provides templates and processes accessible through your AI assistant for creating ADRs, conducting reviews, and monitoring implementation.
Use Cases
Generate and manage Architecture Decision Records (ADRs) automatically
Conduct multi-perspective architecture reviews with specialized reviewers
Track implementation progress of architectural changes across projects
Document architectural decisions in markdown for version control
Tags
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/codenamev/ai-software-architectRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
Act as an AI software architect for our [PROJECT_NAME] project. Generate an Architecture Decision Record (ADR) for our decision to use [TECHNOLOGY] as our primary database. Include the context, decision, status, and consequences. Also, conduct a quick review of our current architecture focusing on [SPECIFIC_CONCERN] and provide recommendations.
Example Output
Based on your request, I've generated an ADR for the decision to use MongoDB as the primary database for your e-commerce platform project. The context highlights the need for scalability and flexible data modeling to handle diverse product catalogs and customer data. The decision to use MongoDB is marked as 'Accepted' with the consequences being improved scalability and easier schema evolution, but with potential trade-offs in transactional integrity. For the architecture review, I've identified that your current microservices architecture could benefit from implementing a more robust service mesh to handle inter-service communication more efficiently. I recommend evaluating Istio or Linkerd for this purpose, as they provide advanced traffic management, security, and observability features.
Apply to these tools
Browse all toolsClaude
AI assistant built for thoughtful, nuanced conversation
Microsoft Teams
Get more done every day with Microsoft Teams – powered by AI
Drata
Automate security compliance and monitor real-time security posture seamlessly.
GPT for work
Automate your spreadsheet tasks with AI power
Respell
Agentic AI Workflow platform
Notion
Connected workspace for docs, wikis, and projects
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan