Gentleman-Programming/gentleman-architecture-agents

133 stars · Last commit 2025-09-04

🏗️ Claude Code agents that enforce the Scope Rule architectural pattern for Angular, Next.js & Astro - Battle-tested patterns from Google Developer Expert & Microsoft MVP

README preview

# Claude Code Scope Rule Architects 🏗️

[![Open Source](https://img.shields.io/badge/Open%20Source-Yes-green.svg)](https://github.com/alanbuscaglia/claude-agents)
[![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
[![Contributions Welcome](https://img.shields.io/badge/Contributions-Welcome-brightgreen.svg)](CONTRIBUTING.md)

> **English** | [Español](#español)

A collection of specialized Claude Code agents that enforce the **Scope Rule** architectural pattern across different frontend frameworks. These agents help developers make consistent architectural decisions and maintain clean, scalable codebases.

## 🎯 What is the Scope Rule?

The Scope Rule is a fundamental architectural principle that determines code placement based on usage scope:

**"Scope determines structure"**

- **Code used by 2+ features** → MUST go in global/shared directories
- **Code used by 1 feature** → MUST stay local in that feature
- **NO EXCEPTIONS** - This rule is absolute and non-negotiable

View full repository on GitHub →