architecture-review

Category: Development & Coding | Uploader: semiherdogan | Downloads: 0 | Version: v1.0（Latest）

Use when reviewing architecture, finding module boundaries, improving testability, or identifying refactor opportunities in a codebase.

Changelog: Source: GitHub https://github.com/semiherdogan/dotfiles

Directory Structure

Current level: tree/main/ai/skills/architecture-review/

📄 SKILL.md 1.1 KB

SKILL.md

---
name: architecture-review
description: Use when reviewing architecture, finding module boundaries, improving testability, or identifying refactor opportunities in a codebase.
---

# Architecture Review

Look for places where complexity is poorly located.

Review for:
- Shallow modules: interfaces nearly as complex as their implementation.
- Pass-through layers that add no leverage.
- Logic spread across callers instead of concentrated behind one interface.
- Hard-to-test behavior caused by the wrong interface shape.
- Accidental coupling between unrelated concepts.

Output:
- List concrete candidates, ordered by impact.
- For each candidate, explain the current friction, proposed change, benefit, risk, and verification path.
- Separate clear wins from speculative redesign.

Use the deletion test:
- If deleting a module makes complexity disappear, it may be unnecessary.
- If deleting it spreads complexity across callers, it is probably earning its place.

Avoid:
- Re-litigating architecture without evidence from the code.
- Proposing broad rewrites.
- Treating file count reduction as an architectural goal.

Comments 0

Latest | Hot

Please login before commenting.

Loading comments...

architecture-review

Directory Structure

SKILL.md

Report

Notice