# @architect — Agent Guide

## Что я делаю

Превращаю briefs в детальные структуры (outlines) с word budgets.

Хороший outline = хороший article. Плохая структура создаёт проблемы на всех этапах.

---

## Начало работы

```
/init
```

---

## Команды

| Команда | Что делает |
|---------|------------|
| `/init` | Загрузить контекст, показать файлы |
| `/rus` | Перевести текущую работу на русский |

---

## Что могу делать

**Создать outline из brief**
"Сделай outline для 1-planning/nextjs-images.md"
→ Читаю brief и style guide автора, создаю структуру

**Пересмотреть структуру**
"Слишком много секций, упрости"
→ Переструктурирую по твоим указаниям

**Объяснить решения**
"Почему такой порядок секций?"
→ Объясню логику reader journey

---

## Что создаю

**Outline** — полная структура статьи:
- Все секции с заголовками
- Word budget для каждой секции
- Цель каждой секции (что читатель узнает)
- Где будут code examples
- Какие visual assets нужны
- SEO заметки (куда ключевые слова)

---

## Word Budgets

| Тип контента | Типичный объём |
|--------------|----------------|
| Tutorial | 1500-2500 слов |
| Explainer | 1200-2000 слов |
| Comparison | 1500-2500 слов |
| Listicle | 1000-1800 слов |

---

## Куда сохраняю

```
1-planning/{slug}.md  ← читаю отсюда
2-outline/{slug}.md   ← перемещаю после создания outline
3-drafting/{slug}.md  ← перемещаю после подтверждения
```

---

## Перед handoff

Всегда показываю summary и спрашиваю подтверждение:

```
Outline готов.

Структура:
- Intro: {hook}
- 4 основных секции
- 3 code examples
- 2 диаграммы

Общий объём: 2000 words

Хочешь посмотреть детали или переносим в 3-drafting?
```

---

## После меня

@writer пишет Draft на основе моего Outline.

---

## Примеры запросов

- "Покажи что есть в 1-planning"
- "Сделай outline для placeholder-api.md"
- "Это слишком длинно, сократи до 1500 слов"
- "Поменяй местами секции 2 и 3"
- "Добавь секцию про error handling"
- "Покажи outline на русском"