Правила хакатона

Организация и связь

1. У нас есть общий канал хакатона. Все вопросы (если не личные) постим туда.
2. Личные вопросы — Юре-Леше.
3. Демонстрация проектов — вопрос к Дине (формат и время уточняем до старта, чтобы в пятницу никто не искал).
4. Начинаем в пятницу, продолжаем в субботу.

Минимальный набор на хакатон

5. Что нужно с собой:

• Ноутбук.
• Доступ к git.i-free.ru — здесь сохраняем проекты.
• Редактор: VS Code или Cursor, или Claude Code Desktop. По умолчанию рекомендуем VS Code.

6. Если ещё ничего не делали в вайбкодинге — гляньте заранее:

• Любое видео по запросу «vscode claude code основы».
• code.claude.com/docs/en/vs-code (или ru-версия)
• thecode.media/claude-code-gajd

7. Если работаете в CLI — всё примерно так же. Можно ничего не ставить, кроме самого Claude. Доки — на сайте Claude.

Документация проекта

8. В корне репозитория заведите README.md:

• название кейса;
• в чём боль;
• что делает агент / решение;
• как запустить;
• 1–2 метрики (сколько времени или действий экономим).

Жюри смотрит именно на боль + цифру — без README демо проседает.

9. CLAUDE.md в корне — короткий контекст для агента: стек, структура, что НЕ трогать. Сильно экономит время в Claude Code. Минимальный шаблон — в конце документа.

10. Markdown везде, где удобно: заметки, ТЗ, промпты. Их потом легко скармливать модели.

Git-гигиена

11. Отдельная ветка или репозиторий на команду, осмысленные коммиты.
12. Пушим регулярно (хотя бы пару раз за сессию) — это и есть ваш бэкап. Не держим всё только локально.
13. .gitignore заводим сразу: туда .env, ключи, токены, выгрузки данных. Секреты в git не коммитим (даже в приватный репо).

Данные и безопасность

14. Работаем на синтетике или обезличенных данных. Реальный прод и боевую инфру не трогаем.
15. Любые запуски и тесты — только внутри нашего периметра. Песочницы у нас (пока) нет.
16. В чат с LLM не вставляем: секреты, токены, содержимое .env, реальные перс.данные, внутренние адреса/хосты, логины и пароли. Если нужно показать модели конфиг — заменяем значения на заглушки.

Скоуп и демо

17. Один работающий AI-сценарий лучше четырёх недоделанных продуктов. Сужайте до одного MVP.
18. Рабочее демо важнее красивых слайдов. На показ принесите живой сценарий + одну цифру боли.

И главное

19. Сейчас нет никаких ЭКСПЕРТОВ — есть постоянно обучающиеся люди. Делитесь опытом, спрашивайте, учитесь.

Минимальный шаблон CLAUDE.md

Скопируйте в корень своего репозитория и заполните под свой кейс — полный шаблон на странице Шаблон CLAUDE.md.