docs: simplify OpenSpec agent entrypoints

This commit is contained in:
2026-08-26 00:52:55 +03:00
parent 5233726855
commit eb0a96e27c
4 changed files with 24 additions and 40 deletions
@@ -16,19 +16,18 @@ monorepo control plane для четырёх независимых Git-репо
- Встроенная `spec-driven` schema отклонена: она не выражает обязательный переход Specs перед Design и не задаёт Delivery Map или проектные роли артефактов.
- Отдельный workflow engine или custom generator отклонён: он создал бы конкурирующий формат и lifecycle authority.
- Nx, Turborepo, Bazel, Make или just отклонены для текущего масштаба: workspace не имеет общего dependency graph, build cache или CI, а репозитории уже владеют canonical gates.
- Patch-only, programmatic generator и symlink для root agent projection
отклонены из-за upstream text fragility, второго transformation engine либо
tool/filesystem portability. Выбран committed canonical source tree с
explicit atomic sync и exact drift check.
- Versioned source tree, patch-only, programmatic generator и symlink для root
agent entrypoints отклонены для текущего масштаба: они добавляют отдельный
projection lifecycle поверх уже достаточных schema, docs и scripts.
## Последствия
OpenSpec CLI закреплён exact version contract; новая stable release не включает
auto-upgrade, а смена contract является отдельным SDD change со staged
compatibility fixtures. Project-owned commands и skills имеют versioned source
в `specs`, root `.opencode` является derived projection. Planning verifier до
approval проверяет только детерминированную структуру: capability set, Delivery
Map, rollback, task area и Requirement coverage.
compatibility fixtures. Root `.opencode` остаётся локальным non-authority
entrypoint, а hard constraints проверяются через authority verifier. Planning
verifier до approval проверяет только детерминированную структуру: capability
set, Delivery Map, rollback, task area и Requirement coverage.
Dispatcher знает четыре workspace area, но не реализует build или test logic:
он делегирует repo-owned commands. Approval identity остаётся человеческим