docs(05): capture phase context

This commit is contained in:
Mikhail Putilovskij 2026-04-27 22:13:52 +03:00
parent 8ffbe7b6b3
commit 6553320001
2 changed files with 195 additions and 0 deletions

View file

@ -0,0 +1,65 @@
# Phase 05: MVP Deployment — Discussion Log
> **Audit trail only.** Do not use as input to planning, research, or execution agents.
> Decisions captured in CONTEXT.md — this log preserves the alternatives considered.
**Date:** 2026-04-27
**Phase:** 05-mvp-deployment
**Areas discussed:** !agent legacy, file transfer path, config format, docker-compose scope
---
## !agent команда
| Option | Description | Selected |
|--------|-------------|----------|
| Удалить | Убираем полностью — маппинг статический из конфига | ✓ |
| Оставить как no-op | Команда остаётся но ничего не делает | |
| Только для dev-режима | Работает когда нет user_agents в конфиге | |
**User's choice:** Удалить
**Notes:** Команда была legacy от эпохи когда роутинг был динамическим. С user_agents в конфиге она не нужна.
---
## Путь входящих файлов
| Option | Description | Selected |
|--------|-------------|----------|
| incoming/{filename} | По docs/deploy-architecture.md — /agents/N/incoming/file | ✓ |
| surfaces/matrix/{user}/{room}/inbox/{file} | Текущий формат files.py | |
**User's choice:** incoming/{filename}
**Notes:** Пользователь указал — это решение от платформенной команды, зафиксировано в docs/deploy-architecture.md.
---
## Формат config/matrix-agents.yaml
| Option | Description | Selected |
|--------|-------------|----------|
| Расширить текущий YAML | Добавить user_agents + base_url/workspace_path в тот же файл | ✓ |
| Отдельный prod-config.yaml | Два файла: registry (id/label) + prod конфиг (URL/user_agents) | |
**User's choice:** Расширить текущий YAML
**Notes:** Один файл проще. Формат уже определён в docs/deploy-architecture.md.
---
## docker-compose prod scope
**User's choice:** docker-compose.prod.yml только для Matrix-бота
**Notes:** Платформа отвечает за агентские контейнеры — мы их не трогаем. Matrix-бот монтирует /agents/ как external host path, платформа обеспечивает содержимое.
---
## Claude's Discretion
- Обработка Matrix user_id не найденного в user_agents
- Имена env переменных для prod
- Формат .env.prod
## Deferred Ideas
- platform-master интеграция
- Per-chat chat_id isolation