fan/how-i-make-fan
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
Как и почему я сделал fan
1 commit 1 branch 0 tags 110 KiB
Find a file
Exact
Aristman a6cf8f725d init commit
2026-09-12 17:59:38 +03:00
.fan init commit 2026-09-12 17:59:38 +03:00
demo-plan.md init commit 2026-09-12 17:59:38 +03:00
milestones.md init commit 2026-09-12 17:59:38 +03:00
README.md init commit 2026-09-12 17:59:38 +03:00
slides-outline.md init commit 2026-09-12 17:59:38 +03:00
speech.md init commit 2026-09-12 17:59:38 +03:00
talk-outline.md init commit 2026-09-12 17:59:38 +03:00
timeline.md init commit 2026-09-12 17:59:38 +03:00

README.md

Как я сделал FAN — комплект материалов для митапа

Доклад соло-разработчика (позывной Aristman) на митапе «Как я сделал FAN». История создания локального AI runtime-агента FAN (Fast Agents Network). Аудитория — разработчики. Формат: ~25–30 минут + живое демо.

📦 Что в комплекте

Этот каталог — полный набор исходников для подготовки и проведения доклада. Семь файлов, каждый отвечает за свою часть работы.

Файл Назначение Когда использовать
README.md Этот файл — обзор, навигация, чеклисты подготовки В первую очередь
timeline.md Хронология разработки по 6 фазам, забавные находки Подготовка слайдов, сторителлинг
milestones.md 10 ключевых инженерных вех — что, зачем, как устроено Содержание доклада, ответы на вопросы
talk-outline.md Структура доклада с таймингом по секциям Скелет выступления
speech.md Полный текст выступления от первого лица (~3250 слов вместе с пометками, 17 слайдов, 25–30 мин) Репетиция, опора во время доклада
slides-outline.md План ~17 слайдов: номер, заголовок, тезисы, визуал Сборка презентации
demo-plan.md План живого демо: 4 сценария, планы Б, чеклист техники День выступления

🎯 Для кого этот комплект

  • Докладчик (Aristman) — готовится к митапу.
  • Со-ведущий / модератор — хочет понимать структуру и тайминг.
  • Кто угодно — захочет повторить доклад на другом митапе или использовать как шаблон.

🗺️ Рекомендуемый порядок подготовки

Шаг 1. Понять материал (за 2–3 недели до митапа)

  1. Прочитать timeline.md целиком — увидеть историю целиком.
  2. Прочитать milestones.md — выбрать 3–4 вехи, которые попадут в доклад подробно.
  3. Бегло просмотреть talk-outline.md — понять тайминг и структуру.

Шаг 2. Собрать слайды (за 1–2 недели)

  1. Открыть slides-outline.md.
  2. Собрать слайды в выбранном инструменте (Figma, Keynote, Google Slides).
  3. Подтянуть визуалы: ascii-bar активности, карту монорепо, схему 10 воркеров, скриншоты демо.

Шаг 3. Написать/отредактировать речь (за 1 неделю)

  1. Открыть speech.md — это черновик, а не шпаргалка для заучивания.
  2. Прочитать вслух 2–3 раза, отмечая места, где язык «спотыкается».
  3. Переписать спорные куски своими словами — важно звучать живо, а не читать текст.
  4. Сократить или расширить секции под свой темп (средний темп речи — ~120 слов/мин).

Шаг 4. Спланировать демо (за 3–5 дней)

  1. Прочитать demo-plan.md целиком.
  2. Провести каждый сценарий минимум 3 раза на боевом окружении.
  3. Подготовить планы Б (скриншоты, видео, fallback-данные).
  4. Проверить, что всё работает offline-friendly — не полагаться на стабильный интернет.

Шаг 5. Отрепетировать (за 2–3 дня)

  1. Прогнать весь доклад с таймером — уложиться в 25–30 минут + 5 минут на демо.
  2. Записать себя на видео (телефон/Zoom), посмотреть — заметить «эканья», длинные паузы.
  3. Прогнать демо на том же оборудовании, что будет на митапе.

Шаг 6. Финальная проверка (накануне)

  1. Пройти чеклист «за день» (ниже).
  2. Проверить, что FAN собран и работает: fan --version, fan doctor.
  3. Подготовить два ноутбука: основной + резервный с тем же окружением.

✅ Чеклист за неделю

  • Прочитаны timeline.md, milestones.md, talk-outline.md
  • Слайды собраны на 80% (структура есть, можно докручивать визуал)
  • speech.md прочитан, переписан своими словами в проблемных местах
  • Демо-сценарии проверены на боевом FAN хотя бы один раз
  • Записано пробное видео, видны явные косяки речи
  • Подготовлены планы Б для всех демо (скриншоты/видео)
  • Согласован порядок выступления с модератором митапа
  • Подготовлены ответы на 5 ожидаемых вопросов (почему solo, как монетизация, как ИИ пишет код за тебя, чем отличается от Cursor, MCP — это что)

✅ Чеклист за день

  • FAN установлен и работает: fan --version, fan doctor
  • Все 4 демо-сценария проверены лично, ещё раз
  • Подготовлен резервный ноутбук с тем же FAN и теми же примерами
  • Резервный интернет (раздача с телефона) — на случай, если Wi-Fi митапа умрёт
  • Скриншоты и видео демо лежат в отдельной папке (для плана Б)
  • Слайды открываются на офисном проекторе (проверить шрифты, контраст)
  • Переходник/кабель для проектора (HDMI / USB-C — что на митапе)
  • Таймер на телефоне — для самоконтроля тайминга
  • Бутылка воды
  • Локально закешированы LLM-ключи или заготовлены offline-режимы демо

✅ Чеклист за час

  • Ноутбук не уйдёт в сон: настройки питания → «никогда»
  • Уведомления выключены (Do Not Disturb, звук на 0)
  • FAN запущен хотя бы раз — сессия прогрета
  • Демо-данные наготове: папка с репозиторием для code review, открыта FAN Store в браузере
  • Слайды открыты в полноэкранном режиме
  • Терминал в правильной директории, шрифт читаем с 5 метров
  • Телефон на беззвучном
  • Глубокий вдох. Поехали.

🎤 Ключевые цифры для доклада (для быстрого повторения)

Цифра Что означает
882 коммита в проекте
1 автор (соло)
5 месяцев срок разработки (10 апреля — 4 сентября 2026)
28 git-тегов (от 1.0.0 до 2.8.6)
3 переименования за первую неделю (FNA → FAN → FNA → FAN)
30.06.2026 финальный rebrand в Fast Agents Network
~139K строк TypeScript в src/
21 / 1027 LLM-провайдеров / моделей
10 типов воркеров в оркестраторе
11 / 10 / 14 пакетов / расширений / навыков
40 коммитов за один день в voice-ollama-tui (23.06)
3 тега за день выпущено 8 июля 2026
306 самый продуктивный месяц — август

📚 Источники фактов

Все цифры, даты, имена коммитов и хэши взяты из двух отчётов (не включены в этот комплект, чтобы не отвлекать):

  1. Git-хронология — таймлайн, даты коммитов, теги, забавные находки.
  2. Продукт и архитектура — стек, карта подсистем, демо-сценарии, метрики.

В текстах доклада запрещено выдумывать факты, даты и цифры. Если в источнике чего-то нет — лучше сказать «не считал» или «примерно», чем придумать.

🔗 Полезные ссылки (для финала доклада)

  • GitHub: github.com/Aristman/fan
  • Документация FAN: внутри репозитория (478 markdown-файлов)
  • Примеры расширений: packages/coding-agent/examples/ (60+ штук)

📝 Стиль и тон

  • От первого лица. «Я», «мне», «у меня». Никакого «мы» (кроме случаев, когда речь про FAN как продукт).
  • Разговорный. Без корпоративного жаргона. Можно «блин», «жесть», «ну вот».
  • Самоирония разрешена. Тройное переименование, voice-эпопея, ночные коммиты — всё это украшения, а не оправдания.
  • Честность. Если где-то накосячил — так и сказать. Аудитория это любит.
  • Без булшита. Лучше сказать «не знаю» или «не считал», чем выдумать цифру.

Удачного доклада! 🚀