Архитектура кода

Задайте границы модулей. Передайте правила агенту. Проверьте его изменения.

ЧерновикOrder service architectureИмпортируйте контракт из принятой ветки Git. Редактирование и экспорт не утверждают новые правила.

Черновик хранится в этом браузере. После перезагрузки импортируйте принятую версию из Git заново.

Границы и зависимости

Разрешённая зависимостьЗамечание из отчёта

Контракт, решения и проверки

Проверка изменений

Импортируйте принятый контракт из Git, чтобы сверить отчёт с его правилами.

Запустите проверку в репозитории, затем импортируйте JSON-отчёт сюда.

npx --no-install cloudarch-architecture check --root . --contract architecture/contract.json --output architecture/report.json

Импортированный отчёт описывает локальный запуск. Решение о мерже принимает защищённый CI.

Задача агенту

Brief использует черновик. Сначала примите контракт через ревью в Git, чтобы считать правила обязательными.

Что нужно сделатьФайлы для задачи, необязательно, по одному на строку

Подключить репозиторий к Codex или Claude Code

Экспортируйте контракт и сохраните его в репозитории как architecture/contract.json. Примите его через ревью в Git.

Установите CLI в репозиторий. Проверка и MCP работают локально, исходники остаются на вашей машине. Скачать CLI

npm install -D https://cloud-arch.tech/downloads/cloud-arch-architecture-cli-0.1.0.tgz
npx --no-install cloudarch-architecture context --root . --task "Add order cancellation"
npx --no-install cloudarch-architecture check --root . --contract architecture/contract.json --output architecture/report.json

Импортируйте architecture/report.json в этот экран. Без отдельной принятой версии CLI даёт локальную обратную связь по текущему контракту.

Для MCP укажите следующую команду stdio-сервера в настройках агента. Замените /absolute/path/to/repository абсолютным путём своего репозитория.

npx --no-install --prefix /absolute/path/to/repository cloudarch-architecture mcp --root /absolute/path/to/repository

Окончательный гейт мержа запускайте в защищённом CI: checker и принятый контракт берите из доверенной ревизии, а код — из проверяемой ветки. Передайте принятый контракт через --accepted-contract. Изменение правил требует отдельного ревью владельца.

Показать JSON черновика

{
  "version": 1,
  "id": "order-service",
  "name": "Order service architecture",
  "modules": [
    {
      "id": "ui",
      "name": "Interface",
      "paths": [
        "src/ui/"
      ],
      "responsibility": "Render orders and send user actions to the service layer.",
      "publicApi": [],
      "allowedDependencies": [
        "services"
      ]
    },
    {
      "id": "services",
      "name": "Services",
      "paths": [
        "src/services/"
      ],
      "responsibility": "Apply order business rules and coordinate storage through its public interface.",
      "publicApi": [
        "src/services/index.ts"
      ],
      "allowedDependencies": [
        "storage"
      ]
    },
    {
      "id": "storage",
      "name": "Storage",
      "paths": [
        "src/storage/"
      ],
      "responsibility": "Persist and retrieve orders. Keep storage details behind a public interface.",
      "publicApi": [
        "src/storage/index.ts"
      ],
      "allowedDependencies": []
    }
  ],
  "decisions": [
    {
      "id": "service-boundary",
      "title": "UI uses services",
      "rationale": "Order validation belongs to services so that every caller uses the same business rules."
    }
  ],
  "requiredChecks": [
    {
      "id": "architecture",
      "name": "Architecture boundaries",
      "command": "npx --no-install cloudarch-architecture check --root . --contract architecture/contract.json --output architecture/report.json"
    }
  ]
}

Задача агенту

Brief использует черновик. Сначала примите контракт через ревью в Git, чтобы считать правила обязательными.

Что нужно сделать

Файлы для задачи, необязательно, по одному на строку

npm install -D https://cloud-arch.tech/downloads/cloud-arch-architecture-cli-0.1.0.tgz npx --no-install cloudarch-architecture context --root . --task "Add order cancellation" npx --no-install cloudarch-architecture check --root . --contract architecture/contract.json --output architecture/report.json

{ "version": 1, "id": "order-service", "name": "Order service architecture", "modules": [ { "id": "ui", "name": "Interface", "paths": [ "src/ui/" ], "responsibility": "Render orders and send user actions to the service layer.", "publicApi": [], "allowedDependencies": [ "services" ] }, { "id": "services", "name": "Services", "paths": [ "src/services/" ], "responsibility": "Apply order business rules and coordinate storage through its public interface.", "publicApi": [ "src/services/index.ts" ], "allowedDependencies": [ "storage" ] }, { "id": "storage", "name": "Storage", "paths": [ "src/storage/" ], "responsibility": "Persist and retrieve orders. Keep storage details behind a public interface.", "publicApi": [ "src/storage/index.ts" ], "allowedDependencies": [] } ], "decisions": [ { "id": "service-boundary", "title": "UI uses services", "rationale": "Order validation belongs to services so that every caller uses the same business rules." } ], "requiredChecks": [ { "id": "architecture", "name": "Architecture boundaries", "command": "npx --no-install cloudarch-architecture check --root . --contract architecture/contract.json --output architecture/report.json" } ] }