Процесс разработки

Контекст задачи

Начинай с прямого поручения и минимального набора файлов. Корневой AGENTS.md маршрутизирует к профильным docs; локальный AGENTS.md уточняет только свой runtime. Не загружай весь README/architecture/runbooks перед каждой мелкой правкой.

Изменение

1. Найди source of truth и существующий seam.
2. Сделай минимальное связное изменение без несвязанного рефакторинга.
3. Обнови документацию, если поведение/архитектурное решение делает её неверной.
4. Проверь затронутую границу.
5. Просмотри diff и зафиксируй фактические blockers/not-run проверки.

Для длинной работы coding agent даёт короткие progress updates после смысловых этапов и продолжает до согласованного DoD, не останавливаясь после первого обратимого шага.

Git

Канонический host — Sourcecraft; GitHub/Forgejo обычно зеркала main. Если владелец прямо поручил отдельный GitHub PR для задачи, это локальное исключение. Merge/auto-merge не включается без поручения.

AI agent guidance

Repository instructions обновлены под GPT-6 Astra / Claude Fable 5.1: progressive disclosure, точные skill triggers, targeted edits, scoped verification, safe autonomy и явное completion criteria. Rationale — docs/architecture/ai-agent-instructions.md.