convez.ai
AgenteDevOps & InfraestruturaIntermediário
archgate

Archgate CLI

archgate/cli

ADRs executáveis: encode decisões arquitetônicas como guardrails para código e agentes IA

Ver no GitHub
BomPluginScore · de 0 a 100

Transforma Arquitetura Decision Records (ADRs) em regras executáveis que garantem conformidade arquitetônica no código e no trabalho de agentes IA. Funciona como um linter para decisões de arquitetura, bloqueando violações em CI/CD, pre-commit hooks e diretamente em IDEs via plugins.

Instalação

$npx convez-ai archgate/cli

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
74
Forks
6
Acompanhando
0
Saúde
75%
Último commit
há 3 dias
Versão
v0.61.0
Issues abertas
7
Contribuidores
4

Casos de uso

  • Enforçar padrões arquitetônicos em equipes que usam agentes IA
  • Documentar e validar decisões de arquitetura no ciclo de desenvolvimento
  • Bloquear código que viola regras de convenção em CI/CD automaticamente
  • Integrar conformidade arquitetônica em editores (Claude Code, Cursor, VS Code)

Veredito

Ferramenta bem estruturada para governança técnica em equipes que trabalham com IA. Combina documentação (ADRs) com enforcement automático; o suporte a agentes IA é um diferencial real, mas a curva de aprendizado das regras TypeScript é moderada.

README

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

Archgate

Enterprise-grade linting and guardrails for AI work.

License: Apache-2.0 Release Docs OpenSSF Best Practices


AI agents write code fast, but they don't know your rules. Archgate turns your team's decisions into executable checks: a lint step for architecture, conventions, and AI output. Your agents read the rules before writing code, and archgate check blocks what slips through. In CI, in pre-commit hooks, and inside every major AI coding tool.

Write an ADR once. Enforce it everywhere.

How it works

Archgate has two layers:

  1. ADRs as documents: markdown files with YAML frontmatter stored in .archgate/adrs/. Each ADR records a decision: what was decided, why, and what to do and not do.
  2. ADRs as rules: each ADR can have a companion .rules.ts file that exports automated checks. Archgate runs these checks against your codebase and reports violations.
.archgate/
└── adrs/
    ├── ARCH-001-command-structure.md          # human-readable decision
    ├── ARCH-001-command-structure.rules.ts    # machine-executable checks
    ├── ARCH-002-error-handling.md
    └── ARCH-002-error-handling.rules.ts

When a rule is violated, archgate check reports the file, line, and which ADR was broken. Exit code 1 means violations. Wire it into CI and it blocks merges automatically.

The CLI is free and open source. Writing ADRs, enforcing rules, running checks in CI, and wiring up pre-commit hooks all work without an account or subscription.

Installation

Install via standalone script, npm, pip, dotnet, Go, gem, Maven, or proto. See the installation guide for all options and platform support.

Quick start

# 1. Initialize governance in your project
cd my-project
archgate init

# 2. Edit the generated ADR to document a real decision
# .archgate/adrs/ARCH-001-*.md

# 3. Add a companion .rules.ts to enforce it automatically
# .archgate/adrs/ARCH-001-*.rules.ts

# 4. Run checks
archgate check

Writing rules

Each ADR can have a companion .rules.ts file that exports automated checks. See the writing rules guide for examples and the full rule API reference.

Supercharge with AI plugins

Make your AI agent architecture-aware. With the optional editor plugins, your AI coding agent reads ADRs before writing code, validates changes against your rules, and captures new architectural patterns back into ADRs, automatically.

Plugins are available for Claude Code and Cursor.

archgate login             # one-time GitHub auth
archgate init              # installs the plugin automatically

Get started with plugins. The CLI works fully without them, but plugins close the loop between decisions and code.

Documentation

Full documentation is available at cli.archgate.dev, including guides for writing ADRs, writing rules, CI integration, editor plugin setup, and the complete CLI reference.

Contributing

See CONTRIBUTING.md for development setup and workflow.

License

Apache-2.0

Ver o original no GitHub

Bom para

Relacionados