AI Software Architect plugin
A Claude Code plugin for project architecture: ADRs, multi-role reviews, findings turned into plans, a pragmatic mode.
- 80 ★ on the repository
- Last commit
Extended access
Why this level
- Skills and subagents create and edit files in `.architecture/` and project documentation.
- The MCP server performs file operations in the repository.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/ai-software-architectDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- Skills and subagents create and edit files in `.architecture/` and project documentation.
- The MCP server performs file operations in the repository.
This is third-party code. Review the repository files before installing.
What it does
AI Software Architect installs an `.architecture/` directory into a project and a process around it. It holds templates for architecture decision records (ADRs), multi-perspective architecture reviews, turning review findings into a concrete implementation plan and progress tracking. The plugin includes seven skills, an MCP server and generated subagents. The pragmatic guard mode checks proposed decisions against real need and keeps the project from sprawling. The review team is configurable and members can be created dynamically. The framework is plain Markdown and also works with other agents.
Who it is for. Tech leads and teams who want to keep architecture decisions in the repository and run AI reviews from several perspectives.
Good fit when
- Before choosing a message queue you need an ADR with options and consequences.
- Architecture is reviewed by several roles: security, performance, maintainability.
- Review findings turn into a task plan with progress tracking.
- You turn on pragmatic mode to stop a decision from growing more complex.
Not a fit when
- You need a quick change without documents and reviews.
- The team keeps no ADRs and is not ready to maintain them.
- You need automatic pragmatic enforcement through MCP: some operations are unavailable there.
Example request
Prepare an ADR on choosing a message queue and run an architecture review with security and maintainability roles.Limitations
The full feature set is available through the Claude Code plugin. The MCP variant installed as the npm package `ai-software-architect` provides deterministic file operations and pragmatic-mode configuration, but pragmatic checking there is a separate tool and dynamic team members are unavailable. The npm package carries the server, not the framework tree: `setup_architecture` takes files from the plugin or from a clone named in `CLAUDE_PLUGIN_ROOT`. The repository has no license file.
How to disable. Run `/plugin uninstall ai-software-architect`. Delete the `.architecture/` directory with your ADRs by hand if you no longer need the documents.
FAQ
How do I install the plugin?
Two commands in Claude Code: `/plugin marketplace add codenamev/ai-software-architect` and `/plugin install ai-software-architect@ai-software-architect`. Skills, the MCP server and subagents install as one unit.
How do I add only the MCP server?
Run `npm install -g ai-software-architect`, then `claude mcp add ai-software-architect -- mcp` or add an entry to `~/.claude.json` or `.mcp.json`.
What is pragmatic mode?
A mode that checks proposed architecture decisions against the real need of the project to avoid extra abstractions. It can be configured on any install route.
How do the install routes differ?
The plugin gives everything: skills, MCP, hooks and dynamic team members. The MCP route is limited to deterministic operations and pragmatic checking is a separate tool.
Where do the documents live?
In the `.architecture/` directory of your project: ADRs in `decisions/adrs/` and settings in `config.yml`.
Discussion
No questions or reviews yet.
Related
PluginsA Claude Code plugin that interviews you, designs the architecture and writes a self-contained blueprint to build from
An architecture coach skill: questions lead to ADRs, a diagram and a plan, and a repository is audited from its code
AI Code Toolkit
aicode-toolkit
Plugins and MCP servers for coding agents: template-based projects, patterns before a file edit and review against YAML rules.
Archgate turns architecture decisions into executable rules and blocks violations in CI, hooks and AI agent work
Nine plugins for Claude Code with 51 skills and 2 agents: a single workflow from a rough idea to a reviewed pull request.
Git-native project context for agents: specs, decisions and rules live in Markdown beside the code and are read before edits
README in short
A Markdown framework for architecture documentation, reviews and turning findings into a plan. Installs as a plugin, an MCP package or by copying.