# Architect Review

> Review code changes for architectural issues — module boundaries, coupling, and dependency direction. Use when this capability is needed.

- Skill: `tomevault-io/architect-review` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/architect-review`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/architect-review/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/architect-review

---


# /architect-review

Spawns the `architect-reviewer` agent to analyze your current changes at the system level — module boundaries, dependency direction, and pattern consistency.

## Steps

1. **Gather context** — detect the scope of changes to review:
   - If arguments are provided (file paths or PR number), use those as scope
   - Otherwise, use `git diff --name-only` to determine which modules are affected
   - Run `git log --oneline -5` for recent commit context

2. **Spawn the agent** — use the Task tool:
   ```
   Task tool with subagent_type="architect-reviewer"
   ```
   Pass in the prompt:
   - The diff output and list of changed files
   - The module/directory structure of the project
   - Any architectural conventions from `.claude/rules/` that apply

3. **Present findings** — relay the agent's architecture review:
   - Group by severity: VIOLATION > WARNING > SUGGESTION
   - Include module names and dependency chains
   - Show recommended fixes for boundary violations

4. **Offer follow-up actions**:
   - "Fix violations?" — restructure imports to respect boundaries
   - "Run code review too?" — spawn code-reviewer for line-level feedback
   - "Review again?" — re-run after changes

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/bis-code) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-11 -->

