Repository navigation
Open
Labels
needs:decisionWaiting for an owner decisionWaiting for an owner decisionpriority:nextDo after the current workDo after the current workwayfinder:grillingWayfinder ticket: a decision settled in conversation with the ownerWayfinder ticket: a decision settled in conversation with the owner
Description
Окончательная архитектура сегодня записана только в чате. ARCHITECTURE.md и design.md в refract описывают другую систему, поэтому каждый новый агент строит по старой.
Вопрос
Утвердить архитектуру 14.10 как окончательную и записать ее как ADR вместо #508 1-А? Решать после бенчмарка «язык × API» - он блокирует этот тикет.
Что ты решил 14.10 в чате
| решение | твои слова |
|---|---|
| описания операций пишутся на Python, OpenAPI можно и импортировать, и экспортировать | «наша архитектура может и импортировать и экспортировать OpenAPI спеку расширенную» |
| Python SDK генерируется так же, как остальные языки | «наверное хорошая идея, мне нравится» |
каталог - OpenAPI 3.1 плюс x-ycli-*, своего формата нет |
«вроде выглядит норм» |
сгенерированный код лежит в git, ручные правки - в _patch.py |
«лучше хранить генерацию в гите» |
чужой API = его OpenAPI плюс x-ycli-*, остальное пишется руками на ядре |
«остальное описывайте будьте добры руками через наше ядро» |
| у каждого языка свое рукописное ядро, сгенерированный код - тонкий слой над ним | «мы пишем ядро на каждом языке со всеми нужными абстракциями» |
flowchart LR
subgraph now["Сейчас в документах"]
a1["ycli: client/cli/mcp руками"] --> b1["refract: YAML → копия ycli байт в байт"]
end
subgraph rec["Решено 14.10"]
a2["описания на Python"] --> c2["OpenAPI 3.1 + x-ycli-*"] --> d2["refract"] --> e2["SDK, CLI, MCP на 5 языках поверх ядра"]
end
Что поменяется, если «да»
- ADR «Генерация вместо вывода во время работы» заменяет Вывод SDK, CLI и MCP из описания операции: итог исследования и пять решений до пробы #508 1-А
- В
ARCHITECTURE.mdраздел генерации кода и ARCH-1 перестанут требовать ручныеclient.py,cli.pyиmcp.py - В
design.mdrefract: §0.6 и §1 больше не делают YAML источником истины;x-refract-*переименуется вx-ycli-* - В
CLAUDE.md: переменная окружения важнее профиля (так ты решил 14.10), форматprettyпереименуется вtable
Рекомендую: да, если бенчмарк не покажет, что вывод во время работы дает меньше ручного кода на Python и TypeScript больше чем на порог, который ты задашь.
Против: сгенерированный Python SDK - это тысячи строк в git и отдельная проверка расхождений, а вывод во время работы обходится без них.
Ответ одной строкой: «да» или «нет, потому что…».
Metadata
Metadata
Assignees
Labels
needs:decisionWaiting for an owner decisionWaiting for an owner decisionpriority:nextDo after the current workDo after the current workwayfinder:grillingWayfinder ticket: a decision settled in conversation with the ownerWayfinder ticket: a decision settled in conversation with the owner
Activity
bim-ba commentedon Nov 19, 2026
да