SkillFoxx
Telegram

Spine: контур архитектурного контроля для GigaCode и Claude Code

spine-bank

Бинарь arch-be с MCP-сервером, хуками и 79 скиллами проверяет код агента по правилам архитектуры и не дает подделать доказательство

  • 2 ★ репозитория
  • Последний коммит
  • MIT
CLI

Расширенный доступ

Почему такой уровень

  • `arch-be connect` меняет .claude/settings.json и ставит хуки, которые блокируют действия агента при провале гейта
  • Бинарь скачивается из релиза GitHub и запускается на машине разработчика, его целостность нужно сверять по SHA256SUMS
Все причины и проверки
Российский стек

romannekrasovaillm/spine-bankАвтор:romannekrasovaillm

Установка

Работает в
Сервисы

Ручная установка

curl -L -o arch-be https://github.com/romannekrasovaillm/spine-bank/releases/latest/download/arch-be-core-linux-x86_64 && chmod +x arch-be && mv arch-be ~/.local/bin/

Для macOS arm64 файл arch-be-core-macos-arm64, для Windows arch-be-core-windows-x86_64.exe; целостность сверяется по SHA256SUMS из релиза.

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

  • `arch-be connect` меняет .claude/settings.json и ставит хуки, которые блокируют действия агента при провале гейта
  • Бинарь скачивается из релиза GitHub и запускается на машине разработчика, его целостность нужно сверять по SHA256SUMS

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Spine подключается к кодовому агенту (Claude Code, Qwen Code, GigaCode) как MCP-сервер spine с 45 инструментами только на чтение, набором хуков и 79 скиллами, из них 12 плейбуков `spine-*`. Основная поставка core работает без собственной языковой модели: думает агент, а вердикт дает код возврата команды `arch-be gate`. Команда `arch-be arch-diff --base main` показывает за один экран, что PR изменил в архитектуре: новые связи, внешние системы, контракты, затронутые инварианты, с указанием файла и строки и без LLM. `arch-be connect` прописывает хуки в .claude/settings.json. Для GigaCode есть отдельная инструкция docs/GIGACODE.md, а в исходниках лежит адаптер src/llm/gigachat.rs.

Для кого. Тимлидам и архитекторам, чьи команды пишут код с GigaCode или Claude Code и хотят проверять решения агента детерминированными правилами.

Подходит, если

  • Ревьюеру нужен ответ на вопрос, что этот PR изменил в архитектуре, с файлом и строкой
  • Агент GigaCode правит код, а гейт должен отклонять нарушения правил из CONSTRAINTS.yaml
  • Агент не должен ослабить правила ради зеленого прогона: подмена правил ловится гейтом
  • Хочется, чтобы уроки прошлых ошибок попадали в контекст агента при старте сессии

Не подходит, если

  • Хватит обычного линтера: Spine нужен там, где есть модель системы и архитектурные правила
  • Нужен инструмент со своей языковой моделью в поставке: в редакции core ее нет
  • Нет возможности ставить готовый бинарь из релиза GitHub в окружение разработчика

Пример запроса к агенту

Покажи архитектурный дифф моей ветки относительно main и прогони `arch-be gate` по проекту

Ограничения

Основная поставка core идет без собственной языковой модели, а адаптер GigaChat лежит в исходниках src/llm/gigachat.rs и относится к другим редакциям. Подключение к GigaCode проверено, по словам автора, на `qwen-code` 0.0.5 и 0.24.0, сам GigaCode CLI наследует от него настройки. Бинарь ставится из релиза GitHub для Linux, macOS и Windows, исходники на Rust. Вердикт INCOMPLETE говорит о неполной проверке, зеленым его считать нельзя. Автор один, звезд две, документация преимущественно на русском.

Как отключить. Удалите бинарь `arch-be` из ~/.local/bin, уберите блок хуков и MCP-сервер spine из .claude/settings.json (или из настроек GigaCode) и каталог .arch-handoff в проекте.

Частые вопросы

Нужна ли своя языковая модель?

В основной поставке core нет: решения принимает ваш агент, а Spine проверяет их правилами и выдает код возврата.

Какие агенты поддерживаются?

По README подключение проверено на шести средах; в описании названы Claude Code, Qwen Code и GigaCode, для GigaCode есть отдельная инструкция.

Что дает arch-diff без настройки?

Один экран о том, что PR изменил в архитектуре, с файлом и строкой у каждого факта; модель системы необязательна, граф строится по манифестам сборки.

Как проверить скачанный бинарь?

Сверьте SHA256SUMS из того же релиза: `sha256sum --check SHA256SUMS` на Linux или `shasum -a 256 --check SHA256SUMS` на macOS.

Может ли агент сам одобрить решение?

Нет: подпись связки и принятие рубрик остаются за человеком, а попытки ослабить правила гейт помечает как rule_weakened или self_approved.

Обсуждение

Вопросов и отзывов пока нет.

GigaChat — все инструменты

GigaCode Bridge MCP

Gigacode-bridge-mcp

Российский стек

MCP-сервер передает GigaCode CLI изолированные правки кода во временных рабочих деревьях Git и возвращает патч на независимое ревью

MCP-серверРасширенный доступ
Российский стек

Монорепозиторий флоу для GigaCode CLI: разработка со стадиями и жесткими гейтами, обсервер хода работы и обратный анализ кода в спеку

ВоркфлоуРасширенный доступ
Российский стек

Пакет Python отдает агенту GigaCode ячейки Jupyter через ACP: вход через браузер, возобновление сессий, подтверждение разрешений и отмена задач

ПлагинРасширенный доступ
Российский стек

Небольшой Python MCP-сервер для API GigaChat от Сбера: авторизация по Basic-ключу и обращение к моделям прямо из агента, проверялся на OpenCode под Windows

MCP-серверРасширенный доступ

Из блога

Коротко о README

В README объяснено, зачем нужен контур (проверить код агента и не дать подделать доказательство), восемь причин, схема от агента через хуки к гейту, редакции поставки, шаг 0 с загрузкой бинаря и шаг 1 с архитектурным диффом за пять минут.

Бейдж для README

Сообщить о проблеме