# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

ОСНОВНАЯ КОНЦЕПЦИЯ БАХА
=================

«Агент – это роль и целенаправленное намерение внутри нее.
Рабочие процессы — это мозг исполнения.
Навыки, инструменты и услуги — это инструменты для исполнения.
Вместе они составляют ядро».

ЧЕТЫРЕ СТОЛПА
----------------

```
┌────────────────────────────────────────────────────────────────┐
│ ЯДРО │
├────────────────────────────────────────────────────────────────┤
│ │
│ ┌─────────────┐ ┌────────────┐ ┐ ┐ │
│ │ АГЕНТ │ │ РАБОЧИЙ ПРОЦЕСС │ │ НАВЫКИ/ИНСТРУМЕНТЫ/SVC │ │
│ │ │ │ │ │ │ │
│ │ роль + │───>│ мозг │───>│ инструменты │ │
│ │ Намерение │ │ Контроль │ │ Исполнение │ │
│ │ │ │ │ │ │ │
│ │ КТО + ПОЧЕМУ│ │ КАК │ │ ЧТО С ЧЕМ │ │
│ └─────────────┘ └────────────┘ └────────────────────┘ │
│ │
└──────────────────────────────── ────────────────────────────────┘
```

АГЕНТ = роль + целенаправленное намерение
---------------------------------------

- КТО я в этой задаче?
- ПОЧЕМУ я это делаю? (цель, мотивация)
- Определяет перспективу и структуру принятия решений 

Примеры:
  - Агент разработчика: пишет код, отлаживает, тестирует.
  - Личный помощник: помогает пользователям в повседневной жизни.
  - Эксперт-исследователь: ищет и оценивает информацию 

Место хранения: агенты/*.txt

РАБОЧЕЕ ПРОЦЕСС = мозг для выполнения
---------------------------------

- КАК выполняется задача?
- Контролирует процесс, порядок, решения
- Процедурные знания: пошаговые инструкции

Примеры:
  - Рабочий процесс исправления ошибок: Воспроизведение -> Анализ -> Исправление -> Тестирование.
  - Рабочий процесс обзора: Чтение -> Оценить -> Комментарий -> Принять решение.
  - Рабочий процесс запуска: Проверить -> Загрузить -> Инициализировать -> Готово

Место хранения: навыки/рабочие процессы/*.md

Рабочие процессы являются ЦЕНТРАЛЬНЫМИ, потому что:
  1. Вы берете на себя фактический контроль
  2. Вы управляете навыками, инструментами и услугами.
  3. Их можно тестировать (тесты вариантов использования).
  4. Они многоразовые

НАВЫКИ/ИНСТРУМЕНТЫ/УСЛУГИ = инструменты
-------------------------------------

- ЧЕМ выполняется задача?
- Конкретные навыки и функции.
- Вызываются рабочими процессами

| Тип | Описание | Местоположение |
|---------|--------------------------|--------------------------------|
| Навыки | Знания + Инструкции (.txt) | навыки/*.txt |
| Инструменты | Скрипты Python (.py) | инструменты/*.py |
| Услуги| Внешние услуги | через API/CLI 

|INTERPLAY
-------------

```
Запрос пользователя
     │
     в
┌──────────────┐
│ АГЕНТ │ «Я разработчик, цель: исправить ошибку»
└──────────────┘
     │
     в
┌──────────────┐
│ РАБОЧИЙ ПРОЦЕСС │ «1. Воспроизвести 2. Анализировать 3. Исправить»
└──────────────┘
     │
     в
┌─────────────────── ───────────────────┐
│ НАВЫКИ/ИНСТРУМЕНТЫ/УСЛУГИ │
│ - debugger.py (инструмент) │
│ - git-workflow.txt (Навык) │
│ - тестировщик (сервис) │
└─────────────────── ───────────────────┘
     │
     в
Результат
```

ИНФОРМАЦИЯ О LLM
-------------------

Работающий LLM должен знать:
1. КАКИЕ агенты существуют (агенты/)
2. КАКИЕ рабочие процессы доступны (навыки/рабочие процессы/)
3. КАКИЕ навыки/инструменты/услуги имеются (skills/,tools/)

Это достигается за счет:
- Реестр обработчиков (system/core/registry.py) - Автоматическое обнаружение обработчиков.
- Tool-Auto-Discovery (tools/tool_auto_discovery.py) - Сканирует инструменты в БД.
- Записи БД (таблица инструментов, иерархия_элементов)
- Обзор запуска показывает контекст сеанса

См.: --help Startup, --help Tools

ГАРАНТИЯ КАЧЕСТВА (WORKFLOW-TUEV)
-----------------------------------

Рабочие процессы настолько важны, что их необходимо проверять:

1. ИСПОЛЬЗОВАТЕЛЬСКИЕ ТЕСТЫ
   - Сбор тест-кейсов в БД
   - Автоматическое исполнение
   - Оценка: очень хорошо/хорошо/удовлетворительно/достаточно/неудовлетворительно

2. ПРОЦЕДУРА ТУЭВ
   - Рабочие процессы имеют срок действия.
   - По истечении срока действия: автоматическое создание задачи обслуживания.
   - После проверки: установите новую дату истечения срока действия

3. КОНТРОЛЬНЫЙ СПИСОК для новых компонентов
   [ ] Работает без пользовательских данных?
   [ ] Доступна команда CLI?
   [ ] Возможен ли ввод из файлов/папок?
   [ ] Вывод в структурированную БД?
   [ ] Сканировать/импортировать повторяемый (идемпотентный)?
   [ ] Нет жестко запрограммированных путей?

См.: Задачи WF-TUEV (в разработке)

СВЯЗАННЫЕ ПОНЯТИЯ
------------------

- docs/help/memory.txt - Память как когнитивная модель
- docs/help/agents.txt – сведения о системе агента.
- docs/help/workflow.txt – сведения о системе рабочего процесса.
- docs/help/skills.txt – Иерархия навыков
- docs/help/tools.txt – сведения о системе инструментов.
- system/ARCHITECTURE.md - Общая архитектура

---
Версия: 1.0.1 | Создано: 30 января 2026 г. | Обновлено: 8 февраля 2026 г.
(Основная концепция: агент/рабочий процесс/навыки/инструменты)
