Works with the AI tools you already use

    CClaude CodeCCursorCCodex CLIGGitHub CopilotGGemini CLIVVS CodeWWindsurf+15 more

    Codebase Architecture Improver

    by Arnstein Larsen

    1

    Systematically refactor large codebases, eliminate circular dependencies, and define clean module boundaries.

    Secure checkout via Stripe

    0 installsSecurity scanned

    See it in action

    You say

    Assess our Node.js monorepo's architecture; we're seeing circular dependencies and long build times in the 'services' folder. Propose a plan to decouple them.

    Your agent does

    Architectural Audit & Refactor Plan

    1. Dependency Mapping: Identified 4 circular imports between UserSvc and BillingSvc. 2. Layering Violation: DatabaseModel is leaking into the View layer. 3. Refactor Sequence:

    • Move Shared DTOs to /libs/contracts.
    • Extract common logic to Auth-Base mixin.
    • Implement Dependency Injection for Logger.

    What you get

    Identify and eliminate circular dependencies in complex repositories.Decompose "God Objects" into maintainable, single-responsibility modules.Establish strict layering rules to prevent technical debt accumulation.Create an incremental refactoring sequence to avoid high-risk rewrites.Audit module boundaries to improve testability and reduce build times.

    About this skill

    What it does

    This skill transforms sprawling, "organically grown" repositories into logically structured architectures without the high risk of a full rewrite. It identifies the root causes of technical debt—such as circular dependencies, layering violations, and god objects—and provides a systematic, step-by-step roadmap to fix them.

    Why use this skill

    Unlike generic AI prompting, the Codebase Architect uses a specific diagnostic methodology: it triages pain points, maps actual dependency directions, and identifies "seams" for decoupled testing. It doesn't just suggest clean code; it sequences refactoring steps to ensure the codebase remains functional throughout the transition. It is specifically designed to help developers who are inheriting legacy systems or scaling a startup MVP into a maintainable enterprise application.

    Supported Tools & Frameworks

    The skill is language-agnostic but excels with modular frameworks in TypeScript/JavaScript, Python, Go, and Java. It produces outputs tailored to your workflow, whether you need a high-level executive audit, a technical refactoring sequence, or team-wide architectural conventions.

    The Result

    You receive a concrete dependency map, a list of boundary violations, and a prioritized sequence of "micro-updates" that incrementally improve the system's modularity and reduce change-cost.

    How to install

    Drop the file into your AI Agent. Works with Claude, Cursor, ChatGPT, and 20+ more.

    Reviews

    No reviews yet

    Be one of the first to try it. Every listed skill passes our trust checks below.

    Security scanned

    Passed our 8-point scan before listing

    Fresh listing

    Recently published to Agensi

    30-day refund

    Not a fit? Get your money back

    Trust & safety

    Security scanned

    Verified clean 29 days ago

    Listed1 month ago
    Updated29 days ago

    Creator

    Frequently Asked Questions

    Popular in Code Review