architecture-review | pokayokay | ClaudePluginHub

Skill

Community

architecture-review

2

Description

Use when auditing project structure, planning refactors, improving code organization, analyzing dependencies and module boundaries, or identifying structural issues. TypeScript/JavaScript-primary with language-agnostic patterns.

AI Summary

Analyzes project structure to identify architectural issues and propose refactoring strategies with incremental migration plans.

Install

1

Add the repository(one-time)

$

/plugin marketplace add srstomp/pokayokay

2

Install the plugin

$

/plugin install pokayokay@pokayokay

Tool Access

This skill inherits all available tools. When active, it can use any tool Claude has access to.

Supporting Assets

View in Repository

references/analysis-techniques.md

references/anti-rationalization.md

references/cleanup-strategies.md

references/dependency-management.md

references/refactoring-patterns.md

references/structural-patterns.md

Skill Content

Architecture Review

Analyze, audit, and improve project structure.

Key Principles

Measure before changing — Map structure and identify concrete issues before proposing changes
Clear boundaries — Layers (UI, logic, data) separated with consistent dependency direction
Colocation — Related code together; easy to find, change, and delete features
Incremental migration — Refactor in phases, validate each step with tests

Quick Assessment

No circular dependencies
Consistent directory naming and grouping (by feature or by type)
Single responsibility per file/module, reasonable file sizes (<500 lines)
External dependencies isolated, shared code properly extracted
New developers can navigate and find code for any feature easily

Quick Start Checklist

Map current structure: directory tree, dependency graph, module boundaries
Identify issues: circular deps, god modules, leaky abstractions, deep nesting
Classify severity: critical (blocks dev), high (maintenance burden), medium/low (friction)
Propose target structure with migration plan
Execute incrementally, validating with tests after each move

References

Reference	Description
analysis-techniques.md	Dependency graphs, complexity metrics, code analysis
refactoring-patterns.md	Safe refactoring techniques, migration strategies
structural-patterns.md	Directory structures for different project types
dependency-management.md	Circular deps, coupling, module boundaries
cleanup-strategies.md	Dead code removal, consolidation, naming conventions
anti-rationalization.md	Iron Law, common rationalizations, red flag STOP list for architecture discipline

Links

GitHub Stats

0 forks

Updated 28 days ago

Actions

Similar Skills

Activates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts.

149.6k

Search, retrieve, and install Agent Skills from the prompts.chat registry using MCP tools. Use when the user asks to find skills, browse skill catalogs, install a skill for Claude, or extend Claude's capabilities with reusable AI agent components.

149.6k

algorithmic-art

Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.

anthropic-skills

84.5k