skills.rest
codenamevcodenamevCommunity·7 Agent Skills Included

ai-software-architect

Structured architecture reviews, decision records, and YAGNI enforcement

Runs multi-perspective architecture reviews using a team of specialized reviewers covering security, performance, maintainability, and domain design. Creates Architectural Decision Records, tracks recalibration plans, and enforces YAGNI principles to stop over-engineering before it starts. Eliminates scattered design docs and forgotten decisions by keeping all architecture documentation structured and versioned in one place.
74|11
↗
npx skills add codenamev/ai-software-architect --all -g -y
Available:

Instructs your AI agent on how to route natural language requests to the framework's skills, adopt specialist reviewer personas, and follow the architecture review, ADR, and pragmatic mode workflows.

All Skills in This Repository (7)

Pure Emerald Level Indicators
📦 In Repo
codenamevcodenamev

list-members

Parse .architecture/members.yml and render a structured team roster.

Community
Basic
📦 In Repo
codenamevcodenamev

architecture-review

Coordinate multi-member architecture reviews and generate a consolidated findings document.

Community
Intermediate
📦 In Repo
codenamevcodenamev

create-adr

Generate standardized Architectural Decision Records with sequential numbering and kebab-case filenames.

Community
Basic
📦 In Repo
codenamevcodenamev

pragmatic-guard

Configure pragmatic mode with intensity levels, triggers, exemptions, and deferrals.

Community
Basic
📦 In Repo
codenamevcodenamev

architecture-status

Aggregate ADR counts, reviews, and activity metrics into a Markdown status report.

Community
Basic
📦 In Repo
codenamevcodenamev

setup-architect

Sets up and configures the AI Software Architect framework in a new project.

Community
Intermediate
📦 In Repo
codenamevcodenamev

specialist-review

Generate a structured review document from a single specialist perspective.

Community
Intermediate

Frequently Asked Questions

FAQPage Schema
How to install AI Software Architect?▼

Run `npx skills add codenamev/ai-software-architect --all -g -y` in your terminal to install all seven skills globally.

How to run an architecture review with AI?▼

After setup, just say 'Start architecture review for version 2.0.0' and the framework dispatches every specialist reviewer in parallel, then consolidates their findings into one prioritized report.

What is an ADR and how do I create one?▼

An Architectural Decision Record documents why a technical choice was made. Say 'Create ADR for PostgreSQL database choice' and the skill generates a properly numbered, templated record in .architecture/decisions/adrs/.

How does pragmatic mode prevent over-engineering?▼

Enable it with 'Enable pragmatic mode' and a Pragmatic Enforcer scores every recommendation on necessity versus complexity, challenging abstractions and suggesting simpler alternatives.

Does AI Software Architect work with Cursor and Copilot?▼

Yes. It works with Claude Code, Cursor, and GitHub Copilot through natural language commands, with an optional MCP server for programmatic integration.

Related Repositories in Software Engineering

View All in Software Engineering→
openclawopenclaw
388.4k

openclaw

Run a personal AI assistant across your devices and chat apps

Official📦 120 Skills
obraobra
280.0k

superpowers

Gives coding agents a disciplined workflow from idea to merged code

Community📦 15 Skills
facebookfacebook
248.4k

react

AI agent skills for building, testing, and porting React core

Official📦 14 Skills