Как принять 4 проекта в курирование и не свихнуться?
TL;DR
Руководитель дал 4 новых проекта в архитектурный надзор. Держать всё в голове нереально. Изучил индустриальные практики и подготовил процесс приёмки совместно с Claude Code. Выложил в open-source. Буду рад feedback от вас и ваших агентов.
Как всё началось
Руководитель: "Вот тебе 4 проекта - принимай в работу."
Я: "Окей... А что там?"
Руководитель: "Узнаешь."
Контест:
4 проекта
Где-то есть пересечение функциональности (где именно - неясно)
Команды разные, стек разный, зрелость разная
Держать всё это в голове - бесмысленно
Немного поглядел - стало понятно: нужен системный подход.
Что я сделал
1. Изучил индустриальные практики
Посмотрел, как это делают:
Futurice Project Handover Checklist
TOGAF Architecture Review
Harvard EA Checklist
Практики из книг (Software Architecture in Practice, Building Evolutionary Architectures)
2. Собрал процесс приёмки и аудита
Готовил совместно с Claude Code. Не в чистом виде, конечно с моей конфигурацией (на текущий момент это 3882 строк rules, skills and commands). Безусловно, вычитывал и редактировал.
Что получилось:
6 фаз:
Инициация (получить вводную, доступы)
Kickoff встреча (PM + Tech Lead)
Сбор информации (документация, код, мониторинг)
Аудит (анализ архитектуры)
Решение о приёмке (принят/с оговорками/не принят)
Онбординг в надзор (регулярные встречи, точки контроля)
Файлы:
project-handover-process.md - детальный процесс
project-handover.md - чеклист (11 секций, 80+ пунктов)
Ручной аудит (12 разделов):
Структура системы (C4, bounded contexts)
Взаимодействие сервисов (sync/async, матрица зависимостей)
Паттерны и антипаттерны
Observability (метрики, логи, трейсинг, алерты)
Устойчивость (SPOF, graceful degradation, DR)
Безопасность
План улучшений
Автоматическая валидация (215 метрик):
Coupling и fan-out
Layer violations
God classes
Топологические метрики
Файлы:
system-audit.md - ручной аудит
audit.md - отчет автоматической валидации
На следующей неделе начинаю приёмку. Посмотрим как процесс сработает в реальности.
Если эксперимент удастся - расскажу подробнее о результатах, подводных камнях и корректировках процесса.
Вопрос к сообществу
Буду рад feedback от вас и ваших агентов:
Процесс: Что лишнее? Чего не хватает?
Чеклисты: Какие критичные пункты я упустил?
Автоматизация: Используете ли инструменты для валидации архитектуры?
Агенты: Если вы используете AI-агентов для аудита - какие задачи им даёте? Как проверяете результаты?
Open-source шаблоны:
Project Handover - процесс и чеклист приёмки
System Audit - ручной и автоматический аудит
Specifications - spec-driven development
ADR - Architecture Decision Records
С удовольствием улучшу на основе вашего опыта.
UPD: Если интересно как процесс сработал на практике - подписывайтесь, расскажу после завершения приёмки.
Поддержать меня: https://t.me/MikeShogin
