
--- name: ai-protocols description: Применяет протоколы работы с AI при создании и обновлении документации: верификация (стоп‑кран), каноничность (SSOT), версионирование. Используется при работе с NFR, Core документами, диаграммами C4 и PlantUML. version: 1.0 lastUpdated: 2026-02-04 --- # Протоколы работы с AI (Skill) ## Когда применять - Обновление Core документов - Любая задача, затрагивающая несколько модулей - Создание/изменение диаграмм C4 (LikeC4) и последовательностей (PlantUML) ## 1)
--- name: architecture-review description: Архитектурный review по чек-листу: границы, NFR, безопасность, интеграции, эксплуатация. version: 1.0 lastUpdated: 2026-02-04 --- # Architecture Review (Skill) ## Когда применять - Перед слиянием больших изменений - Перед релизом - При появлении новых интеграций или новых bounded contexts ## Чек-лист - Границы контекстов чёткие, нет прямых зависимостей на чужие БД. - NFR соблюдаются, измеримость подтверждена. - Безопасность: OIDC, ABAC, Vault, TLS/
Ведёт C4 модель (LikeC4) и правила для Context/Container/Component.
--- name: domain-modeling-ddd description: Практики DDD для доменной модели: bounded contexts, агрегаты, инварианты, события. version: 1.0 lastUpdated: 2026-02-04 --- # Domain Modeling (DDD) (Skill) ## Когда применять - Выделяем bounded contexts и их контракт - Проектируем агрегаты и инварианты - Определяем доменные события и интеграционные события ## Минимальные правила - Границы bounded context фиксировать явно и не размывать “общими” моделями. - Агрегат — единица транзакционной целостнос
Экспортирует и пересобирает диаграммы LikeC4 в PNG с белым фоном через src/scripts/export_png_white.py.
Единый workflow markdownlint для репозитория (конфиг, запуск, типовые правки).
--- name: observability-architecture description: Наблюдаемость: логи/метрики/трейсы, корреляция, алерты, SLI. version: 1.0 lastUpdated: 2026-02-04 --- # Observability Architecture (Skill) ## Когда применять - Определяем обязательные поля логов и корреляцию - Проектируем метрики и SLI для SLO - Настраиваем алертинг по деградациям ## Правила - Логи JSON, поля: `correlationId`, `tenantId`. - Метрики: `/metrics` для каждого сервиса, p95/p99 латентности. - Трейсы: OpenTelemetry, связка по `corr
Поддерживает репозиторий как github-шаблон (пути, ссылки, структура, отсутствие мусора).
Создаёт и поддерживает примеры проектов и кода в src/examples (dotnet/angular/python).
--- name: capacity-planning description: Capacity planning: оценка нагрузки, узкие места, масштабирование, квоты, тест-план. version: 1.0 lastUpdated: 2026-02-04 --- # Capacity Planning (Skill) ## Когда применять - Перед проектированием инфраструктуры и лимитов - Перед вводом новых тяжёлых функций (поиск, экспорт, отчёты) - Перед публичным релизом ## Артефакты - Таблица сценариев нагрузки (RPS, payload, p95/p99) - Лимиты и квоты (per tenant, per user, per endpoint) - План нагрузочного тести
Фиксирует архитектурные решения как короткие decision records.
--- name: data-architecture description: Архитектура данных: границы БД, консистентность, миграции, кэширование, поиск. version: 1.0 lastUpdated: 2026-02-04 --- # Data Architecture (Skill) ## Когда применять - Проектируем хранение данных по bounded contexts - Выбираем консистентность и стратегии кэша - Планируем поиск и индексацию ## Правила - Database per Service: нет прямых запросов в чужие БД. - Контрактные данные наружу — только через API или события. - Миграции версионируются и применя
--- name: integration-patterns description: Паттерны интеграции между модулями: sync/async, контракты, идемпотентность, outbox. version: 1.0 lastUpdated: 2026-02-04 --- # Integration Patterns (Skill) ## Когда применять - Проектируем взаимодействия между bounded contexts - Выбираем sync (gRPC) vs async (Kafka) - Определяем контракты и версионирование сообщений ## Правила - Синхронно: только когда нужен немедленный ответ. - Асинхронно: события, длительные операции, интеграции. - Идемпотентнос
Workflow для LikeC4/C4 диаграмм (хранение, запуск, экспорт PNG).
Проектирование и уточнение измеримых NFR (SLO/SLI, лимиты, деградации).
--- name: security-architecture description: Архитектура безопасности: threat modeling, authn/authz, TLS/mTLS, аудит, секреты. version: 1.0 lastUpdated: 2026-02-04 --- # Security Architecture (Skill) ## Когда применять - Проектируем perimeter и модель доступа - Добавляем интеграции с внешними провайдерами - Определяем аудит и требования к логам ## Правила - Threat modeling: STRIDE по основным потокам. - Authn: OAuth2/OIDC. - Authz: ABAC на базе `tenantId` + роль + контекст. - Шифрование: TL
Координирующий skill для архитектурного проектирования. Определяет какие skills применять для C4, PlantUML, DDD, NFR, интеграций.