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 GitHubRepositó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-guide1 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
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