architect-reviewer

Audits codebases for architectural issues, code smells, and technical debt with severity-ranked findings.

31|2|Updated Feb 25, 2026
One-click install
npx skills add https://github.com/shaharia-lab/agento --skill architect-reviewer-shaharia-lab
Or copy as Structured Prompt for Agentā–¼
Please help me install this Agent Skill.
Skill: architect-reviewer
Source: https://github.com/shaharia-lab/agento/tree/main/.claude/skills/architect-reviewer
Command: npx skills add https://github.com/shaharia-lab/agento --skill architect-reviewer-shaharia-lab

SYSTEM DOCUMENTATION & REQUIREMENTS

šŸ’” This Skill includes references (resource) components.

What problem does it solve? Codebases accumulate architectural drift, hidden technical debt, and cross-platform bugs that are hard to spot during day-to-day development. This Skill performs a structured, honest architecture review that surfaces real problems with file paths, line numbers, and concrete fixes. ## Core Features & Use Cases - Full Codebase Audits: Maps module boundaries, dependency flow, and patterns across the entire project, flagging circular dependencies, god objects, and leaky abstractions. - Recent Change Reviews: Uses git log and git diff to review the last N days of commits, catching architectural regressions before they compound. - Focused Feature Reviews: Traces a feature's full call flow from entry point to storage, checking isolation, error handling, and testability. - Cross-Platform Checks: Flags code that breaks on Linux, macOS, or Windows, including path separators, shell commands, and signal handling. - Use Case: Before a major release, run a full audit to get a severity-ranked report with quick wins and strategic improvements, each backed by the actual problematic code. ## Quick Start Ask the agent to audit the codebase for architectural issues, code smells, and technical debt, or to review the last 7 days of changes.

Frequently Asked Questions about architect-reviewer

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit a codebase for architectural problems?ā–¼

Run the architect-reviewer with a task like "audit the codebase". It maps module boundaries and dependency flow, reads core files in each module, and reports circular dependencies, god objects, and leaky abstractions with file paths and line numbers.

How to review recent code changes for technical debt?ā–¼

Ask for a review of the last N days of changes. The skill runs git log and git diff to scope the commits, reads every changed file fully, and flags architectural regressions, inconsistencies, or new debt against the existing codebase.

What code quality issues does an architecture review check?ā–¼

It checks six dimensions: architecture, code smells, technical debt, performance, security, and maintainability. This includes long functions, deep nesting, swallowed errors, N+1 queries, hardcoded secrets, and missing test coverage.

Does the review cover cross-platform compatibility issues?ā–¼

Yes, it flags code that breaks on Linux, macOS, or Windows. Checks include hardcoded path separators, Unix-only shell commands, case-sensitive filename assumptions, line ending issues, and signals unavailable on Windows.

What output format does the architecture audit produce?ā–¼

Each finding includes category, location with line numbers, impact level, the problematic code, an explanation, a concrete fix, and an effort estimate. The report ends with a severity summary table, quick wins, and strategic improvements.