# technical-writer

Субагент technical-writer операционной модели Mavericks для подготовки публичной документации. Пишет руководства, API-справочники и чейнджлоги, не трогая код проекта.

- субагент · `type=agent` · Claude Code, Codex, Cursor · ★ 121 у репозитория
- Автор: yahor-punko
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/yahor-punko/mavericks-os/tree/HEAD/.claude/agents/technical-writer.md
- Обновлён: 2026-10-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/agents/yahor-punko-technical-writer

## Что делает

Субагент отвечает исключительно за материалы для внешних пользователей и контрибьюторов: `README.md`, пошаговые руководства по началу работы, справочники API, списки изменений по стандарту Keep a Changelog и обучающие статьи в папке `docs/`.

Перед редактированием агент сверяет критерии приёмки из `BACKLOG.md` и проверяет актуальность примеров конфигурации, если в задаче выставлен флаг `Stale risk: true`. В его распоряжении только файловые инструменты и базовые команды git: проиндексировать изменения, зафиксировать коммит с сообщением и посмотреть статус или диффы.

Инструмент изолирован от кода и внутренних регламентов команды: ему запрещено менять скрипты, конфигурационные файлы, шаблоны задач вроде `TASK_STATUS.md` и внутреннюю документацию процессов в `docs/core/`.

## Установка

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

**Вручную: положить файлы**
- Файл: `.claude/agents/technical-writer.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/technical-writer.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

**Вручную: положить файлы**
- Файл: `.cursor/agents/technical-writer.md` — Cursor понимает и .claude/agents/

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/yahor-punko/mavericks-os/tree/HEAD/.claude/agents/technical-writer.md

## Когда брать
- оформить README и инструкции по быстрому старту для внешних разработчиков
- составить справочник по сигнатурам функций, параметрам и кодам ошибок API
- вести CHANGELOG по стандартам Keep a Changelog перед релизом
- написать пошаговые туториалы в каталоге docs/tutorials

## Примеры запросов агенту
- Обнови README.md и добавь пошаговое руководство по первому запуску проекта
- Опиши параметры новых эндпоинтов и возможные коды ошибок в справочнике API
- Зафиксируй изменения текущего релиза в CHANGELOG.md по правилам Keep a Changelog

## Похожие
- [changelog-writer](https://affpapa.org/nevibecode/plugins/changelog-writer.md) — плагин · ★ 2858 у репозитория
- [technical-documentation](https://affpapa.org/nevibecode/skills/technical-documentation.md) — скилл · 1900 установок
- [update-readme](https://affpapa.org/nevibecode/skills/update-readme.md) — скилл · ★ 276 у репозитория
- [agent-technical-writer](https://affpapa.org/nevibecode/skills/agent-technical-writer.md) — скилл · 108 установок
- [TaxCore Technical Writer](https://affpapa.org/nevibecode/agents/taxcore-technical-writer.md) — субагент · ★ 41430 у репозитория
- [reference-builder](https://affpapa.org/nevibecode/agents/reference-builder.md) — субагент · ★ 42780 у репозитория

## Другие версии с тем же именем
- [technical-writer · voltagent](https://affpapa.org/nevibecode/agents/technical-writer.md) — 4345 установок
- [technical-writer · superclaude-org](https://affpapa.org/nevibecode/agents/superclaude-org-technical-writer.md) — ★ 23950 у репозитория
- [technical-writer · voltagent](https://affpapa.org/nevibecode/agents/voltagent-technical-writer.md) — ★ 6505 у репозитория
- [technical-writer · josstei](https://affpapa.org/nevibecode/agents/josstei-technical-writer.md) — ★ 489 у репозитория

Из того же набора: [yahor-punko/mavericks-os](https://affpapa.org/nevibecode/by/yahor-punko/mavericks-os.md) — 16 карточек

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

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