Перейти к содержанию

Claude Code

Плагин Pragma ведёт фичу в iOS от идеи до релиза

6 мин чтения

Текст написан ИИ-моделью по источникам, на которые ведут ссылки, и сверен с ними второй моделью. Как мы работаем

Всё о теме: Claude Code: версии и изменения →
Изображение: github.com

Ведущий iOS-инженер Акшай Пимприкар 19 августа выложил Pragma, конвейер разработки для Claude Code. По его словам, на нём собрано приложение FinanceTracker, и через цепочку /spec → /plan → /feature → /gates → /review прошли 94 смерженных PR.

Человек одобряет только спецификацию и план, остальное делают агенты и GitHub Actions. В репозитории проекта на GitHub Пимприкар описывает FinanceTracker как боевое приложение на SwiftUI и SwiftData, которое через Pragma делалось с первого дня: спецификации, планы и PR тянутся от самого первого коммита, скриншоты лежат в README приложения. Цель он формулирует так: чтобы «один инженер выпускал продукт в масштабе команды».

Ставится Pragma двумя путями. Первый идёт через маркетплейс плагинов Claude Code: в корне iOS-репозитория выполняются /plugin marketplace add akshaypimprikar/pragma, /plugin install pragma@pragma и /pragma:init MyApp. Команда init копирует в проект команды, файлы контекста, сценарии CI и вспомогательные скрипты и подставляет имя приложения. Заодно она расспрашивает разработчика об архитектуре и ключевых ограничениях, а из ответов заполняет CLAUDE.md и invariants.md. Второй путь, scripts/setup.sh из склонированного репозитория, копирует те же файлы, но оба документа оставляет шаблонами, и заполнить их нужно до первого запуска /feature.

Где нужен человек

В проект ставятся три слоя: 15 слэш-команд в .claude/commands/, три сценария GitHub Actions и скрипты, которые выбирают симулятор и следят за покрытием в CI. Слои друг от друга не зависят, и можно взять одни команды.

Основная цепочка начинается с /spec. Агент предлагает два-три подхода к фиче, вы выбираете один, и спецификация сохраняется в docs/specs/. Затем /plan превращает одобренную спецификацию в план по задачам, и после его одобрения участие человека заканчивается.

/feature исполняет план по TDD: сначала пишется тест, который падает, причём по правильной причине, затем минимальный код, чтобы он прошёл, затем прогон всего набора тестов, затем один коммит на задачу. Пока тесты красные, к следующей задаче агент не переходит. /gates перед открытием PR проверяет сборку, тесты и соблюдение архитектуры. После открытия PR /review проверяет архитектуру и публикует вердикт как настоящее ревью на GitHub, а /test дописывает тесты, когда ревью ответило APPROVED. Обе команды по очереди запускает /pr-followup. После слияния в develop /release 1.0.0 поднимает версию, обновляет changelog, открывает PR в main и ставит git-тег.

У багов своя ветка: /bugfix сначала пишет регрессионный тест и только потом исправление, после чего идут /gates, PR и /review. Вспомогательных команд шесть. /design задаёт визуальные токены перед спецификацией UI-фичи. /parallel-review параллельно гоняет чеклист /review и code-review:code-review. /status восстанавливает, на чём остановилась работа, когда сессию нужно продолжить. /trim-context подрезает накопленный контекст после завершения плана, а оставшиеся две отвечают за аудит самого конвейера и синхронизацию с соглашениями проекта.

Часть имён совпадает со встроенными в Claude Code: там есть свой /plan, который включает режим планирования, и /review как алиас встроенного /code-review. Файл в .claude/commands/ по-прежнему создаёт одноимённую команду, хотя команды в Claude Code уже слиты со скиллами.

Проверки, которые агент не уговорит

Главное отличие от встроенных режимов работы со спецификациями Пимприкар видит в CI. Локальные /gates, /review и /test дают быструю обратную связь, а затем GitHub Actions повторяет те же проверки независимо от агента, и такую проверку «нельзя пропустить, перезапустив агента с другим промптом». Режимы спецификаций, по словам автора, генерируют план, но не подключают слой контроля, который агент «не сможет заболтать».

Сценариев три. pr-checks.yml срабатывает на PR в develop или main и гоняет модульные и интеграционные тесты. ui-tests.yml на тех же PR и на пушах в обе ветки прогоняет тесты интерфейса. release.yml запускается на тег вида v*.*.*, гонит весь набор тестов в конфигурации Release и создаёт GitHub Release. Загрузка в TestFlight уже описана в release.yml, но закомментирована: для неё нужны членство в Apple Developer Program, сертификат дистрибуции и ключ API App Store Connect.

Пороги покрытия у агента и CI заданы по-разному. /test требует не меньше 80% на новом коде. CI же валит PR только при покрытии ниже 60%, а между 60 и 80% лишь предупреждает.

Отдельно в репозитории лежит скилл deterministic-pr-gates. Он работает и без остального конвейера: сборка, тесты, покрытие, имена веток и правила слоёв проверяются перед PR так, что каждая проверка сводится к команде с исходом «прошла» или «не прошла». Судить о диффе ни одна из них языковую модель не просит.

Память в четырёх файлах

Между сессиями конвейер помнит через .claude/context/. В invariants.md лежат правила, которые не вправе нарушить ни один агент, например архитектура и типы для денег. decisions.md ведёт журнал решений по спецификациям: какой подход выбран и почему. feature-log.md записывает каждую выпущенную фичу. В rejections.md собраны отвергнутые подходы с причинами. Перед любым действием каждый агент читает эти файлы.

Автор сравнивает их с институциональной памятью старшего инженера: ограничения, прошлые решения и тупики, которые переживают границу сессии. Большинство инструментов с режимом спецификаций, по его словам, сбрасывают такой контекст в конце разговора.

Под какой стек

Архитектурные допущения по умолчанию заданы под конкретный стек и переопределяются в CLAUDE.md. Приложение строится по MVVM с репозиториями: во view нет бизнес-логики, ViewModel зависят только от протоколов. Данные хранятся в SwiftData, но доменные сервисы её не импортируют. Модульные и интеграционные тесты пишутся на Swift Testing, UI-тесты на XCUITest. Ещё одно допущение - PBXFileSystemSynchronizedRootGroup из Xcode 16 и новее: файлы компилируются, если лежат в нужной папке, поэтому project.pbxproj агент не трогает.

Ветки устроены по gitflow: main для продакшена с тегами только на релизах, develop как интеграционная ветка, feature/* и fix/* от develop, hotfix/* от main, release/* с PR в main и обратным слиянием. Для документов спецификаций и планов заведены отдельные ветки spec/*. При ручной установке под свой проект придётся заменить плейсхолдеры в командах и сценариях и переписать чеклист архитектуры в /review.

Почему не Plan Mode

Автор сам задаёт этот вопрос и перечисляет конкурентов: Plan Mode в Cursor, Cascade в Windsurf, workspace в GitHub Copilot, GitHub Spec Kit, BMAD-METHOD. Встроенные режимы он не ругает и называет разумным выбором по умолчанию для команд, которые уже живут в этих IDE. Pragma, по его словам, нужна тем, кто хочет, чтобы контроль и память существовали независимо от сессии, IDE и конкретного запуска агента.

Конструкцию Пимприкар раскладывает по схеме из статьи Мартина Фаулера «Harness Engineering for Coding Agent Users», вышедшей в апреле 2026 года. Фаулер описывает агента как модель плюс обвязку и делит обвязку на направляющие, которые задают курс до действия, и датчики, которые проверяют результат после. У Pragma направляющие - /spec и /plan. Датчик сопровождаемости - /gates, он ищет TODO и FIXME, проверяет имена веток, CHANGELOG, покрытие и раздутые абстракции. За соответствие архитектуре отвечает /review, за поведение /test, а /bugfix играет роль контура восстановления.

Датчик поведенческой корректности Фаулер называет «слоном в комнате», задачей, которая в большинстве обвязок пока не решена. /test вместе с порогом покрытия в /gates Пимприкар называет своей конкретной попыткой её решить.

Пока никто не написал. Будьте первым.

Присоединяйтесь к разговору

Войдите, чтобы оставить комментарий. Он появится после модерации.