HSE/tgit

Files

T

ElebobaandClaude Opus 5.5 d34bc33aeb docs: ТЗ v2 — QR-доступ, меню разделов, коммит по дереву, агент со стражем, общие алерты

ADR-011 (QR-приглашения), ADR-012 (командная модель), ADR-013 (агент логов).

Refs #24

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

2026-10-13 22:50:31 +03:00

3.7 KiB

Raw Blame History

CLAUDE.md — Руководство для Claude Code

⚡ ПЕРВОЕ ДЕЙСТВИЕ В КАЖДОЙ СЕССИИ

set -a; . ./.env 2>/dev/null; set +a

Переменные: GITEA_URL, GITEA_TOKEN, GITEA_USER, GITEA_REPO, SOURCECRAFT_TOKEN (токены — секрет, в чат не печатать).

Где	Что	Remote
Gitea `HSE/tgit`	основной: код, issues, PR, ревью	`origin`
SourceCraft `rogachevegorushka/tgit`	зеркало (push-mirror из Gitea) + CI/CD	`sourcecraft` (только чтение)

⛔ В SourceCraft ничего не пушим и не мержим — зеркало перезапишет (ADR-010).

Что мы строим

Telegram-бот «git в телеграме» для команды (учебный проект НИУ ВШЭ, курс Python). Вход — только по QR-приглашению. Меню: Коммит (навигация по дереву репозитория загрузок, черновик, сообщение, Push → CI/CD в SourceCraft с уведомлениями) · Статус (контейнеры, health, проверки) · Логи (хвост, свой grep, LLM-агент со стражем) · Алерты (всем участникам, список).

ТЗ: docs/SPEC.md · Архитектура: docs/ARCHITECTURE.md

Процесс работы

Перед кодом — подход в 2–3 предложениях при архитектурных развилках.
Код по модулям; пользователь проверяет после каждого; комментарии — только когда WHY неочевиден.
Язык общения — русский.

Карта документации

Задачи — в Gitea Issues, не в файлах.

Файл	О чём
`docs/SPEC.md`	ТЗ: требования, сценарии, критерии приёмки
`docs/ARCHITECTURE.md`	Компоненты, потоки данных, деплой
`docs/DECISIONS.md`	ADR: архитектурные решения (что и почему)
`docs/QUESTIONS_IDEAS.md`	Открытые вопросы, бэклог идей
`docs/dev/WORKFLOW.md`	Регламент: ветки, коммиты, PR, жизненный цикл задачи
`docs/dev/ISSUE_TEMPLATE.md`	Шаблон тела issue
`docs/dev/GITEA_API.md`	Gitea API: issue, PR, зависимости, зеркало
`docs/dev/SOURCECRAFT_API.md`	SourceCraft API: CI-прогоны, логи, секреты

TL;DR — работа

Задача = Issue в Gitea. Нет issue — нет кода.
Ветка от dev: <type>/<issue#>-<slug>. PR в dev (в Gitea); dev → main — только человек.
Гейт зелёный: lint + тесты перед PR.
Завершил → push + PR сразу.
Лог выполнения — в issue (### YYYY-MM-DD), архитектурные решения — в DECISIONS.md.
Секреты (токен бота, deploy-ключ, ключи LLM) — только в .env, в чат и git не попадают.

3.7 KiB Raw Blame History Unescape Escape