документация
Документация OFFICINA
Подключение и основные возможности на одной странице. Полный корпус — руководства, скиллы и субагенты — в репозитории.
Что это
OFFICINA — мастерская для работы с AI-инструментами в разработке продуктов. В основе — метод: как выстроить работу с ассистентом, чтобы она была предсказуемой и воспроизводимой. Вокруг метода — скиллы, субагенты, CLI и конфиги, готовые к переиспользованию.
Репозиторий распространяется под лицензией MIT: свободно использовать, изменять и распространять.
Требования
- macOS — установочные скрипты рассчитаны на эту платформу.
- Claude Code — ядро, под которое заточены субагенты и настройки. Скиллы переносимые и работают в совместимых средах тоже.
- git — для клонирования репозитория.
Установка
Клонируйте репозиторий и откройте раздел под свою задачу — почти у каждого свой README:
git clone https://github.com/KirKruglov/OFFICINA.git cd OFFICINA
Готовый установщик настраивает окружение VS Code: настройки, горячие клавиши, шрифт MesloLGS Nerd Font и курированные расширения:
./install/vscode.sh
Остальные разделы подключаются выборочно. Скилл ставится копированием его папки в каталог скиллов агента: ~/.claude/skills/<имя>/ делает его доступным везде, .claude/skills/<имя>/ внутри репозитория — только в этом проекте. Гайды методологии читают и применяют без установки.
Разделы репозитория
| Раздел | Что содержит |
|---|---|
skills/ | Переносимые скиллы — переиспользуемые режимы и процедуры |
claude/ | Слой Claude Code — субагенты и настройки |
methodology/ | Правила и руководства — как работать |
cli/ | Личные CLI-инструменты и общие библиотеки — каждый со своей точкой входа и README |
vscode/ | Настройки VS Code, горячие клавиши, курированные расширения |
install/ | Скрипты установки и раскладки |
Как устроен метод
Отправная точка — вопрос «чем решать задачу». Ответ определяет артефакт, дальше идёт соответствующий гайд в methodology/: структура, конвенции, чек-лист перед деплоем. Метод общий, артефакт переносится между проектами.
Метод держится на 4 принципах:
- Правильный инструмент под задачу. Детерминированное уходит в скрипт, решения по контексту — модели. Лишняя модель в цикле добавляет стоимость и неопределённость.
- Надёжность держится на ограничениях. Систему держат границы, бюджеты и проверки. В автономном цикле обязателен тот, кто способен сказать «нет».
- Знание закрепляется в артефакте. Гайд, скилл или субагент переиспользуются; выведенное однажды не выводится заново.
- Отбор вручную. В репозиторий попадает проверенное на практике и осознанно выбранное.
Инструменты метода
Вопрос «чем решать задачу» даёт 4 ответа. У каждого свой артефакт и свой гайд в methodology/:
| Инструмент | Когда применяют | Гайд |
|---|---|---|
| CLI | Детерминированное действие, модель не нужна | cli-authoring-guide.md |
| Скилл | Нужно понять контекст и решить по ситуации | skill-agent-authoring-guide.md |
| Субагент | Изолированная подзадача или роль-персона | skill-agent-authoring-guide.md |
| Loop | Повторяющийся цикл по расписанию | loop-engineering-rules.md |
Скиллы и субагенты лежат в skills/ и claude/, CLI-инструменты — в cli/, каждый со своей точкой входа и README.
jig — метод, ставший инструментом: одной командой разворачивает структуру документации и настройку Claude Code, которые описывают гайды методологии. Работает без модели — детерминированный сборщик репозитория.
Что дальше
Руководства методологии читаются по отдельности, в любом порядке:
writing-style.md— стиль письма для документов и интерфейсных текстов.cli-authoring-guide.md— как писать свои CLI-инструменты.skill-agent-authoring-guide.md— как писать скиллы и субагентов.loop-engineering-rules.md— правила автономных циклов: границы, бюджеты, проверки.
Вопросы и небольшие правки приветствуются — репозиторий открыт.
Вернуться к продукту
Обзор метода, состав репозитория и принципы — на странице OFFICINA.