{
  "markdown": "# Code Architecture Review\n\nA Claude Code plugin that audits your codebase for architectural issues, code smells, SOLID violations, and file structure problems — then hands you a prioritized, actionable report.\n\n## What it checks\n\n**Clean Architecture layers** — verifies the dependency rule (outer layers may depend on inner, never the reverse), flags business logic leaking into controllers or DB layer bleeding into domain code.\n\n**SOLID principles** — scans for Single Responsibility violations (classes doing too many things), Open/Closed failures (if-else chains that grow with every new type), missing dependency inversion (concrete classes hardcoded instead of injected), and more.\n\n**Code smells** — covers all 22 smells from Fowler's catalog, grouped by category: Bloaters (God Class, Long Method, Primitive Obsession), Change Preventers (Shotgun Surgery, Divergent Change), Couplers (Feature Envy, Message Chains), and Dispensables (Dead Code, Duplicate Code). Each finding includes the file, the smell name, severity, and the specific refactoring move.\n\n**File & folder structure** — checks for feature-based vs type-based organization, circular dependencies, missing public API boundaries (index files), test colocation, and stack-specific best practices for Node.js, Python/Django/FastAPI, React/Next.js, Go, and monorepos.\n\n## Usage\n\nOnce installed, trigger the skill naturally:\n\n```\nreview my code architecture\ncheck this project for code smells\nis my folder structure following best practices?\naudit my codebase\ndoes this follow clean architecture?\n```\n\nClaude will scan the project, run the bundled directory scanner, and return a structured report:\n\n```\n# Architecture Review — [Project Name]\n\n## TL;DR\n## Architecture Score  (✅ / ⚠️ / ❌ per dimension)\n## Critical Issues     (fix now)\n## Warnings            (fix soon)\n## Suggestions         (nice to have)\n## What's Working Well\n## Next Steps\n```\n\n## Installation\n\n### From the official marketplace\n\n```\n/plugin install code-architecture-review@claude-plugins-official\n```\n\n### From this repository\n\n```\n/plugin marketplace add zahra-farjmand/code-architecture-review\n/plugin install code-architecture-review@zahra-farjmand-code-architecture-review\n```\n\n### Local (for development / testing)\n\n```\nclaude --plugin-dir ./code-arch-plugin\n```\n\n## What's inside\n\n```\ncode-arch-plugin/\n├── .claude-plugin/\n│   └── plugin.json                        ← plugin metadata\n├── skills/\n│   └── code-architecture-review/\n│       ├── SKILL.md                       ← 6-step review process\n│       ├── references/\n│       │   ├── clean-architecture.md      ← layer guide + checklist\n│       │   ├── code-smells.md             ← 22-smell catalog with severity\n│       │   └── file-structure-patterns.md ← patterns for 5 stacks\n│       └── scripts/\n│           └── scan_structure.sh          ← directory + file size scanner\n└── README.md\n```\n\n## Supported stacks\n\nNode.js / Express, Python (FastAPI, Django), React / Next.js (incl. Feature-Sliced Design), Go, and monorepos (Turborepo, Nx, pnpm workspaces).\n\n## Contributing\n\nIssues and PRs welcome at [github.com/Farjmand/code-architecture-review](https://github.com/Farjmand/code-architecture-review).\n\n## License\n\nMIT\n",
  "bytes": 3225,
  "sha": "56aadef7e44c4c22e4035063c871b58c07e45dca8aa3cd96c007d9479ab904ea",
  "repo_slug": "farjmand/code-architecture-review",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_farjmand_code_architecture_review_code_a_317dcb8b/readme"
}