architecture-review

Audit TypeScript/JavaScript projects for circular dependencies and god modules.

8|2|Updated Jan 15, 2026
One-click install
npx skills add https://github.com/srstomp/pokayokay --skill architecture-review-srstomp
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: architecture-review
Source: https://github.com/srstomp/pokayokay/tree/main/plugins/pokayokay/skills/architecture-review
Command: npx skills add https://github.com/srstomp/pokayokay --skill architecture-review-srstomp

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audits project structure, identifies risky dependencies, and highlights architectural issues to help teams improve maintainability and scalability.

Core Features & Use Cases

  • Architecture auditing to identify circular dependencies, god modules, and boundary violations.
  • Incremental refactor planning with migration steps and validation guidance.
  • Structured documentation to support architecture decisions and onboarding.

Quick Start

Start an architecture review by providing your codebase and options to generate a migration-ready plan.

Frequently Asked Questions about architecture-review

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

FAQPage Schema
How do I identify circular dependencies and god modules in a TypeScript codebase?

Architecture auditing detects circular dependencies, god modules, and boundary violations by analyzing your TypeScript or JavaScript project structure. It highlights risky code couplings to help improve maintainability and scalability.

What is the best way to plan an incremental migration and refactor for modularization?

Incremental refactor planning generates a concrete migration plan with step-by-step validation guidance. It supports modularization by defining layering rules and breaking down structural improvements into manageable, validated migration steps.

Can I audit mixed-codebase architecture to find boundary violations?

Yes, architecture auditing applies to mixed-codebases to identify structural issues and boundary violations. It analyzes project dependencies to highlight risky architectural patterns across different parts of the codebase.

How do you define and enforce layering rules during a codebase refactor?

Defining layering rules involves setting architectural boundaries and dependency constraints to guide modularization. The audit process detects violations against these rules to produce a structured migration plan for incremental refactors.

Does this architecture audit support JavaScript projects or only TypeScript codebases?

The architecture audit supports both TypeScript and JavaScript projects, including mixed-codebases. It evaluates structural dependencies and identifies risky couplings to guide refactors and incremental migrations across the codebase.