Контекст проекта в GitHub Issues: делегируй агенту

Сережа Рис · 21 January 2026

Созвон с Максом по курсу. Час обсуждений — аудитория, структура, цены, воронка, платежи. Granola записала и сделала саммари. Контекст есть. Где его хранить, чтобы не потерялся?

Проблема

Контекст из Granola — страница текста. Нас двое в проекте. Куда положить, чтобы версионировалось, читалось агентами через API и не терялось в чатах?

docs/ в репо — нужен коммит для каждой правки. GitHub Wiki — отдельный клон, неудобно. Notion — нет нормального API для агентов. README — засоряется.

Скопировал контекст из Granola в Claude Code и попросил разобраться.

Что попросил

Claude Code на Opus 4.5 запустил три поиска параллельно: GitHub docs, knowledge management для стартапов, GitHub Projects для маленьких команд. Нашёл ADR — Architecture Decision Records, паттерн фиксации решений через Issues.

Что вернул

По-моему, Pinned Issue — идеальный вариант для маленькой команды. gh issue view читает, gh issue edit обновляет. История в комментариях.

Что сделал агент

Скинул ему саммари из Granola. За минуту он сам создал всё в GitHub:

• Создал label context (его не было)
• Создал issue со структурой: аудитория, курс, маркетинг, платежи, инфраструктура
• Закрепил его
• Добавил четыре mermaid-диаграммы в комментарий: воронка, техническая архитектура, стек участника, контент-пайплайн

Вручную это часа полтора. С диаграммами — все три.

Как пользоваться

Теперь в начале сессии пишу:

Агент сам найдёт pinned issue с label context, распарсит структуру. Когда что-то меняется:

Не надо помнить номера issues или синтаксис CLI. Агент знает где лежит контекст и как его обновить.

Минус: надо приучить себя говорить “обнови контекст”, а не скидывать информацию в чат. Но это дело привычки.

Источники

• GitHub Docs: Best practices for repositories
• Addy Osmani: My LLM coding workflow going into 2026
• Architecture Decision Records

Об авторе

Подписаться на обновления — @sereja_tech