Plugin · Claude Code · Development Tools

Codenamev Ai Software Architect

codenamev-ai-software-architect is a Claude Code plugin for the Validate phase that provides an AI-assisted ADR, architecture review, and pragmatic-mode documentation framework.

by codenamev · github.com/codenamev/ai-software-architect

Install to generate ADRs, run architecture reviews, and keep design decisions pragmatic (YAGNI) while Claude helps you document the system.

56
GitHub stars
0
Installs
0
Community votes
One vote per signed-in builder - it helps surface the tools the community actually relies on.
Install

Add it to Claude Code

Install the plugin in Claude Code. One command, paste-ready.

Install the plugin
/plugin install codenamev-ai-software-architect@codenamev/ai-software-architect
Add to ClaudeUse the Agent APISkillselion is itself an MCP server - your agent can fetch this config directly.
Agent API

Built to be called by your agent

Skillselion is itself an MCP server. Your agent can pull this entry and a paste-ready install config straight from the API - no copy-paste.

Retrieve this entry with skillselion.get_details("plugin:codenamev/ai-software-architect") and the paste-ready config with skillselion.get_install_config("plugin:codenamev/ai-software-architect").

About

What it does

codenamev-ai-software-architect is a Claude Code plugin that turns architecture from vague diagrams into documented decisions solo builders can defend and revisit. It centers on ADRs, structured architecture reviews, and a pragmatic mode that pushes you toward simpler designs when scope creep threatens your timeline. Install it when you are past the napkin-sketch phase and need a lightweight framework the agent can follow—without standing up a separate documentation portal. The plugin is aimed at indie SaaS and API builders who make consequential structural choices alone and want those choices written down before code hardens them. Reviews help you sanity-check coupling, boundaries, and tradeoffs; pragmatic mode keeps the agent from gold-plating. It pairs naturally with validation and build planning, then remains useful at ship-time when you compare implementation to recorded intent.

Highlights

  • Architectural Decision Records (ADR) workflow for traceable design choices
  • Architecture review prompts aligned with software-design discipline
  • Pragmatic mode emphasizing YAGNI over over-engineering
  • AI-powered documentation framework packaged as a Claude Code plugin
  • Single-plugin install path for architecture docs without separate tooling

Why builders use it

Solo builders ship systems without durable decision records, then forget why constraints existed when refactoring or pitching investors.

After install, you can produce ADRs and reviewed architecture notes that guide implementation and later reviews without restarting design from memory.

At a glance

  • Type - Plugin in Development Tools.
  • Adoption - 0 installs, 56 stars, 0 votes.

FAQ

Who is codenamev-ai-software-architect for?

Solo developers and small teams who need ADRs, architecture reviews, and pragmatic design guardrails while coding with Claude Code.

When should I use codenamev-ai-software-architect?

Use it when you are locking scope, choosing between design options, or preparing to build something you will maintain for months.

How do I add codenamev-ai-software-architect to my agent?

Install the plugin from codenamev/ai-software-architect via Claude Code’s plugin installer, then invoke its architecture skills during planning or review sessions.

Discussion

Comments

Share how you use codenamev-ai-software-architect, gotchas, or tips for other indie builders.

No comments yet - be the first to share how you use it.

This week for builders

Five minutes, every Monday — the tools, releases and tactics for shipping solo.

unsubscribe anytime.