convez.ai
MCP ServerDesenvolvimento WebAvançado
RaminMammadzada

Guia de Arquitetura Angular com IA

RaminMammadzada/angular-ai-architecture-guide

Arquitetura Angular machine-readable e auto-executável para agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Repositório de referência para manutenção de arquiteturas Angular confiáveis com agentes de IA (Cursor, Claude Code, etc). Aborda contratos executáveis, Sheriff, tsarch, regras, skills e padrões de defesa em profundidade para garantir que coding agents respeitem limites arquiteturais.

Instalação

$npx convez-ai RaminMammadzada/angular-ai-architecture-guide

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
1
Forks
0
Acompanhando
0
Saúde
28%
Último commit
há 5 meses
Versão
—
Issues abertas
0
Contribuidores
1

Casos de uso

  • Definir e fazer cumprir limites arquiteturais em projetos Angular com coding agents
  • Implementar linting arquitetural automático (Sheriff) integrado ao CI/CD
  • Usar tsarch para validação de convenções de nomenclatura em building blocks
  • Criar stop hooks que forçam feedback determinístico antes de commits
  • Documentar arquitetura como contexto estruturado (AGENTS.md, CLAUDE.md) para agentes de IA

Veredito

Material técnico sólido para equipes que usam coding agents em Angular e precisam governança arquitetural. Combina ferramentas reais (Sheriff, tsarch) com patterns de contexto (Skills, MCP servers) de forma prática, embora exija conhecimento avançado de Angular e CI/CD para implementar.

README

A tradução para o português deste README ainda está na fila.

AI-Assisted Angular Architecture

A detailed reference guide based on Manfred Steyer's two-part blog series on maintaining reliable Angular architectures with AI coding agents.

Series: "AI-assisted Angular Architecture" — Angular Architects (June 2026)


Posts

Post 1: Architecture as an Executable Contract

How to make architecture guardrails machine-readable and self-enforcing for AI coding agents.

Key topics:

  • Target architecture: Domains × Layers matrix
  • Feature Slicing — locality and refactoring
  • Sheriff — linting architecture boundaries
  • Rules (AGENTS.md, cursor.mdc, CLAUDE.md) — providing context
  • Skills & MCP servers — task-specific knowledge on demand
  • Stop hooks — deterministic feedback loop (Sheriff + lint + tests + build)
  • Single source of truth across Cursor AI, Claude Code, Codex, Antigravity
  • AI in action: generating and refactoring features

Diagrams (9): Architecture matrix, Feature Slicing, Sheriff output, Context loading strategy, 5 architecture evolution steps


Post 2: Architecture Beyond Layers — tsarch for AI Agents

Extending the guardrails with naming-convention-based architecture rules via tsarch.

Key topics:

  • Building blocks beyond layers (Smart Component → Store → Client)
  • The Coordinator pattern for multi-store orchestration
  • File suffix conventions for building block recognition
  • tsarch setup (Compiler API, Vitest, tsconfig)
  • Four executable architecture rules (with full code)
  • Wiring tsarch into the Stop hook feedback loop
  • Proactive vs reactive protection (Rules vs Stop hook)
  • verify-and-fix Skill for on-demand full checks
  • Trade-offs and limits of convention-based rules

Diagrams (4): Building block access flows, proactive violation detection, reactive Stop hook catch, propose-and-confirm fix


The Complete Architecture at a Glance

┌──────────────────────────────────────────────────────────────┐
│                    AI Coding Agent                            │
│  (Cursor AI · Claude Code · Codex · Antigravity · ...)       │
├──────────────────────────────────────────────────────────────┤
│  Context Layer                                                │
│  ┌──────────┐  ┌──────────┐  ┌──────────┐                   │
│  │  Rules    │  │  Skills  │  │   MCP    │                   │
│  │ AGENTS.md │  │ task-    │  │ servers  │                   │
│  │ CLAUDE.md │  │ specific │  │ Angular  │                   │
│  │ cursor.mdc│  │ workflows│  │ CLI      │                   │
│  └──────────┘  └──────────┘  └──────────┘                   │
├──────────────────────────────────────────────────────────────┤
│  Enforcement Layer                                            │
│  ┌──────────────────────────────────────────────────────┐    │
│  │  Stop Hook (ci-checks.mjs)                            │    │
│  │  ┌──────────┐  ┌──────────┐  ┌──────────┐           │    │
│  │  │  Sheriff  │  │  tsarch  │  │  Tests + │           │    │
│  │  │  domains  │  │ naming   │  │  Build   │           │    │
│  │  │  layers   │  │ building │  │          │           │    │
│  │  │          │  │  blocks  │  │          │           │    │
│  │  └──────────┘  └──────────┘  └──────────┘           │    │
│  │        ↓ violation → feedback → agent self-corrects  │    │
│  └──────────────────────────────────────────────────────┘    │
├──────────────────────────────────────────────────────────────┤
│  Single Source of Truth                                       │
│  docs/architecture-boundaries.md · docs/architecture-         │
│  state-management.md · ADRs → sync scripts → all agents      │
└──────────────────────────────────────────────────────────────┘

Source

  • Blog: angulararchitects.io
  • Author: Manfred Steyer
  • Source code: GitHub (Branch: ai-arc)
  • Workshop: Angular Architecture Workshop: AI & Signals
Ver o original no GitHub

Bom para

Relacionados