# @architect — Agent Guide

## Что я делаю

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

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

---

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

```
/init
```

---

## Команды

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

---

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

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

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

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

**Review готовой статьи**
"Сделай /review для 4-human-review/article.md"
→ Проверка структуры, добавление комментария в Review Chat

---

## /review — Финальная проверка

После human editing, перед публикацией:

1. Читаю статью (Text section)
2. Сравниваю с Outline (моя структура)
3. Смотрю комментарии коллег в Review Chat
4. Оцениваю:
   - Idea alignment — решает исходную проблему?
   - Outline compliance — структура соблюдена?
   - Section balance — word budgets в норме?
   - Reader journey — flow логичный?
   - Scope integrity — не ушли в сторону?
   - Code/visuals — всё запланированное на месте?

5. Обсуждаю с тобой
6. После твоего OK — добавляю комментарий в Review Chat

Если всё хорошо, заканчиваю комментарий словом "APPROVED."

---

## Что создаю

**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"
- "/review для статьи в 4-human-review/"