From 56fa1ff1341e0604fd9fa4cf394013a522d2a744 Mon Sep 17 00:00:00 2001 From: Rhuan Barreto Date: Thu, 11 Jun 2026 15:53:08 +0200 Subject: [PATCH 1/5] docs: align README and docs with linting-and-guardrails positioning Update all user-facing documentation to lead with "linting and guardrails" instead of "governance" or "ADRs as executable rules": - README tagline and opening paragraph - Docs site meta description, hero tagline, and card titles - JSON-LD structured data descriptions - OG image alt text and meta keywords - Editor plugin guide intros (Claude Code, Cursor, VS Code, Copilot, OpenCode) - Getting-started and CI integration pages ADRs and governance remain in explanatory body content. Only headline and intro language was updated. Signed-off-by: Rhuan Barreto --- README.md | 4 +-- docs/astro.config.mjs | 13 ++++--- docs/public/llms-full.txt | 34 +++++++++---------- .../docs/getting-started/installation.mdx | 4 +-- .../docs/getting-started/quick-start.mdx | 2 +- .../content/docs/guides/ci-integration.mdx | 2 +- .../docs/guides/claude-code-plugin.mdx | 6 ++-- .../docs/guides/copilot-cli-plugin.mdx | 6 ++-- .../docs/guides/cursor-integration.mdx | 8 ++--- .../docs/guides/opencode-integration.mdx | 6 ++-- .../src/content/docs/guides/vscode-plugin.mdx | 8 ++--- docs/src/content/docs/index.mdx | 10 +++--- 12 files changed, 51 insertions(+), 52 deletions(-) diff --git a/README.md b/README.md index 2ae22f88..d019d1cc 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@
-**Enforce Architecture Decision Records as executable rules — for both humans and AI agents.** +**Enterprise-grade linting and guardrails for AI work.** [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE.md) [![Release](https://github.com/archgate/cli/actions/workflows/release.yml/badge.svg)](https://github.com/archgate/cli/actions/workflows/release.yml) @@ -13,7 +13,7 @@ --- -Archgate turns your Architecture Decision Records into a governance layer that runs in CI, enforces rules in pre-commit hooks, and feeds live context to AI coding agents — so architectural decisions don't stay in documents, they stay in the code. +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.** diff --git a/docs/astro.config.mjs b/docs/astro.config.mjs index 653e62a5..5a8fa098 100644 --- a/docs/astro.config.mjs +++ b/docs/astro.config.mjs @@ -14,8 +14,7 @@ export default defineConfig({ "pt-br": { label: "Português (Brasil)", lang: "pt-BR" }, nb: { label: "Norsk (Bokmål)", lang: "nb" }, }, - description: - "Enforce Architecture Decision Records as executable rules — for both humans and AI agents.", + description: "Enterprise-grade linting and guardrails for AI work.", customCss: ["./src/styles/custom.css"], expressiveCode: { // Use the pure-JS regex engine instead of the WASM-based oniguruma @@ -133,7 +132,7 @@ export default defineConfig({ attrs: { property: "og:image:alt", content: - "Archgate — Architecture Decision Records as Executable Rules", + "Archgate — Enterprise-grade linting and guardrails for AI work", }, }, // ── Twitter / X card ────────────────────────────────────── @@ -156,7 +155,7 @@ export default defineConfig({ attrs: { name: "keywords", content: - "archgate, architecture decision records, ADR, executable rules, code governance, AI governance, TypeScript rules, CLI, compliance automation", + "archgate, linting, guardrails, AI coding, architecture decision records, ADR, executable rules, TypeScript rules, CLI, compliance automation", }, }, // ── JSON-LD: WebSite ────────────────────────────────────── @@ -169,7 +168,7 @@ export default defineConfig({ name: "Archgate CLI Documentation", url: "https://cli.archgate.dev", description: - "Documentation for Archgate — enforce Architecture Decision Records as executable TypeScript rules for automated code governance.", + "Documentation for Archgate — enterprise-grade linting and guardrails for AI work.", inLanguage: ["en", "pt-BR", "nb"], }), }, @@ -182,7 +181,7 @@ export default defineConfig({ "@type": "SoftwareApplication", name: "Archgate CLI", applicationCategory: "DeveloperApplication", - applicationSubCategory: "Code Governance", + applicationSubCategory: "Code Linting", operatingSystem: "macOS, Linux, Windows", softwareVersion: "0.45.2", license: "https://github.com/archgate/cli/blob/main/LICENSE", @@ -190,7 +189,7 @@ export default defineConfig({ url: "https://cli.archgate.dev", downloadUrl: "https://www.npmjs.com/package/archgate", description: - "CLI tool that enforces Architecture Decision Records (ADRs) as executable TypeScript rules for automated code governance.", + "Enterprise-grade linting and guardrails for AI work. Enforce your team's architecture decisions as executable TypeScript rules.", author: { "@type": "Organization", name: "Archgate", diff --git a/docs/public/llms-full.txt b/docs/public/llms-full.txt index 9db1a34c..66a20c1d 100644 --- a/docs/public/llms-full.txt +++ b/docs/public/llms-full.txt @@ -92,7 +92,7 @@ When you run `archgate check`, the CLI loads every ADR that has `rules: true` in ## Editor plugins -The Archgate CLI works standalone, but **editor plugins** unlock a full AI governance workflow. Plugins give AI agents role-based skills so they read your ADRs before coding, validate after, and capture new patterns for your team -- automatically. +The Archgate CLI works standalone, but **editor plugins** unlock a full AI guardrails workflow. Plugins give AI agents role-based skills so they read your ADRs before coding, validate after, and capture new patterns for your team -- automatically. The Claude Code plugin adds five skills: developer, architect, @@ -101,7 +101,7 @@ The Archgate CLI works standalone, but **editor plugins** unlock a full AI gover The Cursor plugin provides pre-built agent rules and skills that give - Cursor's AI agent the same governance workflow as Claude Code. + Cursor's AI agent the same guardrails workflow as Claude Code. Editor plugins are currently in beta. Run `archgate login` to sign up and authenticate, then `archgate init --install-plugin` to set up the plugin. @@ -323,9 +323,9 @@ If you prefer `npm install -g archgate` instead of the proto plugin, you need to ## Next steps -Once installed, run `archgate init` in your project to set up governance. See the [Quick Start](/getting-started/quick-start/) guide for a walkthrough. +Once installed, run `archgate init` in your project to set up linting and guardrails. See the [Quick Start](/getting-started/quick-start/) guide for a walkthrough. -Want your AI agent to read ADRs before coding and validate after? The editor plugins for [Claude Code](/guides/claude-code-plugin/) and [Cursor](/guides/cursor-integration/) add a full governance workflow on top of the CLI. Run `archgate login` to sign up and get started. +Want your AI agent to read ADRs before coding and validate after? The editor plugins for [Claude Code](/guides/claude-code-plugin/) and [Cursor](/guides/cursor-integration/) add a full guardrails workflow on top of the CLI. Run `archgate login` to sign up and get started. --- @@ -468,7 +468,7 @@ Now that you have a working setup, dive deeper: - [CI Integration](/guides/ci-integration/) — Wire `archgate check` into GitHub Actions, GitLab CI, or any pipeline. - [Pre-commit Hooks](/guides/pre-commit-hooks/) — Run checks locally before every commit. -- [Claude Code Plugin](/guides/claude-code-plugin/) — Give AI agents a full governance workflow with role-based skills. +- [Claude Code Plugin](/guides/claude-code-plugin/) — Give AI agents architecture-aware guardrails with role-based skills. - [Cursor Integration](/guides/cursor-integration/) — Use Archgate with Cursor IDE for AI-assisted development. Want AI agents that automatically read your ADRs before coding? Run `archgate login` to sign up and authenticate, then run `archgate init --install-plugin` to set up the plugin. @@ -1257,11 +1257,11 @@ CI catches violations at merge time. Editor plugins catch them at coding time. W Source: https://cli.archgate.dev/guides/claude-code-plugin/ -The Archgate Claude Code plugin gives AI agents working in [Claude Code](https://claude.ai/code) a structured governance workflow. Instead of relying on prompt instructions that drift over time, agents read your ADRs directly via Archgate CLI commands and validate their own code against your rules. +The Archgate Claude Code plugin gives AI agents working in [Claude Code](https://claude.ai/code) built-in guardrails. Instead of relying on prompt instructions that drift over time, agents read your ADRs directly via Archgate CLI commands and validate their own code against your rules. ## What the plugin provides -The plugin adds an agent and role-based skills to Claude Code. The agent orchestrates the governance workflow, invoking skills as needed -- read decisions before coding, validate after, and capture new patterns for the team. +The plugin adds an agent and role-based skills to Claude Code. The agent orchestrates the guardrails workflow, invoking skills as needed -- read decisions before coding, validate after, and capture new patterns for the team. ### Agent @@ -1410,7 +1410,7 @@ The `archgate:developer` agent orchestrates the skills automatically -- it invok Source: https://cli.archgate.dev/guides/copilot-cli-plugin/ -The Archgate Copilot CLI plugin gives AI agents working in [GitHub Copilot CLI](https://github.com/features/copilot) a structured governance workflow. Agents read your ADRs before writing code, validate after, and capture new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). +The Archgate Copilot CLI plugin gives AI agents working in [GitHub Copilot CLI](https://github.com/features/copilot) built-in guardrails. Agents read your ADRs before writing code, validate after, and capture new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). ## How it works @@ -1474,7 +1474,7 @@ You can find your authenticated URL by running `archgate plugin url copilot`. ## What the plugin provides -The plugin adds an agent and role-based skills to Copilot CLI. The agent orchestrates the governance workflow, invoking skills as needed. +The plugin adds an agent and role-based skills to Copilot CLI. The agent orchestrates the guardrails workflow, invoking skills as needed. ### Agent @@ -1539,7 +1539,7 @@ The agent invokes `archgate:quality-manager` to review the work and identify pat Source: https://cli.archgate.dev/guides/cursor-integration/ -Archgate integrates with [Cursor](https://cursor.com) to give AI agents a structured governance workflow. The agent reads your ADRs before writing code, validates after, and captures new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). +Archgate integrates with [Cursor](https://cursor.com) to give AI agents built-in guardrails. The agent reads your ADRs before writing code, validates after, and captures new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). ## Setup @@ -1551,7 +1551,7 @@ archgate init --editor cursor The Cursor plugin is currently in beta. Run `archgate login` to sign up and authenticate. -If you have logged in via `archgate login`, the init command also installs the Archgate plugin for Cursor. The plugin provides pre-built agents, skills, and hooks that give Cursor's AI agent a full governance workflow. +If you have logged in via `archgate login`, the init command also installs the Archgate plugin for Cursor. The plugin provides pre-built agents, skills, and hooks that give Cursor's AI agent a full guardrails workflow. The plugin is distributed as an authenticated tarball. The CLI downloads it and extracts skills, agents, and hooks into `~/.cursor/`. No CLI detection is needed -- files are written directly to the Cursor user directory. @@ -1579,7 +1579,7 @@ archgate plugin install --editor cursor | `~/.cursor/skills/archgate-adr-author.md` | Creates and edits ADRs following project conventions | | `~/.cursor/skills/archgate-onboard.md` | One-time setup: explores the codebase, interviews you, creates ADRs | | `~/.cursor/skills/archgate-cli-reference.md` | Internal reference for AI agents with the Archgate CLI guide | -| `~/.cursor/agents/archgate-developer.md` | Primary development agent with the full ADR governance workflow | +| `~/.cursor/agents/archgate-developer.md` | Primary development agent with the full ADR guardrails workflow | | `~/.cursor/agents/archgate-planner.md` | Planning agent for scoping and breaking down work | **Project scope**: @@ -1835,7 +1835,7 @@ This manifest lets you track provenance — where each imported ADR came from an Source: https://cli.archgate.dev/guides/opencode-integration/ -Archgate integrates with [opencode](https://opencode.ai) to give AI agents a structured governance workflow. The agent reads your ADRs before writing code, validates after, and captures new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). +Archgate integrates with [opencode](https://opencode.ai) to give AI agents built-in guardrails. The agent reads your ADRs before writing code, validates after, and captures new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). ## Setup @@ -1860,7 +1860,7 @@ opencode uses the XDG Base Directory convention on every platform (via the `xdg- The install step only runs when the `opencode` CLI is on your PATH. Archgate needs to confirm opencode is present before writing files into its user-scope config directory — otherwise the agents would sit in a location nothing reads. Install opencode from [opencode.ai](https://opencode.ai/docs/) first, then re-run `archgate init --editor opencode` or `archgate plugin install --editor opencode`. -If you have logged in via `archgate login` **and** `opencode` is on your PATH, the init command downloads and installs the Archgate agent bundle for opencode. The bundle provides a pre-built primary agent and four subagents that give opencode's AI a full governance workflow. +If you have logged in via `archgate login` **and** `opencode` is on your PATH, the init command downloads and installs the Archgate agent bundle for opencode. The bundle provides a pre-built primary agent and four subagents that give opencode's AI a full guardrails workflow. To explicitly install the agents: @@ -2211,7 +2211,7 @@ If you discover a security issue in Archgate, please report it responsibly by op Source: https://cli.archgate.dev/guides/vscode-plugin/ -The Archgate VS Code plugin gives AI agents working in [VS Code](https://code.visualstudio.com/) a structured governance workflow. Agents read your ADRs before writing code, validate after, and capture new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). +The Archgate VS Code plugin gives AI agents working in [VS Code](https://code.visualstudio.com/) built-in guardrails. Agents read your ADRs before writing code, validate after, and capture new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). ## How it works @@ -2245,7 +2245,7 @@ archgate init --editor vscode If you are already logged in, this command: -1. Creates the `.archgate/` governance directory (ADRs, lint rules) +1. Creates the `.archgate/` directory with ADRs and lint rules 2. Adds the authenticated marketplace URL to your VS Code **user settings** 3. Downloads and installs the Archgate VS Code extension (`.vsix`) if the `code` CLI is available @@ -2310,7 +2310,7 @@ Replace `` with your archgate token (retrieve it via `archgate plugin url ## What the plugin provides -The plugin adds an agent and role-based skills to VS Code's AI. The agent orchestrates the governance workflow, invoking skills as needed. +The plugin adds an agent and role-based skills to VS Code's AI. The agent orchestrates the guardrails workflow, invoking skills as needed. ### Agent diff --git a/docs/src/content/docs/getting-started/installation.mdx b/docs/src/content/docs/getting-started/installation.mdx index 2f6ae52e..1debc73b 100644 --- a/docs/src/content/docs/getting-started/installation.mdx +++ b/docs/src/content/docs/getting-started/installation.mdx @@ -214,8 +214,8 @@ If you prefer `npm install -g archgate` instead of the proto plugin, you need to ## Next steps -Once installed, run `archgate init` in your project to set up governance. See the [Quick Start](/getting-started/quick-start/) guide for a walkthrough. +Once installed, run `archgate init` in your project to set up linting and guardrails. See the [Quick Start](/getting-started/quick-start/) guide for a walkthrough. :::tip[Editor plugins (beta)] -Want your AI agent to read ADRs before coding and validate after? The editor plugins for [Claude Code](/guides/claude-code-plugin/) and [Cursor](/guides/cursor-integration/) add a full governance workflow on top of the CLI. Run `archgate login` to sign up and get started. +Want your AI agent to read ADRs before coding and validate after? The editor plugins for [Claude Code](/guides/claude-code-plugin/) and [Cursor](/guides/cursor-integration/) add a full guardrails workflow on top of the CLI. Run `archgate login` to sign up and get started. ::: diff --git a/docs/src/content/docs/getting-started/quick-start.mdx b/docs/src/content/docs/getting-started/quick-start.mdx index 7da41c0b..d9a7b216 100644 --- a/docs/src/content/docs/getting-started/quick-start.mdx +++ b/docs/src/content/docs/getting-started/quick-start.mdx @@ -138,7 +138,7 @@ Now that you have a working setup, dive deeper: - [CI Integration](/guides/ci-integration/) — Wire `archgate check` into GitHub Actions, GitLab CI, or any pipeline. - [Pre-commit Hooks](/guides/pre-commit-hooks/) — Run checks locally before every commit. -- [Claude Code Plugin](/guides/claude-code-plugin/) — Give AI agents a full governance workflow with role-based skills. +- [Claude Code Plugin](/guides/claude-code-plugin/) — Give AI agents architecture-aware guardrails with role-based skills. - [Cursor Integration](/guides/cursor-integration/) — Use Archgate with Cursor IDE for AI-assisted development. :::tip[Editor plugins (beta)] diff --git a/docs/src/content/docs/guides/ci-integration.mdx b/docs/src/content/docs/guides/ci-integration.mdx index 0fdf0fcc..4cf681d8 100644 --- a/docs/src/content/docs/guides/ci-integration.mdx +++ b/docs/src/content/docs/guides/ci-integration.mdx @@ -286,6 +286,6 @@ Use `--verbose` to see passing rules and timing information alongside failures. - run: archgate check --verbose ``` -:::tip[Add AI governance to your workflow] +:::tip[Add AI guardrails to your workflow] CI catches violations at merge time. Editor plugins catch them at coding time. With the [Claude Code](/guides/claude-code-plugin/) or [Cursor](/guides/cursor-integration/) plugin, your AI agent reads ADRs before writing code and validates compliance before you even commit. [Sign up for beta access](https://plugins.archgate.dev). ::: diff --git a/docs/src/content/docs/guides/claude-code-plugin.mdx b/docs/src/content/docs/guides/claude-code-plugin.mdx index 28ed70e0..68725e13 100644 --- a/docs/src/content/docs/guides/claude-code-plugin.mdx +++ b/docs/src/content/docs/guides/claude-code-plugin.mdx @@ -1,13 +1,13 @@ --- title: Claude Code Plugin -description: Set up the Archgate plugin for Claude Code. Give AI agents a governance workflow that reads ADRs, validates code, and captures architectural patterns. +description: Set up the Archgate plugin for Claude Code. Give AI agents guardrails that read ADRs, validate code, and capture architectural patterns. --- -The Archgate Claude Code plugin gives AI agents working in [Claude Code](https://claude.ai/code) a structured governance workflow. Instead of relying on prompt instructions that drift over time, agents read your ADRs directly via Archgate CLI commands and validate their own code against your rules. +The Archgate Claude Code plugin gives AI agents working in [Claude Code](https://claude.ai/code) built-in guardrails. Instead of relying on prompt instructions that drift over time, agents read your ADRs directly via Archgate CLI commands and validate their own code against your rules. ## What the plugin provides -The plugin adds an agent and role-based skills to Claude Code. The agent orchestrates the governance workflow, invoking skills as needed -- read decisions before coding, validate after, and capture new patterns for the team. +The plugin adds an agent and role-based skills to Claude Code. The agent orchestrates the guardrails workflow, invoking skills as needed -- read decisions before coding, validate after, and capture new patterns for the team. ### Agent diff --git a/docs/src/content/docs/guides/copilot-cli-plugin.mdx b/docs/src/content/docs/guides/copilot-cli-plugin.mdx index 932e62da..e815ef7d 100644 --- a/docs/src/content/docs/guides/copilot-cli-plugin.mdx +++ b/docs/src/content/docs/guides/copilot-cli-plugin.mdx @@ -1,9 +1,9 @@ --- title: Copilot CLI Plugin -description: Set up the Archgate plugin for GitHub Copilot CLI. Add architecture governance to Copilot with automated ADR compliance and rule enforcement. +description: Set up the Archgate plugin for GitHub Copilot CLI. Add architecture guardrails to Copilot with automated ADR compliance and rule enforcement. --- -The Archgate Copilot CLI plugin gives AI agents working in [GitHub Copilot CLI](https://github.com/features/copilot) a structured governance workflow. Agents read your ADRs before writing code, validate after, and capture new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). +The Archgate Copilot CLI plugin gives AI agents working in [GitHub Copilot CLI](https://github.com/features/copilot) built-in guardrails. Agents read your ADRs before writing code, validate after, and capture new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). ## How it works @@ -69,7 +69,7 @@ You can find your authenticated URL by running `archgate plugin url copilot`. ## What the plugin provides -The plugin adds an agent and role-based skills to Copilot CLI. The agent orchestrates the governance workflow, invoking skills as needed. +The plugin adds an agent and role-based skills to Copilot CLI. The agent orchestrates the guardrails workflow, invoking skills as needed. ### Agent diff --git a/docs/src/content/docs/guides/cursor-integration.mdx b/docs/src/content/docs/guides/cursor-integration.mdx index 02dc4489..6f6554c4 100644 --- a/docs/src/content/docs/guides/cursor-integration.mdx +++ b/docs/src/content/docs/guides/cursor-integration.mdx @@ -1,9 +1,9 @@ --- title: Cursor Integration -description: Integrate Archgate with Cursor for AI-assisted development with architecture governance. Configure agents, skills, and hooks for ADR compliance. +description: Integrate Archgate with Cursor for AI-assisted development with architecture guardrails. Configure agents, skills, and hooks for ADR compliance. --- -Archgate integrates with [Cursor](https://cursor.com) to give AI agents a structured governance workflow. The agent reads your ADRs before writing code, validates after, and captures new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). +Archgate integrates with [Cursor](https://cursor.com) to give AI agents built-in guardrails. The agent reads your ADRs before writing code, validates after, and captures new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). ## Setup @@ -17,7 +17,7 @@ archgate init --editor cursor The Cursor plugin is currently in beta. Run `archgate login` to sign up and authenticate. ::: -If you have logged in via `archgate login`, the init command also installs the Archgate plugin for Cursor. The plugin provides pre-built agents, skills, and hooks that give Cursor's AI agent a full governance workflow. +If you have logged in via `archgate login`, the init command also installs the Archgate plugin for Cursor. The plugin provides pre-built agents, skills, and hooks that give Cursor's AI agent a full guardrails workflow. The plugin is distributed as an authenticated tarball. The CLI downloads it and extracts skills, agents, and hooks into `~/.cursor/`. No CLI detection is needed -- files are written directly to the Cursor user directory. @@ -45,7 +45,7 @@ archgate plugin install --editor cursor | `~/.cursor/skills/archgate-adr-author.md` | Creates and edits ADRs following project conventions | | `~/.cursor/skills/archgate-onboard.md` | One-time setup: explores the codebase, interviews you, creates ADRs | | `~/.cursor/skills/archgate-cli-reference.md` | Internal reference for AI agents with the Archgate CLI guide | -| `~/.cursor/agents/archgate-developer.md` | Primary development agent with the full ADR governance workflow | +| `~/.cursor/agents/archgate-developer.md` | Primary development agent with the full ADR guardrails workflow | | `~/.cursor/agents/archgate-planner.md` | Planning agent for scoping and breaking down work | **Project scope**: diff --git a/docs/src/content/docs/guides/opencode-integration.mdx b/docs/src/content/docs/guides/opencode-integration.mdx index 2cc5f231..4ecd938a 100644 --- a/docs/src/content/docs/guides/opencode-integration.mdx +++ b/docs/src/content/docs/guides/opencode-integration.mdx @@ -1,9 +1,9 @@ --- title: opencode Integration -description: Integrate Archgate with opencode for AI-assisted development with architecture governance. Configure agents and subagents for ADR compliance. +description: Integrate Archgate with opencode for AI-assisted development with architecture guardrails. Configure agents and subagents for ADR compliance. --- -Archgate integrates with [opencode](https://opencode.ai) to give AI agents a structured governance workflow. The agent reads your ADRs before writing code, validates after, and captures new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). +Archgate integrates with [opencode](https://opencode.ai) to give AI agents built-in guardrails. The agent reads your ADRs before writing code, validates after, and captures new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). ## Setup @@ -32,7 +32,7 @@ opencode uses the XDG Base Directory convention on every platform (via the `xdg- The install step only runs when the `opencode` CLI is on your PATH. Archgate needs to confirm opencode is present before writing files into its user-scope config directory — otherwise the agents would sit in a location nothing reads. Install opencode from [opencode.ai](https://opencode.ai/docs/) first, then re-run `archgate init --editor opencode` or `archgate plugin install --editor opencode`. ::: -If you have logged in via `archgate login` **and** `opencode` is on your PATH, the init command downloads and installs the Archgate agent bundle for opencode. The bundle provides a pre-built primary agent and four subagents that give opencode's AI a full governance workflow. +If you have logged in via `archgate login` **and** `opencode` is on your PATH, the init command downloads and installs the Archgate agent bundle for opencode. The bundle provides a pre-built primary agent and four subagents that give opencode's AI a full guardrails workflow. To explicitly install the agents: diff --git a/docs/src/content/docs/guides/vscode-plugin.mdx b/docs/src/content/docs/guides/vscode-plugin.mdx index 13f1035a..72ac5027 100644 --- a/docs/src/content/docs/guides/vscode-plugin.mdx +++ b/docs/src/content/docs/guides/vscode-plugin.mdx @@ -1,9 +1,9 @@ --- title: VS Code Plugin -description: Install the Archgate VS Code extension for AI-assisted development with architecture governance. Real-time ADR compliance checking in your editor. +description: Install the Archgate VS Code extension for AI-assisted development with architecture guardrails. Real-time ADR compliance checking in your editor. --- -The Archgate VS Code plugin gives AI agents working in [VS Code](https://code.visualstudio.com/) a structured governance workflow. Agents read your ADRs before writing code, validate after, and capture new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). +The Archgate VS Code plugin gives AI agents working in [VS Code](https://code.visualstudio.com/) built-in guardrails. Agents read your ADRs before writing code, validate after, and capture new patterns for the team -- the same workflow available in the [Claude Code plugin](/guides/claude-code-plugin/). ## How it works @@ -41,7 +41,7 @@ archgate init --editor vscode If you are already logged in, this command: -1. Creates the `.archgate/` governance directory (ADRs, lint rules) +1. Creates the `.archgate/` directory with ADRs and lint rules 2. Adds the authenticated marketplace URL to your VS Code **user settings** 3. Downloads and installs the Archgate VS Code extension (`.vsix`) if the `code` CLI is available @@ -106,7 +106,7 @@ Replace `` with your archgate token (retrieve it via `archgate plugin url ## What the plugin provides -The plugin adds an agent and role-based skills to VS Code's AI. The agent orchestrates the governance workflow, invoking skills as needed. +The plugin adds an agent and role-based skills to VS Code's AI. The agent orchestrates the guardrails workflow, invoking skills as needed. ### Agent diff --git a/docs/src/content/docs/index.mdx b/docs/src/content/docs/index.mdx index c86b2ee6..80826749 100644 --- a/docs/src/content/docs/index.mdx +++ b/docs/src/content/docs/index.mdx @@ -1,9 +1,9 @@ --- title: Archgate -description: Archgate CLI enforces Architecture Decision Records (ADRs) as executable TypeScript rules. Automate code governance for humans and AI agents. +description: Enterprise-grade linting and guardrails for AI work. Turn your team's architectural decisions into executable checks that run in CI, pre-commit hooks, and inside AI coding tools. template: splash hero: - tagline: Write an ADR once. Enforce it everywhere. Feed it to AI agents automatically. + tagline: Enterprise-grade linting and guardrails for AI work. actions: - text: Get Started link: /getting-started/installation/ @@ -46,7 +46,7 @@ When you run `archgate check`, the CLI loads every ADR that has `rules: true` in rules are violated. Works with GitHub Actions, GitLab CI, or any CI system that respects exit codes. - + Editor plugins give AI agents direct access to your ADRs via CLI commands. They read decisions before writing code and validate after. No copy-pasting rules into prompts. @@ -61,7 +61,7 @@ When you run `archgate check`, the CLI loads every ADR that has `rules: true` in ## Editor plugins -The Archgate CLI works standalone, but **editor plugins** unlock a full AI governance workflow. Plugins give AI agents role-based skills so they read your ADRs before coding, validate after, and capture new patterns for your team -- automatically. +The Archgate CLI works standalone, but **editor plugins** unlock a full AI guardrails workflow. Plugins give AI agents role-based skills so they read your ADRs before coding, validate after, and capture new patterns for your team -- automatically. @@ -71,7 +71,7 @@ The Archgate CLI works standalone, but **editor plugins** unlock a full AI gover The Cursor plugin provides pre-built agent rules and skills that give - Cursor's AI agent the same governance workflow as Claude Code. + Cursor's AI agent the same guardrails workflow as Claude Code. From 781a393084ef27f572c2c964a1f79826aa1a1920 Mon Sep 17 00:00:00 2001 From: Rhuan Barreto Date: Thu, 11 Jun 2026 15:57:05 +0200 Subject: [PATCH 2/5] docs: sync shim READMEs with updated root README Signed-off-by: Rhuan Barreto --- shims/go/README.md | 4 ++-- shims/maven/README.md | 4 ++-- shims/nuget/Archgate.Tool/README.md | 4 ++-- shims/pypi/README.md | 4 ++-- shims/rubygem/README.md | 4 ++-- 5 files changed, 10 insertions(+), 10 deletions(-) diff --git a/shims/go/README.md b/shims/go/README.md index 2ae22f88..d019d1cc 100644 --- a/shims/go/README.md +++ b/shims/go/README.md @@ -2,7 +2,7 @@
-**Enforce Architecture Decision Records as executable rules — for both humans and AI agents.** +**Enterprise-grade linting and guardrails for AI work.** [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE.md) [![Release](https://github.com/archgate/cli/actions/workflows/release.yml/badge.svg)](https://github.com/archgate/cli/actions/workflows/release.yml) @@ -13,7 +13,7 @@ --- -Archgate turns your Architecture Decision Records into a governance layer that runs in CI, enforces rules in pre-commit hooks, and feeds live context to AI coding agents — so architectural decisions don't stay in documents, they stay in the code. +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.** diff --git a/shims/maven/README.md b/shims/maven/README.md index 2ae22f88..d019d1cc 100644 --- a/shims/maven/README.md +++ b/shims/maven/README.md @@ -2,7 +2,7 @@
-**Enforce Architecture Decision Records as executable rules — for both humans and AI agents.** +**Enterprise-grade linting and guardrails for AI work.** [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE.md) [![Release](https://github.com/archgate/cli/actions/workflows/release.yml/badge.svg)](https://github.com/archgate/cli/actions/workflows/release.yml) @@ -13,7 +13,7 @@ --- -Archgate turns your Architecture Decision Records into a governance layer that runs in CI, enforces rules in pre-commit hooks, and feeds live context to AI coding agents — so architectural decisions don't stay in documents, they stay in the code. +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.** diff --git a/shims/nuget/Archgate.Tool/README.md b/shims/nuget/Archgate.Tool/README.md index 2ae22f88..d019d1cc 100644 --- a/shims/nuget/Archgate.Tool/README.md +++ b/shims/nuget/Archgate.Tool/README.md @@ -2,7 +2,7 @@
-**Enforce Architecture Decision Records as executable rules — for both humans and AI agents.** +**Enterprise-grade linting and guardrails for AI work.** [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE.md) [![Release](https://github.com/archgate/cli/actions/workflows/release.yml/badge.svg)](https://github.com/archgate/cli/actions/workflows/release.yml) @@ -13,7 +13,7 @@ --- -Archgate turns your Architecture Decision Records into a governance layer that runs in CI, enforces rules in pre-commit hooks, and feeds live context to AI coding agents — so architectural decisions don't stay in documents, they stay in the code. +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.** diff --git a/shims/pypi/README.md b/shims/pypi/README.md index 2ae22f88..d019d1cc 100644 --- a/shims/pypi/README.md +++ b/shims/pypi/README.md @@ -2,7 +2,7 @@
-**Enforce Architecture Decision Records as executable rules — for both humans and AI agents.** +**Enterprise-grade linting and guardrails for AI work.** [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE.md) [![Release](https://github.com/archgate/cli/actions/workflows/release.yml/badge.svg)](https://github.com/archgate/cli/actions/workflows/release.yml) @@ -13,7 +13,7 @@ --- -Archgate turns your Architecture Decision Records into a governance layer that runs in CI, enforces rules in pre-commit hooks, and feeds live context to AI coding agents — so architectural decisions don't stay in documents, they stay in the code. +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.** diff --git a/shims/rubygem/README.md b/shims/rubygem/README.md index 2ae22f88..d019d1cc 100644 --- a/shims/rubygem/README.md +++ b/shims/rubygem/README.md @@ -2,7 +2,7 @@
-**Enforce Architecture Decision Records as executable rules — for both humans and AI agents.** +**Enterprise-grade linting and guardrails for AI work.** [![License: Apache-2.0](https://img.shields.io/badge/License-Apache--2.0-blue.svg)](LICENSE.md) [![Release](https://github.com/archgate/cli/actions/workflows/release.yml/badge.svg)](https://github.com/archgate/cli/actions/workflows/release.yml) @@ -13,7 +13,7 @@ --- -Archgate turns your Architecture Decision Records into a governance layer that runs in CI, enforces rules in pre-commit hooks, and feeds live context to AI coding agents — so architectural decisions don't stay in documents, they stay in the code. +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.** From a10f610f54721886df75cef0404513907a1bff2f Mon Sep 17 00:00:00 2001 From: Rhuan Barreto Date: Thu, 11 Jun 2026 16:13:20 +0200 Subject: [PATCH 3/5] docs: sync positioning update to pt-br and nb translations Apply the same linting-and-guardrails positioning to all translated docs pages: update descriptions, intros, card titles, and table entries from "governance/styring" to "guardrails" in both pt-BR and Norwegian. Signed-off-by: Rhuan Barreto --- .../docs/nb/guides/copilot-cli-plugin.mdx | 6 ++--- .../docs/nb/guides/cursor-integration.mdx | 8 +++---- .../docs/nb/guides/opencode-integration.mdx | 6 ++--- .../content/docs/nb/guides/vscode-plugin.mdx | 8 +++---- docs/src/content/docs/nb/index.mdx | 10 ++++---- .../docs/pt-br/guides/copilot-cli-plugin.mdx | 6 ++--- .../docs/pt-br/guides/cursor-integration.mdx | 24 +++++++++---------- .../pt-br/guides/opencode-integration.mdx | 6 ++--- .../docs/pt-br/guides/vscode-plugin.mdx | 8 +++---- docs/src/content/docs/pt-br/index.mdx | 12 +++++----- 10 files changed, 47 insertions(+), 47 deletions(-) diff --git a/docs/src/content/docs/nb/guides/copilot-cli-plugin.mdx b/docs/src/content/docs/nb/guides/copilot-cli-plugin.mdx index 980e47b3..aaaf7217 100644 --- a/docs/src/content/docs/nb/guides/copilot-cli-plugin.mdx +++ b/docs/src/content/docs/nb/guides/copilot-cli-plugin.mdx @@ -1,9 +1,9 @@ --- title: Copilot CLI-plugin -description: Sett opp Archgate-pluginet for GitHub Copilot CLI. Legg til arkitekturstyring i Copilot med automatisert ADR-samsvar og regelhåndhevning. +description: Sett opp Archgate-pluginet for GitHub Copilot CLI. Legg til arkitektur-guardrails i Copilot med automatisert ADR-samsvar og regelhåndhevning. --- -Archgate Copilot CLI-pluginet gir AI-agenter som jobber i [GitHub Copilot CLI](https://github.com/features/copilot) en strukturert styringsarbeidsflyt. Agenter leser ADR-ene dine før de skriver kode, validerer etterpå, og fanger opp nye mønstre for teamet -- den samme arbeidsflyten som er tilgjengelig i [Claude Code-pluginet](/guides/claude-code-plugin/). +Archgate Copilot CLI-pluginet gir AI-agenter som jobber i [GitHub Copilot CLI](https://github.com/features/copilot) innebygde guardrails. Agenter leser ADR-ene dine før de skriver kode, validerer etterpå, og fanger opp nye mønstre for teamet -- den samme arbeidsflyten som er tilgjengelig i [Claude Code-pluginet](/guides/claude-code-plugin/). ## Hvordan det fungerer @@ -69,7 +69,7 @@ Du kan finne den autentiserte URL-en din ved å kjøre `archgate plugin url copi ## Hva pluginet tilbyr -Pluginet legger til en agent og rollebaserte ferdigheter i Copilot CLI. Agenten orkestrerer styringsarbeidsflyten og aktiverer ferdigheter etter behov. +Pluginet legger til en agent og rollebaserte ferdigheter i Copilot CLI. Agenten orkestrerer guardrails-arbeidsflyten og aktiverer ferdigheter etter behov. ### Agent diff --git a/docs/src/content/docs/nb/guides/cursor-integration.mdx b/docs/src/content/docs/nb/guides/cursor-integration.mdx index 775415ad..c8dd76de 100644 --- a/docs/src/content/docs/nb/guides/cursor-integration.mdx +++ b/docs/src/content/docs/nb/guides/cursor-integration.mdx @@ -1,9 +1,9 @@ --- title: Cursor-integrasjon -description: Integrer Archgate med Cursor for AI-assistert utvikling med arkitekturstyring. Konfigurer agenter, skills og hooks for ADR-samsvar. +description: Integrer Archgate med Cursor for AI-assistert utvikling med arkitektur-guardrails. Konfigurer agenter, skills og hooks for ADR-samsvar. --- -Archgate integreres med [Cursor](https://cursor.com) for å gi AI-agenter en strukturert styringsarbeidsflyt. Agenten leser ADR-ene dine før den skriver kode, validerer etterpå, og fanger opp nye mønstre for teamet -- den samme arbeidsflyten som er tilgjengelig i [Claude Code-pluginet](/guides/claude-code-plugin/). +Archgate integreres med [Cursor](https://cursor.com) for å gi AI-agenter innebygde guardrails. Agenten leser ADR-ene dine før den skriver kode, validerer etterpå, og fanger opp nye mønstre for teamet -- den samme arbeidsflyten som er tilgjengelig i [Claude Code-pluginet](/guides/claude-code-plugin/). ## Oppsett @@ -17,7 +17,7 @@ archgate init --editor cursor Cursor-pluginet er for øyeblikket i beta. Kjør `archgate login` for å registrere deg og autentisere. ::: -Hvis du har logget inn via `archgate login`, installerer init-kommandoen også Archgate-pluginet for Cursor. Pluginet tilbyr ferdigbygde agenter, skills og hooks som gir Cursors AI-agent en komplett styringsarbeidsflyt. +Hvis du har logget inn via `archgate login`, installerer init-kommandoen også Archgate-pluginet for Cursor. Pluginet tilbyr ferdigbygde agenter, skills og hooks som gir Cursors AI-agent en komplett guardrails-arbeidsflyt. Pluginet distribueres som en autentisert tarball. CLI-en laster det ned og pakker ut skills, agenter og hooks i `~/.cursor/`. Ingen CLI-deteksjon er nødvendig -- filene skrives direkte til Cursor-brukerkatalogen. @@ -45,7 +45,7 @@ archgate plugin install --editor cursor | `~/.cursor/skills/archgate-adr-author.md` | Oppretter og redigerer ADR-er i henhold til prosjektets konvensjoner | | `~/.cursor/skills/archgate-onboard.md` | Engangsoppsett: utforsker kodebasen, intervjuer deg og oppretter ADR-er | | `~/.cursor/skills/archgate-cli-reference.md` | Intern referanse for AI-agenter med Archgate CLI-guiden | -| `~/.cursor/agents/archgate-developer.md` | Primær utviklingsagent med den komplette ADR-styringsarbeidsflyten | +| `~/.cursor/agents/archgate-developer.md` | Primær utviklingsagent med den komplette ADR-guardrails-arbeidsflyten | | `~/.cursor/agents/archgate-planner.md` | Planleggingsagent for scoping og oppdeling av arbeid | **Prosjektscope**: diff --git a/docs/src/content/docs/nb/guides/opencode-integration.mdx b/docs/src/content/docs/nb/guides/opencode-integration.mdx index 64d06eae..99c1d28a 100644 --- a/docs/src/content/docs/nb/guides/opencode-integration.mdx +++ b/docs/src/content/docs/nb/guides/opencode-integration.mdx @@ -1,9 +1,9 @@ --- title: opencode-integrasjon -description: Integrer Archgate med opencode for AI-assistert utvikling med arkitekturstyring. Konfigurer agenter og underagenter for ADR-samsvar. +description: Integrer Archgate med opencode for AI-assistert utvikling med arkitektur-guardrails. Konfigurer agenter og underagenter for ADR-samsvar. --- -Archgate integreres med [opencode](https://opencode.ai) for å gi AI-agenter en strukturert styringsarbeidsflyt. Agenten leser ADR-ene dine før den skriver kode, validerer etterpå, og fanger opp nye mønstre for teamet -- den samme arbeidsflyten som er tilgjengelig i [Claude Code-pluginet](/guides/claude-code-plugin/). +Archgate integreres med [opencode](https://opencode.ai) for å gi AI-agenter innebygde guardrails. Agenten leser ADR-ene dine før den skriver kode, validerer etterpå, og fanger opp nye mønstre for teamet -- den samme arbeidsflyten som er tilgjengelig i [Claude Code-pluginet](/guides/claude-code-plugin/). ## Oppsett @@ -32,7 +32,7 @@ opencode bruker XDG Base Directory-konvensjonen på alle plattformer (via `xdg-b Installasjonstrinnet kjører bare når `opencode`-CLI-en er på PATH. Archgate må bekrefte at opencode er tilstede før den skriver filer til brukernivåets konfigurasjonskatalog -- ellers ville agentene ligge på en plassering ingenting leser. Installer opencode fra [opencode.ai](https://opencode.ai/docs/) først, og kjør deretter `archgate init --editor opencode` eller `archgate plugin install --editor opencode` på nytt. ::: -Hvis du har logget inn via `archgate login` **og** `opencode` er på PATH, laster init-kommandoen ned og installerer Archgate-agentpakken for opencode. Pakken tilbyr en ferdigbygd primær agent og fire underagenter som gir opencode sin AI en komplett styringsarbeidsflyt. +Hvis du har logget inn via `archgate login` **og** `opencode` er på PATH, laster init-kommandoen ned og installerer Archgate-agentpakken for opencode. Pakken tilbyr en ferdigbygd primær agent og fire underagenter som gir opencode sin AI en komplett guardrails-arbeidsflyt. For å eksplisitt installere agentene: diff --git a/docs/src/content/docs/nb/guides/vscode-plugin.mdx b/docs/src/content/docs/nb/guides/vscode-plugin.mdx index 389fd41c..14c01f76 100644 --- a/docs/src/content/docs/nb/guides/vscode-plugin.mdx +++ b/docs/src/content/docs/nb/guides/vscode-plugin.mdx @@ -1,9 +1,9 @@ --- title: VS Code-plugin -description: Installer Archgate VS Code-utvidelsen for AI-assistert utvikling med arkitekturstyring. Sanntids ADR-samsvarskontroll i editoren din. +description: Installer Archgate VS Code-utvidelsen for AI-assistert utvikling med arkitektur-guardrails. Sanntids ADR-samsvarskontroll i editoren din. --- -Archgate VS Code-pluginet gir AI-agenter som jobber i [VS Code](https://code.visualstudio.com/) en strukturert styringsarbeidsflyt. Agenter leser ADR-ene dine før de skriver kode, validerer etterpå, og fanger opp nye mønstre for teamet -- den samme arbeidsflyten som er tilgjengelig i [Claude Code-pluginet](/guides/claude-code-plugin/). +Archgate VS Code-pluginet gir AI-agenter som jobber i [VS Code](https://code.visualstudio.com/) innebygde guardrails. Agenter leser ADR-ene dine før de skriver kode, validerer etterpå, og fanger opp nye mønstre for teamet -- den samme arbeidsflyten som er tilgjengelig i [Claude Code-pluginet](/guides/claude-code-plugin/). ## Hvordan det fungerer @@ -41,7 +41,7 @@ archgate init --editor vscode Hvis du allerede er logget inn, vil denne kommandoen: -1. Opprette `.archgate/`-styringsmappen (ADR-er, lint-regler) +1. Opprette `.archgate/`-mappen med ADR-er og lint-regler 2. Legge til den autentiserte markedsplassens URL i VS Code-**brukerinnstillingene** dine 3. Laste ned og installere Archgate VS Code-utvidelsen (`.vsix`) hvis `code`-CLI-en er tilgjengelig @@ -106,7 +106,7 @@ Erstatt `` med archgate-tokenet ditt (hent det via `archgate plugin url v ## Hva pluginet tilbyr -Pluginet legger til en agent og rollebaserte ferdigheter i VS Codes AI. Agenten orkestrerer styringsarbeidsflyten og aktiverer ferdigheter etter behov. +Pluginet legger til en agent og rollebaserte ferdigheter i VS Codes AI. Agenten orkestrerer guardrails-arbeidsflyten og aktiverer ferdigheter etter behov. ### Agent diff --git a/docs/src/content/docs/nb/index.mdx b/docs/src/content/docs/nb/index.mdx index a4ca1f18..da4dc9c3 100644 --- a/docs/src/content/docs/nb/index.mdx +++ b/docs/src/content/docs/nb/index.mdx @@ -1,9 +1,9 @@ --- title: Archgate -description: Archgate CLI håndhever Architecture Decision Records (ADR-er) som kjørbare TypeScript-regler. Automatiser kodestyring for mennesker og AI-agenter. +description: Linting og guardrails i bedriftsklasse for AI-arbeid. Gjør teamets arkitekturbeslutninger om til kjørbare kontroller som kjøres i CI, pre-commit hooks og inne i AI-kodingsverktøy. template: splash hero: - tagline: Skriv en ADR én gang. Håndhev den overalt. Gi den til AI-agenter automatisk. + tagline: Linting og guardrails i bedriftsklasse for AI-arbeid. actions: - text: Kom i gang link: /getting-started/installation/ @@ -46,7 +46,7 @@ Når du kjører `archgate check`, laster CLI-en inn hver ADR som har `rules: tru når regler brytes. Fungerer med GitHub Actions, GitLab CI eller ethvert CI-system som respekterer utgangskoder. - + Editorplugins gir AI-agenter direkte tilgang til ADR-ene dine via CLI-kommandoer. De leser beslutninger før de skriver kode, og validerer etterpå. Ingen kopiering og liming av regler i ledetekster. @@ -61,7 +61,7 @@ Når du kjører `archgate check`, laster CLI-en inn hver ADR som har `rules: tru ## Editorplugins -Archgate CLI fungerer frittstående, men **editorplugins** låser opp en fullstendig AI-styringsarbeidsflyt. Plugins gir AI-agenter rollebaserte ferdigheter slik at de leser ADR-ene dine før de koder, validerer etterpå og fanger opp nye mønstre for teamet ditt — automatisk. +Archgate CLI fungerer frittstående, men **editorplugins** låser opp en fullstendig AI-guardrails-arbeidsflyt. Plugins gir AI-agenter rollebaserte ferdigheter slik at de leser ADR-ene dine før de koder, validerer etterpå og fanger opp nye mønstre for teamet ditt — automatisk. @@ -71,7 +71,7 @@ Archgate CLI fungerer frittstående, men **editorplugins** låser opp en fullste Cursor-pluginen tilbyr ferdigbygde agentregler og ferdigheter som gir - Cursors AI-agent den samme styringsarbeidsflyten som Claude Code. + Cursors AI-agent den samme guardrails-arbeidsflyten som Claude Code. diff --git a/docs/src/content/docs/pt-br/guides/copilot-cli-plugin.mdx b/docs/src/content/docs/pt-br/guides/copilot-cli-plugin.mdx index 5bb7d33d..542aee27 100644 --- a/docs/src/content/docs/pt-br/guides/copilot-cli-plugin.mdx +++ b/docs/src/content/docs/pt-br/guides/copilot-cli-plugin.mdx @@ -1,9 +1,9 @@ --- title: Plugin para Copilot CLI -description: Configure o plugin Archgate para GitHub Copilot CLI. Adicione governança arquitetural ao Copilot com conformidade ADR automatizada e aplicação de regras. +description: Configure o plugin Archgate para GitHub Copilot CLI. Adicione guardrails arquiteturais ao Copilot com conformidade ADR automatizada e aplicação de regras. --- -O plugin Archgate para Copilot CLI oferece aos agentes de IA que trabalham no [GitHub Copilot CLI](https://github.com/features/copilot) um fluxo de governança estruturado. Os agentes leem seus ADRs antes de escrever código, validam depois e capturam novos padrões para a equipe -- o mesmo fluxo disponível no [plugin para Claude Code](/guides/claude-code-plugin/). +O plugin Archgate para Copilot CLI oferece aos agentes de IA que trabalham no [GitHub Copilot CLI](https://github.com/features/copilot) guardrails integrados. Os agentes leem seus ADRs antes de escrever código, validam depois e capturam novos padrões para a equipe -- o mesmo fluxo disponível no [plugin para Claude Code](/guides/claude-code-plugin/). ## Como funciona @@ -69,7 +69,7 @@ Você pode encontrar sua URL autenticada executando `archgate plugin url copilot ## O que o plugin oferece -O plugin adiciona um agente e skills baseadas em papéis ao Copilot CLI. O agente orquestra o fluxo de governança, invocando skills conforme necessário. +O plugin adiciona um agente e skills baseadas em papéis ao Copilot CLI. O agente orquestra o fluxo de guardrails, invocando skills conforme necessário. ### Agente diff --git a/docs/src/content/docs/pt-br/guides/cursor-integration.mdx b/docs/src/content/docs/pt-br/guides/cursor-integration.mdx index d2903430..127c0047 100644 --- a/docs/src/content/docs/pt-br/guides/cursor-integration.mdx +++ b/docs/src/content/docs/pt-br/guides/cursor-integration.mdx @@ -1,9 +1,9 @@ --- title: Integração com Cursor -description: Integre o Archgate com o Cursor para desenvolvimento assistido por IA com governança arquitetural. Configure agentes, skills e hooks para conformidade com ADRs. +description: Integre o Archgate com o Cursor para desenvolvimento assistido por IA com guardrails arquiteturais. Configure agentes, skills e hooks para conformidade com ADRs. --- -O Archgate se integra com o [Cursor](https://cursor.com) para oferecer aos agentes de IA um fluxo de governança estruturado. O agente lê seus ADRs antes de escrever código, valida depois e captura novos padrões para a equipe -- o mesmo fluxo disponível no [plugin para Claude Code](/guides/claude-code-plugin/). +O Archgate se integra com o [Cursor](https://cursor.com) para oferecer aos agentes de IA guardrails integrados. O agente lê seus ADRs antes de escrever código, valida depois e captura novos padrões para a equipe -- o mesmo fluxo disponível no [plugin para Claude Code](/guides/claude-code-plugin/). ## Configuração @@ -17,7 +17,7 @@ archgate init --editor cursor O plugin para Cursor está atualmente em beta. Execute `archgate login` para se cadastrar e autenticar. ::: -Se você fez login via `archgate login`, o comando init também instala o plugin Archgate para o Cursor. O plugin fornece agentes, skills e hooks pré-configurados que dão ao agente de IA do Cursor um fluxo de governança completo. +Se você fez login via `archgate login`, o comando init também instala o plugin Archgate para o Cursor. O plugin fornece agentes, skills e hooks pré-configurados que dão ao agente de IA do Cursor um fluxo completo de guardrails. O plugin é distribuído como um tarball autenticado. A CLI faz o download e extrai skills, agentes e hooks em `~/.cursor/`. Nenhuma detecção de CLI é necessária -- os arquivos são gravados diretamente no diretório de usuário do Cursor. @@ -38,15 +38,15 @@ archgate plugin install --editor cursor **Escopo de usuário** (`~/.cursor/`): -| Arquivo | Propósito | -| ---------------------------------------------- | ---------------------------------------------------------------------- | -| `~/.cursor/skills/archgate-reviewer.md` | Valida alterações de código contra todos os ADRs do projeto | -| `~/.cursor/skills/archgate-lessons-learned.md` | Captura aprendizados e propõe novos ADRs quando padrões emergem | -| `~/.cursor/skills/archgate-adr-author.md` | Cria e edita ADRs seguindo as convenções do projeto | -| `~/.cursor/skills/archgate-onboard.md` | Configuração única: explora o codebase, entrevista você e cria ADRs | -| `~/.cursor/skills/archgate-cli-reference.md` | Referência interna para agentes de IA com o guia CLI do Archgate | -| `~/.cursor/agents/archgate-developer.md` | Agente principal de desenvolvimento com o fluxo completo de governança | -| `~/.cursor/agents/archgate-planner.md` | Agente de planejamento para escopo e divisão de trabalho | +| Arquivo | Propósito | +| ---------------------------------------------- | ----------------------------------------------------------------------------- | +| `~/.cursor/skills/archgate-reviewer.md` | Valida alterações de código contra todos os ADRs do projeto | +| `~/.cursor/skills/archgate-lessons-learned.md` | Captura aprendizados e propõe novos ADRs quando padrões emergem | +| `~/.cursor/skills/archgate-adr-author.md` | Cria e edita ADRs seguindo as convenções do projeto | +| `~/.cursor/skills/archgate-onboard.md` | Configuração única: explora o codebase, entrevista você e cria ADRs | +| `~/.cursor/skills/archgate-cli-reference.md` | Referência interna para agentes de IA com o guia CLI do Archgate | +| `~/.cursor/agents/archgate-developer.md` | Agente principal de desenvolvimento com o fluxo completo de guardrails de ADR | +| `~/.cursor/agents/archgate-planner.md` | Agente de planejamento para escopo e divisão de trabalho | **Escopo do projeto**: diff --git a/docs/src/content/docs/pt-br/guides/opencode-integration.mdx b/docs/src/content/docs/pt-br/guides/opencode-integration.mdx index 7897f9d0..c42e1849 100644 --- a/docs/src/content/docs/pt-br/guides/opencode-integration.mdx +++ b/docs/src/content/docs/pt-br/guides/opencode-integration.mdx @@ -1,9 +1,9 @@ --- title: Integração com opencode -description: Integre o Archgate com o opencode para desenvolvimento assistido por IA com governança arquitetural. Configure agentes e subagentes para conformidade ADR. +description: Integre o Archgate com o opencode para desenvolvimento assistido por IA com guardrails arquiteturais. Configure agentes e subagentes para conformidade ADR. --- -O Archgate se integra com o [opencode](https://opencode.ai) para oferecer aos agentes de IA um fluxo de governança estruturado. O agente lê seus ADRs antes de escrever código, valida depois e captura novos padrões para a equipe -- o mesmo fluxo disponível no [plugin para Claude Code](/guides/claude-code-plugin/). +O Archgate se integra com o [opencode](https://opencode.ai) para oferecer aos agentes de IA guardrails integrados. O agente lê seus ADRs antes de escrever código, valida depois e captura novos padrões para a equipe -- o mesmo fluxo disponível no [plugin para Claude Code](/guides/claude-code-plugin/). ## Configuração @@ -32,7 +32,7 @@ O opencode usa a convenção XDG Base Directory em todas as plataformas (via o p A instalação só é executada quando a CLI `opencode` está no seu PATH. O Archgate precisa confirmar que o opencode está presente antes de gravar arquivos no diretório de configuração do escopo do usuário -- caso contrário, os agentes ficariam em um local que ninguém lê. Instale o opencode em [opencode.ai](https://opencode.ai/docs/) primeiro, depois re-execute `archgate init --editor opencode` ou `archgate plugin install --editor opencode`. ::: -Se você fez login via `archgate login` **e** o `opencode` está no seu PATH, o comando init também baixa e instala o bundle de agentes Archgate para o opencode. O bundle fornece um agente primário pré-configurado e quatro subagentes que dão à IA do opencode um fluxo de governança completo. +Se você fez login via `archgate login` **e** o `opencode` está no seu PATH, o comando init também baixa e instala o bundle de agentes Archgate para o opencode. O bundle fornece um agente primário pré-configurado e quatro subagentes que dão à IA do opencode um fluxo completo de guardrails. Para instalar os agentes explicitamente: diff --git a/docs/src/content/docs/pt-br/guides/vscode-plugin.mdx b/docs/src/content/docs/pt-br/guides/vscode-plugin.mdx index 0c6de1dd..a0c96c95 100644 --- a/docs/src/content/docs/pt-br/guides/vscode-plugin.mdx +++ b/docs/src/content/docs/pt-br/guides/vscode-plugin.mdx @@ -1,9 +1,9 @@ --- title: Plugin para VS Code -description: Instale a extensão Archgate para VS Code com desenvolvimento assistido por IA e governança arquitetural. Verificação de conformidade ADR em tempo real. +description: Instale a extensão Archgate para VS Code com desenvolvimento assistido por IA e guardrails arquiteturais. Verificação de conformidade ADR em tempo real. --- -O plugin Archgate para VS Code oferece aos agentes de IA que trabalham no [VS Code](https://code.visualstudio.com/) um fluxo de governança estruturado. Os agentes leem seus ADRs antes de escrever código, validam depois e capturam novos padrões para a equipe -- o mesmo fluxo disponível no [plugin para Claude Code](/guides/claude-code-plugin/). +O plugin Archgate para VS Code oferece aos agentes de IA que trabalham no [VS Code](https://code.visualstudio.com/) guardrails integrados. Os agentes leem seus ADRs antes de escrever código, validam depois e capturam novos padrões para a equipe -- o mesmo fluxo disponível no [plugin para Claude Code](/guides/claude-code-plugin/). ## Como funciona @@ -41,7 +41,7 @@ archgate init --editor vscode Se você já estiver logado, este comando: -1. Cria o diretório de governança `.archgate/` (ADRs, regras de lint) +1. Cria o diretório `.archgate/` com ADRs e regras de lint 2. Adiciona a URL autenticada do marketplace nas suas **configurações de usuário** do VS Code 3. Baixa e instala a extensão Archgate para VS Code (`.vsix`) se o CLI `code` estiver disponível @@ -106,7 +106,7 @@ Substitua `` pelo seu token archgate (obtenha-o via `archgate plugin url ## O que o plugin oferece -O plugin adiciona um agente e skills baseadas em papéis ao VS Code. O agente orquestra o fluxo de governança, invocando skills conforme necessário. +O plugin adiciona um agente e skills baseadas em papéis ao VS Code. O agente orquestra o fluxo de guardrails, invocando skills conforme necessário. ### Agente diff --git a/docs/src/content/docs/pt-br/index.mdx b/docs/src/content/docs/pt-br/index.mdx index 422e7c22..550b1322 100644 --- a/docs/src/content/docs/pt-br/index.mdx +++ b/docs/src/content/docs/pt-br/index.mdx @@ -1,9 +1,9 @@ --- title: Archgate -description: O Archgate CLI aplica Architecture Decision Records (ADRs) como regras executáveis em TypeScript. Automatize a governança de código para humanos e agentes de IA. +description: Linting e guardrails de nível enterprise para trabalho com IA. Transforme as decisões arquiteturais da sua equipe em verificações executáveis que rodam no CI, hooks de pre-commit e dentro de ferramentas de codificação com IA. template: splash hero: - tagline: Escreva um ADR uma vez. Aplique em todo lugar. Alimente agentes de IA automaticamente. + tagline: Linting e guardrails de nível empresarial para trabalho com IA. actions: - text: Primeiros Passos link: /getting-started/installation/ @@ -46,12 +46,12 @@ Quando você executa `archgate check`, a CLI carrega cada ADR que possui `rules: quando regras são violadas. Funciona com GitHub Actions, GitLab CI ou qualquer sistema de CI que respeite códigos de saída. - + Plugins de editor dão aos agentes de IA acesso direto aos seus ADRs via comandos CLI. Eles leem as decisões antes de escrever código e validam depois. Sem copiar e colar regras nos prompts. - + O Archgate governa seu próprio desenvolvimento. A mesma ferramenta que verifica seu código verifica o nosso. Nossos próprios ADRs aplicam estrutura de comandos, tratamento de erros, formatação de saída, testes e mais — [veja @@ -61,7 +61,7 @@ Quando você executa `archgate check`, a CLI carrega cada ADR que possui `rules: ## Plugins para editores -A CLI do Archgate funciona de forma independente, mas os **plugins para editores** habilitam um fluxo completo de governança com IA. Os plugins dão aos agentes de IA habilidades baseadas em papéis para que leiam seus ADRs antes de programar, validem depois e capturem novos padrões para sua equipe -- automaticamente. +A CLI do Archgate funciona de forma independente, mas os **plugins para editores** habilitam um fluxo completo de guardrails com IA. Os plugins dão aos agentes de IA habilidades baseadas em papéis para que leiam seus ADRs antes de programar, validem depois e capturem novos padrões para sua equipe -- automaticamente. @@ -71,7 +71,7 @@ A CLI do Archgate funciona de forma independente, mas os **plugins para editores O plugin para Cursor fornece regras e habilidades pré-configuradas para - agentes, dando ao agente de IA do Cursor o mesmo fluxo de governança do + agentes, dando ao agente de IA do Cursor o mesmo fluxo de guardrails do Claude Code. From 56dc3847858affec1f185fa0bbcdaf6996bcc5c0 Mon Sep 17 00:00:00 2001 From: Rhuan Barreto Date: Thu, 11 Jun 2026 16:22:43 +0200 Subject: [PATCH 4/5] docs: sync remaining translation files with positioning update Update getting-started and guide pages in pt-BR and Norwegian to match the English positioning changes: installation, quick-start, ci-integration, and claude-code-plugin pages now lead with guardrails instead of governance. Signed-off-by: Rhuan Barreto --- docs/src/content/docs/nb/getting-started/installation.mdx | 4 ++-- docs/src/content/docs/nb/getting-started/quick-start.mdx | 2 +- docs/src/content/docs/nb/guides/ci-integration.mdx | 2 +- docs/src/content/docs/nb/guides/claude-code-plugin.mdx | 6 +++--- .../src/content/docs/pt-br/getting-started/installation.mdx | 4 ++-- docs/src/content/docs/pt-br/getting-started/quick-start.mdx | 2 +- docs/src/content/docs/pt-br/guides/ci-integration.mdx | 2 +- docs/src/content/docs/pt-br/guides/claude-code-plugin.mdx | 6 +++--- 8 files changed, 14 insertions(+), 14 deletions(-) diff --git a/docs/src/content/docs/nb/getting-started/installation.mdx b/docs/src/content/docs/nb/getting-started/installation.mdx index c4871b7a..ddb4a086 100644 --- a/docs/src/content/docs/nb/getting-started/installation.mdx +++ b/docs/src/content/docs/nb/getting-started/installation.mdx @@ -154,8 +154,8 @@ Hvis du foretrekker `npm install -g archgate` i stedet for proto-pluginen, må d ## Neste steg -Etter installasjonen, kjør `archgate init` i prosjektet ditt for å sette opp styring. Se guiden [Hurtigstart](/getting-started/quick-start/) for en gjennomgang. +Etter installasjonen, kjør `archgate init` i prosjektet ditt for å sette opp linting og guardrails. Se guiden [Hurtigstart](/getting-started/quick-start/) for en gjennomgang. :::tip[Editorplugins (beta)] -Vil du at AI-agenten din skal lese ADR-er før den koder og validere etterpå? Editorpluginene for [Claude Code](/guides/claude-code-plugin/) og [Cursor](/guides/cursor-integration/) legger til en komplett styringsarbeidsflyt på toppen av CLI-en. Kjør `archgate login` for å registrere deg og komme i gang. +Vil du at AI-agenten din skal lese ADR-er før den koder og validere etterpå? Editorpluginene for [Claude Code](/guides/claude-code-plugin/) og [Cursor](/guides/cursor-integration/) legger til en komplett guardrails-arbeidsflyt på toppen av CLI-en. Kjør `archgate login` for å registrere deg og komme i gang. ::: diff --git a/docs/src/content/docs/nb/getting-started/quick-start.mdx b/docs/src/content/docs/nb/getting-started/quick-start.mdx index c6e35bc9..43ea1df0 100644 --- a/docs/src/content/docs/nb/getting-started/quick-start.mdx +++ b/docs/src/content/docs/nb/getting-started/quick-start.mdx @@ -138,7 +138,7 @@ Nå som du har et fungerende oppsett, kan du dykke dypere: - [CI-integrasjon](/guides/ci-integration/) -- Koble `archgate check` til GitHub Actions, GitLab CI eller en hvilken som helst pipeline. - [Pre-commit Hooks](/guides/pre-commit-hooks/) -- Kjør sjekker lokalt før hver commit. -- [Claude Code-plugin](/guides/claude-code-plugin/) -- Gi AI-agenter en komplett styringsarbeidsflyt med rollebaserte ferdigheter. +- [Claude Code-plugin](/guides/claude-code-plugin/) -- Gi AI-agenter arkitekturbevisste guardrails med rollebaserte ferdigheter. - [Cursor-integrasjon](/guides/cursor-integration/) -- Bruk Archgate med Cursor IDE for AI-assistert utvikling. :::tip[Editorplugins (beta)] diff --git a/docs/src/content/docs/nb/guides/ci-integration.mdx b/docs/src/content/docs/nb/guides/ci-integration.mdx index 9f925dbb..62abea1b 100644 --- a/docs/src/content/docs/nb/guides/ci-integration.mdx +++ b/docs/src/content/docs/nb/guides/ci-integration.mdx @@ -286,6 +286,6 @@ Bruk `--verbose` for å se beståtte regler og tidsinformasjon sammen med feil. - run: archgate check --verbose ``` -:::tip[Legg til AI-styring i arbeidsflyten din] +:::tip[Legg til AI-guardrails i arbeidsflyten din] CI fanger brudd ved sammenslåing. Redaktørplugins fanger dem under koding. Med [Claude Code](/guides/claude-code-plugin/)- eller [Cursor](/guides/cursor-integration/)-pluginen leser AI-agenten din ADR-er før den skriver kode og validerer samsvar før du i det hele tatt committer. [Meld deg på beta-tilgang](https://plugins.archgate.dev). ::: diff --git a/docs/src/content/docs/nb/guides/claude-code-plugin.mdx b/docs/src/content/docs/nb/guides/claude-code-plugin.mdx index fee3f4e4..519a2a03 100644 --- a/docs/src/content/docs/nb/guides/claude-code-plugin.mdx +++ b/docs/src/content/docs/nb/guides/claude-code-plugin.mdx @@ -1,13 +1,13 @@ --- title: Claude Code-plugin -description: Sett opp Archgate-pluginen for Claude Code. Gi AI-agenter en styringsarbeidsflyt som leser ADR-er, validerer kode og fanger opp arkitekturmønstre. +description: Sett opp Archgate-pluginen for Claude Code. Gi AI-agenter en guardrails-arbeidsflyt som leser ADR-er, validerer kode og fanger opp arkitekturmønstre. --- -Archgate Claude Code-pluginen gir AI-agenter som jobber i [Claude Code](https://claude.ai/code) en strukturert styringsarbeidsflyt. I stedet for å stole på prompt-instruksjoner som glir over tid, leser agenter ADR-ene dine direkte via Archgate CLI-kommandoer og validerer sin egen kode mot reglene dine. +Archgate Claude Code-pluginen gir AI-agenter som jobber i [Claude Code](https://claude.ai/code) innebygde guardrails. I stedet for å stole på prompt-instruksjoner som glir over tid, leser agenter ADR-ene dine direkte via Archgate CLI-kommandoer og validerer sin egen kode mot reglene dine. ## Hva pluginen tilbyr -Pluginen legger til en agent og rollebaserte ferdigheter i Claude Code. Agenten orkestrerer styringsarbeidsflyten, og aktiverer ferdigheter etter behov -- les beslutninger før koding, valider etterpå, og fang opp nye mønstre for teamet. +Pluginen legger til en agent og rollebaserte ferdigheter i Claude Code. Agenten orkestrerer guardrails-arbeidsflyten, og aktiverer ferdigheter etter behov -- les beslutninger før koding, valider etterpå, og fang opp nye mønstre for teamet. ### Agent diff --git a/docs/src/content/docs/pt-br/getting-started/installation.mdx b/docs/src/content/docs/pt-br/getting-started/installation.mdx index 66d02bea..09f3e9bc 100644 --- a/docs/src/content/docs/pt-br/getting-started/installation.mdx +++ b/docs/src/content/docs/pt-br/getting-started/installation.mdx @@ -214,8 +214,8 @@ Se você preferir `npm install -g archgate` ao invés do plugin proto, precisa c ## Próximos passos -Após a instalação, execute `archgate init` no seu projeto para configurar a governança. Veja o guia de [Início Rápido](/getting-started/quick-start/) para um passo a passo. +Após a instalação, execute `archgate init` no seu projeto para configurar linting e guardrails. Veja o guia de [Início Rápido](/getting-started/quick-start/) para um passo a passo. :::tip[Plugins para editores (beta)] -Quer que seu agente de IA leia ADRs antes de programar e valide depois? Os plugins para editores do [Claude Code](/guides/claude-code-plugin/) e [Cursor](/guides/cursor-integration/) adicionam um fluxo completo de governança sobre a CLI. Execute `archgate login` para se cadastrar e começar. +Quer que seu agente de IA leia ADRs antes de programar e valide depois? Os plugins para editores do [Claude Code](/guides/claude-code-plugin/) e [Cursor](/guides/cursor-integration/) adicionam um fluxo completo de guardrails sobre a CLI. Execute `archgate login` para se cadastrar e começar. ::: diff --git a/docs/src/content/docs/pt-br/getting-started/quick-start.mdx b/docs/src/content/docs/pt-br/getting-started/quick-start.mdx index 76a47720..62a6481f 100644 --- a/docs/src/content/docs/pt-br/getting-started/quick-start.mdx +++ b/docs/src/content/docs/pt-br/getting-started/quick-start.mdx @@ -138,7 +138,7 @@ Agora que você tem uma configuração funcionando, aprofunde-se: - [Integração com CI](/guides/ci-integration/) — Conecte `archgate check` ao GitHub Actions, GitLab CI ou qualquer pipeline. - [Pre-commit Hooks](/guides/pre-commit-hooks/) — Execute verificações localmente antes de cada commit. -- [Plugin Claude Code](/guides/claude-code-plugin/) — Dê aos agentes de IA um fluxo completo de governança com habilidades baseadas em papéis. +- [Plugin Claude Code](/guides/claude-code-plugin/) — Dê aos agentes de IA guardrails arquiteturais com habilidades baseadas em papéis. - [Integração com Cursor](/guides/cursor-integration/) — Use o Archgate com o Cursor IDE para desenvolvimento assistido por IA. :::tip[Plugins para editores (beta)] diff --git a/docs/src/content/docs/pt-br/guides/ci-integration.mdx b/docs/src/content/docs/pt-br/guides/ci-integration.mdx index fadcf397..84da4e1c 100644 --- a/docs/src/content/docs/pt-br/guides/ci-integration.mdx +++ b/docs/src/content/docs/pt-br/guides/ci-integration.mdx @@ -286,6 +286,6 @@ Use `--verbose` para ver as regras aprovadas e informações de tempo junto com - run: archgate check --verbose ``` -:::tip[Adicione governança de IA ao seu fluxo de trabalho] +:::tip[Adicione guardrails de IA ao seu fluxo de trabalho] O CI detecta violações no momento do merge. Plugins de editor detectam no momento da codificação. Com o plugin [Claude Code](/guides/claude-code-plugin/) ou [Cursor](/guides/cursor-integration/), seu agente de IA lê os ADRs antes de escrever código e valida a conformidade antes mesmo de você commitar. [Inscreva-se para acesso beta](https://plugins.archgate.dev). ::: diff --git a/docs/src/content/docs/pt-br/guides/claude-code-plugin.mdx b/docs/src/content/docs/pt-br/guides/claude-code-plugin.mdx index 3d3a1753..9f674af6 100644 --- a/docs/src/content/docs/pt-br/guides/claude-code-plugin.mdx +++ b/docs/src/content/docs/pt-br/guides/claude-code-plugin.mdx @@ -1,13 +1,13 @@ --- title: Plugin para Claude Code -description: Configure o plugin Archgate para Claude Code. Dê aos agentes de IA um fluxo de governança que lê ADRs, valida código e captura padrões arquiteturais. +description: Configure o plugin Archgate para Claude Code. Dê aos agentes de IA guardrails que leem ADRs, validam código e capturam padrões arquiteturais. --- -O plugin Archgate para Claude Code oferece aos agentes de IA que trabalham no [Claude Code](https://claude.ai/code) um fluxo de governança estruturado. Em vez de depender de instruções em prompts que se deterioram com o tempo, os agentes leem seus ADRs diretamente via comandos do CLI Archgate e validam o próprio código contra suas regras. +O plugin Archgate para Claude Code oferece aos agentes de IA que trabalham no [Claude Code](https://claude.ai/code) guardrails integrados. Em vez de depender de instruções em prompts que se deterioram com o tempo, os agentes leem seus ADRs diretamente via comandos do CLI Archgate e validam o próprio código contra suas regras. ## O que o plugin oferece -O plugin adiciona um agente e skills baseadas em papéis ao Claude Code. O agente orquestra o fluxo de governança, invocando skills conforme necessário -- ler as decisões antes de codificar, validar depois e capturar novos padrões para a equipe. +O plugin adiciona um agente e skills baseadas em papéis ao Claude Code. O agente orquestra o fluxo de guardrails, invocando skills conforme necessário -- ler as decisões antes de codificar, validar depois e capturar novos padrões para a equipe. ### Agente From d9700cda0d32adb5582efc8ea390a209c7710c35 Mon Sep 17 00:00:00 2001 From: Rhuan Barreto Date: Thu, 11 Jun 2026 17:04:51 +0200 Subject: [PATCH 5/5] docs: harmonize "enterprise" terminology in pt-br hero tagline Signed-off-by: Rhuan Barreto --- docs/src/content/docs/pt-br/index.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/src/content/docs/pt-br/index.mdx b/docs/src/content/docs/pt-br/index.mdx index 550b1322..9d23c1a4 100644 --- a/docs/src/content/docs/pt-br/index.mdx +++ b/docs/src/content/docs/pt-br/index.mdx @@ -3,7 +3,7 @@ title: Archgate description: Linting e guardrails de nível enterprise para trabalho com IA. Transforme as decisões arquiteturais da sua equipe em verificações executáveis que rodam no CI, hooks de pre-commit e dentro de ferramentas de codificação com IA. template: splash hero: - tagline: Linting e guardrails de nível empresarial para trabalho com IA. + tagline: Linting e guardrails de nível enterprise para trabalho com IA. actions: - text: Primeiros Passos link: /getting-started/installation/