Archspec 0.13.0: команды, файлы и проверки

01 / Что именно запускается

Archspec 0.13.0, commit cbcfe19. Команды Claude Code — Markdown-входы в три скилла. Они задают процедуру для модели; Python-скрипты, Go-линтеры и Git-хуки выполняют отдельные технические проверки. Версия плагина ↗

Команды и артефакты · текущая версия 0.13.0Открыть отдельно ↗

Вход	Процедура	Результат
/archspec:init ↗	architecture-sync: Bootstrap ↗	Сканирование Go, вопросы, SERVICE_MAP, схема, docs, установка Git-хуков
/archspec:investigate ↗	architecture-investigate ↗	Читает карты и контракты; archplan с YAML patch, рисками и ревью
/archspec:implement ↗	architecture-implement ↗	Требует archplan; меняет контракты, sync, codingplan, код и тесты
/archspec:sync ↗	architecture-sync: Procedure ↗	Проверяет YAML; пересобирает Mermaid и ARCHITECTURE.md

02 / Где живут данные и проверяющий код

Файл в сервисе	Назначение	Источник / генератор
docs/SERVICE_MAP.yaml	API, владельцы, входящие/исходящие связи, события, запись, сбои, риски	Шаблон ↗ · Формат ↗
.servicemap/schema.json	Копия JSON Schema, которую кладёт init	Схема в плагине ↗
docs/diagrams/{context,container,sequence}.mmd	Представления карты; генерируются из YAML	generate_mermaid.py ↗
docs/ARCHITECTURE.md	Описание карты; sync обновляет управляемую область	render_architecture_md.py ↗
docs/plans/*.archplan.md	План одного изменения, patch карт, риски и варианты	Контракт archplan ↗
docs/plans/*.codingplan.md	Задачи: элемент archplan → задача → тест	Фаза C ↗
docs/adr/*.md	Архитектурные решения и принятые отклонения	Реализация и ADR ↗

docs/SERVICE_MAP.yaml
  → validate_servicemap.py
  → sync.py
    → generate_context / generate_container / generate_sequence
    → render_architecture_md
  → validate_mermaid.py

03 / Четыре точки проверок

Генерация и Git-хуки — разные точки запускаОткрыть отдельно ↗

Запуск	Код	Что проверяет / граница
git commit	run_all_checks.py ↗	10 групп: схема, циклы, ссылки, диаграммы, breaking changes, exceptions, pragmas, TODO, write_path/events, граф. BLOCK даёт exit 1
/archspec:validate	Процедура ↗ · Go dispatcher ↗	Находит карты сервисов, запускает deterministic runner и линтеры по языку. Формирует отчёт; это инструкция агенту
/archspec:check-architecture	check_architecture.py ↗	Обходит SERVICE_MAP в репозитории; сверяет граф, события, write_path, идемпотентность и другие объявленные свойства
git push	run_all_pushchecks.py ↗	Drift по HEAD + изменения контракта относительно ARCHSPEC_BASE_REF, по умолчанию origin/main

Шесть Go-проверок: handler-idempotency, outbox-pattern, optimistic-locking, swallowed-errors, redundant-call, undeclared-event. Реальный список ↗

04 / Что проверки действительно доказывают

Проверка	Доказывает	Остаётся проверить
Схема ↗	Структура, обязательные поля, допустимые значения	Истинность записанных фактов
DET-003 ↗	Файл теста / контракта существует; ::TestName отрезается при поиске пути	Существует ли сама функция теста; проверяет ли она нужное свойство
Межсервисный аудит ↗	Согласованность объявлений в картах	Реальная проводка и поведение процесса
Пять проходов по diff ↗	Процедура требует wiring, все ветки событий, поля, дедуп и evidence	Модель может пропустить дефект; требуется доказательство в коде и тесте
Независимое ревью ↗	Процедура требует свежий контекст; при отсутствии ревьюера SELF-ONLY	Следование инструкции не обеспечивается самим Git-хуком

Девять вопросов перед планом: вход · владелец состояния · личность актора · порядок событий · доставка и дедуп · лимиты · идентификаторы · ошибки · путь записи. Вопросы и условия уточнения ↗