---
name: n-publish-telegram
description: >-
  Підготовка матеріалу з поточного контексту для публікації в Telegram-каналі команди
---

# Публікація в Telegram

Підготовка матеріалу для публікації в Telegram-каналі команди (розробники + менеджери).

## Формат Telegram

Telegram підтримує моноширний шрифт через markdown-розмітку:

- `` `inline code` `` — для inline
- ` ```pre``` ` (потрійні backticks) — для блоку коду / моноширного тексту

Весь пост оформлюй як **один блок** потрійних backticks, щоб текст був моноширним.

## Workflow

1. **Визнач контекст** — проаналізуй поточну розмову: яка проблема вирішувалась, що було зроблено, який результат.

2. **Сформуй пост** за шаблоном нижче.

3. **Виведи готовий текст** — користувач копіює його в Telegram.

## Шаблон посту

```markdown
#тег

📌 <Короткий заголовок>

Проблема:
<1-3 речення — що було не так / яке завдання>

Рішення:
<2-5 речень — що зробили, який підхід>

Деталі:
• <ключовий момент 1>
• <ключовий момент 2>
• <ключовий момент 3>

Результат:
<1-2 речення — що отримали, яка вигода>
```

Тег (один хештег першим рядком поста) — підбір за темою:

- якщо публікація стосовно AI, то `#ai`
- якщо публікація стосовно npm модуля, то `#npm`
- якщо публікація стосовно розробки, то `#dev`
- якщо публікація стосовно інфраструктури, скриптів, налаштувань, ефективності коду чи безпеки, то `#sre`

## Правила

- Мова: українська, технічні терміни — англійською
- Обсяг: 500–1500 символів (оптимально для Telegram)
- Без зайвих вступів і водянистих фраз
- Конкретика: назви файлів, бібліотек, команд — якщо доречно
- Тег: рівно 1 хештег першим рядком поста (#devops, #frontend, #bugfix, #refactoring, #CI, #performance тощо)
- Emoji: лише структурні (📌 для заголовка, • для списку), не перевантажувати
- Цільова аудиторія: розробники та менеджери — тому пояснюй простою мовою, без надмірного жаргону
- Весь текст повинен бути всередині потрійних backticks для моноширного відображення в Telegram

## Приклад

````
```
#dev

📌 Міграція з Prettier на oxfmt

Проблема:
Prettier повільно форматував великі файли і
конфліктував з ESLint при роботі з Vue SFC.

Рішення:
Замінили Prettier на oxfmt — нативний
форматер від OXC. Оновили VS Code settings,
видалили prettier-конфіги, додали .oxfmtrc.json.

Деталі:
• oxfmt працює в 10-50x швидше за Prettier
• Єдиний конфіг .oxfmtrc.json у корені
• CI перевіряє форматування через lint-js

Результат:
Форматування працює миттєво при збереженні,
зникли конфлікти між форматером і лінтером.
```
````
