Architecture Decision Records (ADRs) are short documents that capture critical architectural decisions, their context, and their consequences to ensure long-term maintainability.

What is the AI Software Architect framework?

It is a documentation-driven framework that uses Architecture Decision Records (ADRs) and virtual specialist roles to maintain high architectural standards in software projects.

Does it modify my existing source code?

No, it primarily adds a dedicated .architecture directory and updates your CLAUDE.md file to help the AI understand your project's governance rules.

Does this skill support specific languages?

Yes, it automatically detects and customizes principles for various stacks including JavaScript/TypeScript, Python, Ruby, Java, Go, and Rust.

Can I use this on an existing project?

Absolutely. The skill performs an initial system analysis to document the current state and provide recommendations for existing codebases during the setup process.

AI Architecture Architect Setup

Name: AI Architecture Architect Setup
Author: codenamev

bycodenamev

•

Learning & Documentation

Initializes a comprehensive AI-driven architecture documentation framework with ADRs, customized specialist teams, and pragmatic design principles.

The setup-architect skill automates the installation of the AI Software Architect framework into any project. It goes beyond simple file copying by analyzing your specific technology stack—whether you're using React, Django, or Spring Boot—and tailoring a virtual team of specialists and architectural principles to match. By generating an initial system analysis and setting up Architecture Decision Records (ADRs), it provides immediate governance and clarity for scaling complex software projects within the Claude Code environment.

Key Features

0142 GitHub stars

02Automated project tech-stack analysis and technology detection

03Installation of ADR (Architectural Decision Record) templates and folder structures

04Generation of an initial comprehensive system analysis and health report

05Seamless integration with CLAUDE.md for enhanced AI workflow instructions

06Customization of virtual architecture specialists tailored to your specific language and framework

Use Cases

01Initializing architectural governance and ADR processes on a new greenfield project

02Standardizing documentation practices for a legacy codebase through automated analysis

03Automating the setup of a specialized AI-powered code review and design team

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add codenamev/ai-software-architect setup-architect

For use in Claude.ai and ChatGPT

Download Skill