setup-architect

70 / 100 · Review before installing

Check before installing. Some of what it can do is expected: a coding skill usually runs build and test commands.

By codenamev/ai-software-architect (GitHub) · coding · 80 stars · scanned at commit 73d6f9a

Sets up and installs the AI Software Architect framework in a NEW project for the FIRST time. Use when the user requests "Setup .architecture", "Setup ai-software-architect", "Initialize architecture framework", "Install software architect", or similar setup/installation phrases. Do NOT use for checking status (use architecture-status), creating documents (use create-adr or reviews), or when framework is already set up.

Works with any agent that supports SKILL.md skills.

What this skill can do

Runs commands on your computer

The author does not mention this. It runs automatically when the plugin is installed. Expected for a coding skill.

Found in 7 places.

skills/setup-architect/SKILL.md, line 46TOOLS_CLI=""
skills/setup-architect/SKILL.md, line 91cp -r "$FRAMEWORK_ROOT/.architecture/templates" .architecture/templates
AGENTS.md, line 301bash -c 'test -d .architecture && test -d .claude && test -d .coding-assistants && echo "✓ Structure valid" || echo "✗ Structure invalid"'

Show 4 more

AGENTS.md, line 304bash -c 'test -f .architecture/members.yml && test -f .architecture/principles.md && test -f CLAUDE.md && echo "✓ Core files present" || echo "✗ Missing files"'
.mcp.json, line 4"command": "npx",
hooks/hooks.json, line 9"command": "node ${CLAUDE_PLUGIN_ROOT:-.}/tools/hooks/protect-files-hook.js"
hooks/hooks.json, line 20"command": "node ${CLAUDE_PLUGIN_ROOT:-.}/tools/hooks/validate-adr-hook.js"

Downloads and installs other software

The author does not mention this. It runs automatically when the plugin is installed.

Found in 4 places.

AGENTS.md, line 109- Install: `npm install -g ai-software-architect`
CLAUDE.md, line 50"command": "npx",
tools/lib/version-consistency.js, line 94{ label: '.mcp.json (npx pin)', file: '.mcp.json', read: c => extractNpxPin(c, 'ai-software-architect') },

Show 1 more

.mcp.json, line 4"command": "npx",

Changes files outside its own folder

The author does not mention this.

Found in 2 places.

skills/_patterns.md, line 346mkdir -p .claude/skills/skill-name/references
skills/_patterns.md, line 347mkdir -p .claude/skills/skill-name/assets

Safer alternatives

Low-risk skills in the same category (coding) that look related. Check that one does what you need.

Install

Paste this into your terminal. It downloads exactly the version we scanned, not whatever is newest.

if [ -e ~/.agents/skills/'setup-architect' ] || [ -L ~/.agents/skills/'setup-architect' ]; then echo 'A skill folder named setup-architect already exists — not replacing it' >&2; false; else d=$(mktemp -d) && git clone --quiet --filter=blob:none --no-checkout 'https://github.com/codenamev/ai-software-architect' "$d" && git -C "$d" checkout --quiet '73d6f9a63effc9aba948f5ea5a29fd73e65f547b' -- 'skills/setup-architect' && mkdir -p ~/.agents/skills && cp -R "$d"/'skills/setup-architect' ~/.agents/skills/'setup-architect' && rm -rf "$d"; fi

Codex reads ~/.agents/skills directly. For Claude Code, Cursor, Copilot, Gemini CLI, Antigravity or OpenCode, also link it. For Claude Code: ln -s ~/.agents/skills/'setup-architect' ~/.claude/skills/'setup-architect' (other agents: ~/.cursor/skills, ~/.copilot/skills, ~/.gemini/skills, ~/.gemini/config/skills, ~/.config/opencode/skills). Or install through the finder skill, which does both.

Badge for your README

The badge for codenamev/ai-software-architect shows the score of its lowest-scoring skill.

SkillTrust badge for codenamev/ai-software-architect

[![SkillTrust](https://zalavijaysinh.github.io/skilltrust/badges/codenamev/ai-software-architect.svg)](https://zalavijaysinh.github.io/skilltrust/repos/codenamev/ai-software-architect/)

Score history

Date	Version	Score
2026-11-09	`73d6f9a`	70
2026-11-07	`7bca3d8`	70