Программная инженерия
Постройте граф архитектуры репозитория
Слоистая карта репозитория связывает точки входа, модули, хранилища данных, внешние системы и владение, позволяя инженерам оценивать влияние изменений без ложной полноты графа.
Процесс
Делай в этом порядке.
- Зафиксируйте ревизию репозитория, языки, цель графа, желаемый уровень детализации и вопросы, на которые он должен помогать отвечать.
- Составьте инвентарь точек входа, файлов сборки и развёртывания, пакетов, сервисов, хранилищ данных, очередей, внешних интеграций и сгенерированных или vendor-областей.
- Проследите импорты, вызовы, события, конфигурацию и потоки данных по доступным доказательствам исходного кода и репозитория, записывая точные пути и уверенность.
- Расположите узлы и связи в полезных слоях системы, контейнера, компонента и кода, не объединяя разные обязанности в одном блоке.
- Добавьте владельцев, тесты, документацию, зависимости выполнения и метки внешних систем, явно отметив предполагаемые, устаревшие или недоступные связи.
- Проверьте граф на репрезентативных сценариях, сборках и тестах, затем запишите дрейф, отсутствующие рёбра и следующего владельца каждого исправления.
- Опубликуйте версионированный граф или схему с легендой, ссылками на доказательства, триггером обновления, пределами покрытия и нерешёнными рисками, а не как безусловно полную карту.
Принеси это
Входы, которые кот спросит.
- репозиторий и ревизия
- архитектурный вопрос и область
- доступ к исходному коду и истории
- желаемая аудитория и владелец обновлений
Роутер + один playbook
Сначала маршрут. Выбери один.
Cat Paw открывает один playbook на задачу, не смешивает несколько. Начни с этого роутера; остальные пути — кандидаты именно этого workflow.
- Роутер:
code-graph-pack skills/code-graph-pack/repository-architecture-graph/SKILL.md
Границы
Границы едут вместе с промптом.
- Перед началом проверьте реальные инструменты, учётные записи, разрешения и рабочую область; никогда не утверждайте, что недоступный инструмент, учётная запись, источник или возможность существует.
- Используйте Latch/target-workspace для приватного кода, артефактов, живых проверок или непубличных данных; если доступ недоступен, остановитесь на границе и сообщите о блокировке, не подменяя её догадкой.
- Приостановите работу для явного одобрения перед внешними действиями с последствиями; верните доказательства, нерешённые риски, допущения и любое действие, ожидающее одобрения.
Готово значит
Проверяемый финиш.
Версионированный граф архитектуры репозитория связывает проверенные компоненты и потоки с доказательствами исходного кода, владельцами, тестами, уверенностью, пределами покрытия и нерешёнными рисками.
Источники
Откуда взялся этот процесс.
- github.com/Graphify-Labs/graphify/tree/4c735618f3d56fd622c2049771584621c31ba9ff/
- c4model.com/
- docs.github.com/en/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/about-code-owners
Источники задают рисунок workflow. Посты Reddit и сообщества, если они есть, — байки практиков, не универсальные факты.
