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
+6 -7
View File
@@ -117,8 +117,7 @@ contract либо другое существенно труднообратим
| Текущее устройство и поставленные возможности | `docs/architecture` и `docs/features` |
| Устойчивые архитектурные решения и причины | `docs/adr` |
| Инженерная policy и completion evidence | `docs/development` |
| Canonical source project-owned agent commands и skills | `specs/agent-projection/opencode` |
| Компактная маршрутизация AI-агентов | root и repository-local `AGENTS.md` |
| Компактная маршрутизация AI-агентов и локальные entrypoints | root/repository-local `AGENTS.md` и workspace `.opencode` |
`docs` описывает только фактическое текущее состояние и не пересказывает Proposal, Delta Specs, Design или Tasks другим форматом. `AGENTS.md` не копирует архитектуру или feature documentation: он направляет к authority и перечисляет только применимые hard constraints и canonical commands.
@@ -137,15 +136,15 @@ CI пока отсутствует, поэтому обязательные gate
Hard guardrail должен иметь исполняемую локальную проверку. Правило без надёжной проверки помечается как guidance и учитывается в review, но не выдаётся за автоматический запрет. Новые frameworks, checkers и thresholds добавляются только после оценки поддерживаемого решения, maintenance cost и реально защищаемого риска.
Root `.opencode/commands` и `.opencode/skills` являются derived projection.
Изменения вносятся в versioned source под `specs`, распространяются explicit
atomic sync и проверяются exact file/content comparison; package manifests,
dependencies и machine-local state не являются authority inputs.
Root `.opencode/commands` и `.opencode/skills` являются локальными
non-authority entrypoints. Они должны соблюдать fixed store, version preflight,
one-artifact approvals и hard archive blockers, но не имеют отдельного
versioned projection source.
Текущая exact OpenSpec CLI version читается только из
`specs/openspec/.cli-version`. Новая stable release не меняет contract
автоматически. Upgrade выполняется отдельным SDD change после isolated проверки
schema, agent projection, canonical store и positive/negative fixtures;
schema, agent workflow, canonical store и positive/negative fixtures;
историческое evidence сохраняет фактическую прежнюю version.
## Verify, archive и Completion Evidence