# scripts

Правило scripts задаёт архитектурные ограничения для скриптов mavericks-os: разделяет чтение и запись, запрещает внешние зависимости npm и закрывает утечки строк при сборке.

- правило · `type=rule` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline · ★ 121 у репозитория
- Автор: yahor-punko
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/yahor-punko/mavericks-os/tree/HEAD/.claude/rules/scripts.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/rules/scripts

## Что делает

Правило регламентирует разработку операторских утилит в папке `scripts/`. Скрипты отчётности вроде `dashboard`, `--snapshot` и валидатора обязаны оставаться строго в режиме чтения без побочных эффектов на диск. Изменять артефакты разрешено только ритуальным скриптам управления задачами, таким как `new-task` или `close-session`.

Вся базовая автоматизация пишется на чистом Node.js без внешних пакетов npm. Единственное исключение сделано для `@anthropic-ai/sdk` в `mavp-skill-reflect.js`, причём библиотека подключается лениво через `try/catch`. Без сторонних модулей окружение работает быстрее и не ломается на машинах без каталога `node_modules`.

Для каждого нового файла правило требует классификации в `scripts/publish-manifest.json`. В релизных файлах запрещено оставлять приватные пути `/Users/`, ключи и токены даже внутри обычных комментариев — сканер публикаций остановит фиксацию изменений при любом точном совпадении.

## Установка

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

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

### Codex

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

### Cursor

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

### GitHub Copilot

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

### Windsurf (Devin Desktop)

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

### Cline

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/yahor-punko/mavericks-os/tree/HEAD/.claude/rules/scripts.md

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

## Примеры запросов агенту
- Добавь вспомогательную функцию в `scripts/mavp-operator-lib.js` без сторонних npm-зависимостей
- Зарегистрируй созданный файл скрипта в `scripts/publish-manifest.json` со статусом ship
- Проверь, что отчётный скрипт не пытается перезаписать `PROCESS_STATE.md`

## Похожие
- [automation-scripts](https://affpapa.org/nevibecode/skills/automation-scripts.md) — скилл · 152 установки
- [github-workflow-automation](https://affpapa.org/nevibecode/skills/ruvnet-github-workflow-automation.md) — скилл · 1300 установок
- [huawei-cloud-flexus-l-server-scripts-excute](https://affpapa.org/nevibecode/skills/huawei-cloud-flexus-l-server-scripts-excute.md) — скилл · 203 установки
- [korean-jangbu-for](https://affpapa.org/nevibecode/skills/korean-jangbu-for.md) — скилл · 11500 установок
- [csharp-scripts](https://affpapa.org/nevibecode/skills/csharp-scripts.md) — скилл · 4900 установок
- [HTML to Markdown — Clean Conversion, Scripts Stripped](https://affpapa.org/nevibecode/mcp/html-to-markdown-clean-conversion-scripts-stripped.md) — MCP-сервер · 4235 установок

Из того же набора: [yahor-punko/mavericks-os](https://affpapa.org/nevibecode/by/yahor-punko/mavericks-os.md) — 16 карточек

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

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