| name | architecture-discipline |
| description | Загружай первым: границы слоёв (адаптер→core→executor→tools/services), JSON-only цикл, local-first, sqlite-vec, без новой архитектуры без согласования; указатель на остальные скиллы. |
Skill: architecture-discipline
Базовые архитектурные правила репозитория. Загружай первым для широкой/неочевидной задачи, затем — профильный скилл. Источник истины — _docs/architecture.md и _docs/instructions.md §11.
Когда использовать
- Задача широкая или неочевидная — начни отсюда, чтобы выбрать следующий скилл.
- Добавляешь компонент или поток, трогаешь границы слоёв, реестр tools, память или агентный цикл.
- Сомневаешься, не выходит ли решение за рамки уже принятой архитектуры.
Алгоритм
- Слоистая изоляция. Поток: адаптер (
app/adapters/) → core (app/core/orchestrator.py) → executor (app/agents/) → tools / LLM / memory (app/tools/, app/services/). Слой ниже не знает про слой выше: tool не знает про aiogram, memory — про executor, executor — про Telegram.
- Единая точка входа. Любой адаптер вызывает только
core.handle_user_task(...). Адаптер не дёргает Executor / Planner / Critic напрямую.
- JSON-only цикл. Ответ LLM в агентном цикле — строго JSON одной из форм
_docs/agent-loop.md. Prose-ответ в цикле считается ошибкой.
- Tools as a registry. Новый tool — отдельный модуль с контрактом
name / description / args_schema / async run(args, ctx), регистрация в app/tools/registry.py (_docs/tools.md).
- Memory split. Краткосрочная — in-memory
ConversationStore; долгосрочная — sqlite-vec (SemanticMemory), пополняется только саммари при /new, не сырыми сообщениями (_docs/memory.md).
- Local-first, без облака. Только локальная Ollama; единственная БД —
sqlite-vec; polling, не webhook (_docs/instructions.md §11).
- Async-first. Любой I/O — через
await; общие клиенты создаются один раз на приложение → скилл async-discipline.
- Без новой архитектуры без согласования. Новый слой/сервис/абстракция/паттерн/зависимость или смена структуры каталогов — сначала проговорить с пользователем (
_docs/instructions.md §11). В рамках задачи — только локальные технические решения.
Куда дальше
- Async и I/O →
async-discipline. Тесты → testing-discipline. Ошибки и исключения → error-handling-discipline.
- Безопасность входов и опасных tools →
prompt-injection-defense. Документация → documentation-discipline. Git и коммиты → git-discipline.
Чего избегать
- Обращения адаптера к
Executor в обход core; обращения tool/memory к верхним слоям.
- Prose-ответов LLM в цикле вместо JSON.
- Новых зависимостей / слоёв / паттернов без согласования с пользователем.
- Облачных LLM, второй БД кроме
sqlite-vec, webhook в MVP.
