# shell-and-workflows

Правило shell-and-workflows описывает работу с Docker-сервисами проекта, типовые команды и порядок запуска тестов. Помогает выбрать, где выполнять фронтенд- и бэкенд-проверки.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 1216 у репозитория
- Автор: fcakyon
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/polar-skills/skills/polar-local-environment/rules/shell-and-workflows.md
- Обновлён: 2026-10-24
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/shell-and-workflows

## Что делает

В правиле собраны команды `dev docker` для входа в контейнеры, разового выполнения команд и повседневной работы: запустить сервисы, проверить их состояние, смотреть логи и остановить окружение. Для API и worker приведены команды миграций Alembic, для web — тесты и линтер на `pnpm`, для PostgreSQL — подключение к базе текущего экземпляра. Номер экземпляра и порты можно узнать через `dev docker ports`.

После `git pull` большинство изменений подхватывает hot reload; при изменении зависимостей правило предлагает перезапустить сервисы, а при изменениях Dockerfile или системных зависимостей — пересобрать их. Тесты бэкенда в контейнере `api` не запускаются: фикстуре нужен S3 на `http://127.0.0.1:9000`, недоступный контейнерам по этому адресу. Их запускают на хосте командой `uv run task test` согласно `server/AGENTS.md`; это ограничение важно учесть до проверки изменений.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add fcakyon/claude-codex-settings
```
В чате агента (не в терминале):
```text
/plugin install polar-skills@claude-settings
```

2. **Вручную: положить файлы**
- Файл: `.claude/rules/shell-and-workflows.md` — Поле paths во frontmatter ограничивает файлы

### Codex

**AGENTS.md**
- Codex читает AGENTS.md: вставьте текст правила туда

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/rules/shell-and-workflows.mdc` — Во frontmatter: description, globs, alwaysApply

### GitHub Copilot

**Вручную: положить файлы**
- Файл: `.github/instructions/shell-and-workflows.instructions.md` — Поле applyTo задаёт, к каким файлам применять

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/rules/shell-and-workflows.md`

### Cline

**Вручную: положить файлы**
- Файл: `.clinerules/shell-and-workflows.md`

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/fcakyon/claude-codex-settings/tree/HEAD/plugins/polar-skills/skills/polar-local-environment/rules/shell-and-workflows.md

## Когда брать
- зайти в контейнер нужного сервиса для отладки
- выполнить разовую команду внутри Docker без интерактивной оболочки
- запустить миграцию базы данных или создать новую
- проверить состояние сервисов и просмотреть логи
- выбрать место запуска фронтенд- и бэкенд-тестов

## Примеры запросов агенту
- Подскажи, как запустить сервисы проекта и проверить их состояние через `dev docker`.
- Выполни текущую миграцию Alembic в контейнере `api` и покажи подходящую команду.
- Где запускать тесты web и backend в этом проекте?

## Похожие
- [shell-testing-framework](https://affpapa.org/nevibecode/skills/shell-testing-framework.md) — скилл · 441 установка
- [shell-scripting](https://affpapa.org/nevibecode/plugins/shell-scripting.md) — плагин · ★ 42780 у репозитория
- [error-diagnostics](https://affpapa.org/nevibecode/plugins/error-diagnostics.md) — плагин · ★ 42780 у репозитория
- [maui-shell-navigation](https://affpapa.org/nevibecode/skills/maui-shell-navigation.md) — скилл · 4200 установок
- [shell-scripting-pro](https://affpapa.org/nevibecode/agents/shell-scripting-pro.md) — субагент · 1479 установок
- [hyva-exec-shell-cmd](https://affpapa.org/nevibecode/skills/hyva-exec-shell-cmd.md) — скилл · 1400 установок

Из того же набора: [fcakyon/claude-codex-settings](https://affpapa.org/nevibecode/by/fcakyon/claude-codex-settings.md) — 113 карточек

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
