type: standard
layer: arch
object: system
aspect: structure
form: text
title: "Структура system/"
status: active
version: 1.0.0
date: 2026-04-15
knowledge_level: У1
parent: arch-platform-structure.md
Компонент ЧЕМ ЖИВЁТ ПЛАТФОРМА — платформенные агенты, сервисы и конфиги.
Что запускает и обслуживает платформу изнутри?
system/ содержит живые процессы: агенты (Claude Code сессии), фоновые сервисы, конфиги с реальными значениями. В отличие от library/ — здесь не шаблоны, а рабочие экземпляры.
system/
├── @{имя}.agent/ AI-агент платформы (Claude Code сессия)
├── @{имя}.service/ Платформенный сервис (не бизнес)
├── @{имя}.app/ Вспомогательное приложение
├── agents/ Реестр агентов и роли
├── config/ Конфиги платформы (реальные токены)
├── monitor/ Мониторинг платформы
├── scheduler/ Планировщик cron-задач
├── bots/ Telegram-боты платформы
├── scripts/ Служебные скрипты
└── tools/ Утилиты платформы
AI-агент = Claude Code сессия, запущенная по правилам файла {имя}.ai.md.
| Агент | Роль |
|---|---|
@architect.agent/ |
Архитектурная работа, стандарты |
@projector.agent/ |
Управление проектами |
@keeper.agent/ |
Хранитель контекста, память |
@sentinel.agent/ |
Мониторинг и алерты |
@analyzer.agent/ |
Анализ данных |
Структура агента:
@{имя}.agent/
├── {имя}.ai.md — определение: роль, правила, протоколы
├── CLAUDE.md — навигатор (опционально)
└── prompts/ — заготовленные промпты
Платформенный сервис — фоновый процесс, обслуживающий саму платформу (не проект клиента).
| Сервис | Назначение |
|---|---|
@bootstrap.service/ |
Инициализация новых проектов |
@rebuild.service/ |
Пересборка компонентов платформы |
@intake.service/ |
Разбор входящих запросов |
@deploy.service/ |
Деплой сервисов |
@data-session.service/ |
Воспроизводимая обработка данных |
@session.service/ |
Управление сессиями агентов |
@file-viewer.service/ |
Просмотр файлов платформы |
@platform-tools.service/ |
Инструменты платформы |
Структура сервиса:
@{имя}.service/
├── CLAUDE.md
├── index.yaml — метаданные сервиса
├── docker-compose.yml (если Docker)
├── src/ — код
└── config/ — конфиги сервиса
Реальные значения: токены, chat_id, адреса. Не шаблоны — это отличие от library/.
config/
├── telegram.yaml — реальный токен бота
├── monitoring.yaml — реальные адреса алертов
└── platform.yaml — общие настройки платформы
Правило: конфиги с секретами — в $DATASPACE, не в git. В git — только структура без значений.
| system/ | services/ | |
|---|---|---|
| Для кого | платформа | проекты клиентов |
| Примеры | @rebuild.service, @monitor | @pirotehnika.service |
| Запускает | платформенные процессы | бизнес-сервисы |
| Управляет | Архитектор / Оператор | Проектор |
| system/ | library/ | |
|---|---|---|
| Состояние | активное (процесс запущен) | пассивное (код/шаблон) |
| Токены | реальные | "{{TOKEN}}" — заглушка |
| Пример | system/config/telegram.yaml |
library/connectors/telegram/ |