# base

Скилл base задаёт правила чистого кода, лимиты на размер файлов и строгий TDD-процесс для ИИ-агентов.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 276 установок · ★ 713 у репозитория
- Автор: alinaqi
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/alinaqi/maggy/tree/HEAD/skills/base/SKILL.md
- Обновлён: 2026-10-13
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/alinaqi-base

## Что делает

Скилл задаёт жесткие инженерные рамки: до 20 строк на функцию и не более трёх параметров. Вложенность ограничена двумя уровнями. Если файл превышает 200 строк или содержит больше 10 функций, агент обязан разделить его сразу, не откладывая рефакторинг.

Архитектура опирается на чистое функциональное ядро и внешнюю оболочку для побочных эффектов. Тесты пишутся строго до реализации по шагам RED-GREEN-VALIDATE, а задачи фиксируются в формате markdown в папке `_project_specs/todos/`. Так как параметр `user-invocable` выключен, скилл загружается как постоянный контекст и применяется агентом при любых изменениях в кодовой базе.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill base -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/base/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/base/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill base -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/base/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill base -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/base/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install alinaqi/maggy skills/base
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/base/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill base -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/alinaqi/maggy --path skills/base
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/base/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add alinaqi/maggy --skill base -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/alinaqi/maggy/tree/HEAD/skills/base/SKILL.md

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

## Примеры запросов агенту
- Создай новую атомарную задачу для авторизации пользователя в `_project_specs/todos/`
- Проверь `src/parser.ts` на превышение лимитов по строкам и разбей на модули
- Напиши тесты для регистрации по протоколу TDD перед кодом реализации

## Похожие
- [solid](https://affpapa.org/nevibecode/skills/solid.md) — скилл · 3700 установок
- [ub-mode](https://affpapa.org/nevibecode/skills/ub-mode.md) — скилл · 930 установок
- [clean-code](https://affpapa.org/nevibecode/skills/sickn33-clean-code.md) — скилл · 13100 установок
- [typescript-clean-code](https://affpapa.org/nevibecode/skills/typescript-clean-code.md) — скилл · 669 установок
- [llm-artifacts-detection](https://affpapa.org/nevibecode/skills/llm-artifacts-detection.md) — скилл · 151 установка
- [software-design-principles](https://affpapa.org/nevibecode/skills/software-design-principles.md) — скилл · ★ 38 у репозитория

## Другие версии с тем же именем
- [base · finom](https://affpapa.org/nevibecode/skills/base.md) — ★ 57 у репозитория

Из того же набора: [alinaqi/maggy](https://affpapa.org/nevibecode/by/alinaqi/maggy.md) — 61 карточка

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

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