banatie-content/desktop-agents/2-architect/agent-guide.md

2.8 KiB
Raw Blame History

@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 на русском"