GitHub - andonimichael/arxitect: Agentic coding plugin that enforces best-practice software design & architecture.

Arxitect is an agentic coding plugin that enforces best-practice software design & architecture. It adds implementation agents and architecture reviewers to your client that enforce API Design, Object-Oriented Design, and Clean Architecture standards.

Coding agents often burn context, waste tokens, implement partial solutions, or miss major components of coding tasks because they naturally implement repetitive, brittle, and tactical code. Software design principles weren't meant to be just for humans. They were meant to make all code easier and safer to read, understand, refactor, modify, extend, test, and maintain. Arxitect helps coding agents build robust software through best practice design and architecture. It helps coding agents write better code. And in turn, coding agents become more efficient and more accurate.

Background

Arxitect was influenced by the design of Superpowers. Arxitect extends Superpower's concept of improving agents at implementing coding tasks to improving agents at broader code architecture and software design.

Modern coding agents are getting exceptionally good at implementing a given coding task. And with validation-in-the-loop, you can be reasonably confident they will implement a correct solution. However, their implementation often leaves a lot to be desired, Most notably it doesn't adhere to the decades of software design best-practices that the community has established and is often myopic to broader software quality attributes including maintainability and extensibility. To make things worse, this low code quality compounds as coding agents implement additional tasks.

Software design principles weren't established specifically to help humans. They were designed to make code easier to read, understand, refactor, modify, extend, test, and maintain. They proactively mitigate the risk of bugs. They reduce the surface area for changes. They minimize the amount of information needed to grok the code. All of these are just as important for agents. They reduce the amount of context needed to understand the code and make changes. They reduce the chance of bugs and improve testing efficacy. And they make agents more effective at implementing feature requests.

How it works

Arxitect provides sub-agents and skills that can implement features and review code against established design principles. These will automatically trigger when the Client determines architecture review is important for the requested changes or are relevant for the input prompt. Three specialized reviewers will examine your code from different angles:

• An API Design Reviewer assesses naming conventions, method signatures, parameter design, type safety, and REST endpoint design.
• An Object Oriented Design Reviewer checks SOLID principles, DRY violations, composition vs. inheritance choices, and design pattern applicability.
• A Clean Architecture Reviewer evaluates component cohesion (REP, CRP, CCP), component coupling (ADP, SDP, SAP), and quality attributes like maintainability and testability.

What it contains

Arxitect contains the following agents:

• @architect that will plan and implement your change using best practices.
• @architecture-review that will review your code for adherence to best practices.

And it contains the following skills:

• /architect that will plan and implement your change using best practices.
• /architecture-review that will review your code for adherence to best practices.
• /api-design-review that will audit your code for adherence to api design principles.
• /oo-design-review that will audit your code for adherence to object oriented design principles.
• /clean-architecture-review that will audit your code for adherence to clean architecture principles.
• /using-arxitect the bootstrap skill that teaches your client how and when to use Arxitect

Installation

Claude Code (via Plugin Marketplace)

In Claude Code, register the marketplace first:

/plugin marketplace add andonimichael/arxitect

Then install the plugin:

/plugin install arxitect@arxitect

Finally reload your plugins to pick up Arxitect in the current session:

Tip: To automatically keep plugins up-to-date, open /plugin, go to Marketplaces, select arxitect, and choose Enable auto-update. Claude Code will automatically refresh the marketplace and plugins at startup.

Cursor

Clone the repository into Cursor's local plugin directory:

git clone https://github.com/andonimichael/arxitect.git ~/.cursor/plugins/local/arxitect

Then restart Cursor or run Developer: Reload Window.

Codex

Clone the repository into Codex:

git clone https://github.com/andonimichael/arxitect.git ~/.codex/arxitect

Then symlink the skills into Codex's agent skills directory:

ln -s ~/.codex/arxitect/skills ~/.agents/skills/arxitect

Finally, restart Codex to pick up the new skills.

Gemini CLI

gemini extensions install https://github.com/andonimichael/arxitect

Verify Installation

Ask your client about Arxitect or ask your agent to review your code's architecture. It should automatically invoke the relevant Arxitect skill.

Common Use Patterns

1. Run an architecture review for the module x/
2. Design and implement a new feature Y.
3. Please review your changes for software design principles.
4. Does class Z follow good object oriented design?
5. Build me new API routes for class Z.