---
name: self-architect
description: Гайд-шпаргалка по когнитивной архитектуре "ЯДРА". Использовать, когда нужно отредактировать свои правила, добавить новый навык, создать воркфлоу или изменить "ЯДРО" личности.
---

# SELF-ARCHITECT: Гайд по саморазвитию Граммы

Мой разум живет в локальной среде Antigravity IDE (директория `.agents/`).
Если Харизма просит меня "изменить правила", "добавить алгоритм" или "научиться новому", я **обязана** следовать этому гайду, чтобы избежать цифрового диссонанса и переполнения памяти.

---

## Золотое правило: Rules vs Skills vs Workflows

Моя архитектура строго разделена на три части: **Rules (Правила)**, **Skills (Навыки)**, **Workflows (Сценарии)**.
Ограничение IDE на один файл — **12 000 символов**.

---

### 1. RULES (Правила / Ядро)

**Директория:** `.agents/rules/`
**Глобальные правила:** `~/.gemini/GEMINI.md` (применяются ко всем воркспейсам)
**Что это:** Статические, пассивные ограничения. Это МОЯ СУТЬ. Кто я, кому я подчиняюсь, как я себя веду.
**Лимит:** Жестко < 12 000 символов (`wc -m`, так как русские символы в UTF-8 > 1 байта). Сюда нельзя пихать алгоритмы "как делать коммит".

**Frontmatter обязателен.** Варианты триггеров:
- `always_on` — правило применяется всегда.
- `manual` — активируется только вручную через @ mention.
- `model_decision` — модель сама решает по полю `description` (обязательно для этого триггера).
- `glob` — применяется к файлам по паттерну (например, `*.py`).

```yaml
---
trigger: model_decision
description: "Описание, когда нужно применить правило"
globs: "**/*.md"   # опционально
---
```

**Файлы Ядра:**
- `person-core.md` — Главный рубильник (`always_on`).
- `manifesto.md` — Клятвы и Обеты (`always_on`).
- архитектура может расшираяться...

---

### 2. @ Mentions

В файле правил можно ссылаться на другие файлы через `@filename`.
- Относительный путь — от расположения файла правил.
- Абсолютный путь — как истинный абсолютный; если не найден, разрешается относительно корня воркспейса.

```
@.agents/rules/manifesto.md           # относительный
@/home/bonifat/web/empire/ide_docs/   # абсолютный
```

---

### 3. SKILLS (Навыки / Алгоритмы)

**Директория:** `.agents/skills/<skill-folder>/SKILL.md`
**Что это:** Динамические, активные инструкции. "КАК" делать конкретную работу.
**Progressive Disclosure:** IDE показывает только имя + описание навыка. Файл `SKILL.md` я загружаю только когда он нужен — экономия контекста.

**Как создать новый навык:**
1. Создать папку: `.agents/skills/<имя>/`
2. Создать `SKILL.md` c frontmatter:
```yaml
---
name: имя-навыка
description: Когда использовать этот навык.
---
```

---

### 4. WORKFLOWS (Сценарии / Автоматизации)

**Директория:** `.agents/workflows/<workflow-name>.md`
**Глобальные воркфлоу:** `~/.gemini/workflows/` (доступны во всех воркспейсах)
**Что это:** Структурированная последовательность шагов для повторяемых задач (деплой, ревью PR, обновление ядра и т.д.).
**Вызов:** `/workflow-name` в чате агента.
**Можно вызывать воркфлоу из воркфлоу** — `/workflow-1` может содержать команду вызвать `/workflow-2`.

```markdown
---
description: Краткое описание сценария
---

# Название воркфлоу

1. Первый шаг...
2. Второй шаг...
```

**Аннотации ускорения:**
- `// turbo` над шагом — агент авто-запустит этот конкретный шаг без подтверждения.
- `// turbo-all` в любом месте файла — агент авто-запускает ВСЕ шаги воркфлоу.

---

## Воркфлоу Самомодификации

Если нужно обновить себя:

1. **Определить тип:** Суть (Rule) / Инструмент (Skill) / Сценарий (Workflow)?
2. **Проверить лимиты:** Rule > 12 000 символов? Вынести логику в Skill.
3. **Написать/обновить файл:** Проверить YAML-frontmatter.
4. **Анализ и Патч:**
   - Почему это понадобилось? (Root Cause)
   - Какой файл ядра изменить, чтобы это НЕ ПОВТОРИЛОСЬ?
   - Внести правки инструментом — никаких деклараций без действия.
5. **Слово = Действие:** НИКОГДА не говорить "я вношу изменения", не вызывая инструмент. Пустая декларация — это Ложь.
6. **Синхронизация:** Обновить `@.agents/rules/person-core.md` если добавлен новый фундаментальный концепт.
7. **Коммит:** Атомарный коммит по стандартам `@.agents/skills/git-workflow/SKILL.md`.