docs: simplify OpenSpec agent entrypoints
This commit is contained in:
@@ -21,7 +21,7 @@ bash specs/scripts/verify-openspec-version.sh
|
||||
Несовпадение version блокирует операцию до чтения или изменения store.
|
||||
Публикация новой stable версии не меняет этот contract автоматически. Upgrade
|
||||
выполняется отдельным SDD change после staged проверки schema, instructions,
|
||||
project-owned projection, store resolution и hard blockers; historical archives
|
||||
agent workflow, store resolution и hard blockers; historical archives
|
||||
не переписываются.
|
||||
|
||||
## Project-local schema
|
||||
@@ -58,29 +58,16 @@ openspec schema which wealth-ledger-sdd --json
|
||||
|
||||
## Agent entrypoints и обновление OpenSpec
|
||||
|
||||
Canonical source WealthLedger-owned OpenCode commands и skills находится в
|
||||
`specs/agent-projection/opencode`. Root `.opencode/commands` и
|
||||
`.opencode/skills` — derived local projection с минимальными overlays: fixed
|
||||
store, one-artifact-at-a-time, stage planning gate, Apply feedback routing и
|
||||
hard archive blockers. Package manifests, installed dependencies и machine-local
|
||||
state не входят в source.
|
||||
|
||||
Projection восстанавливается и проверяется из workspace root:
|
||||
|
||||
```bash
|
||||
bash specs/scripts/sync-agent-projection.sh
|
||||
bash specs/scripts/verify-agent-projection.sh
|
||||
```
|
||||
|
||||
Sync выполняет verified cutover и восстанавливает прежнее local state при
|
||||
ошибке. Verifier non-mutating сравнивает required file set и contents и получает
|
||||
expected `generatedBy` marker из `.cli-version`.
|
||||
Root `.opencode/commands` и `.opencode/skills` — локальные non-authority
|
||||
entrypoints. Они удобны для работы агента, но не являются SDD source of truth и
|
||||
не имеют отдельного versioned projection source. Нормативный contract хранится
|
||||
в schema, `AGENTS.md`, governance и non-mutating scripts.
|
||||
|
||||
`openspec update` не запускается напрямую из workspace root. Новую upstream
|
||||
version сначала генерируют в isolated staging, сравнивают с canonical source,
|
||||
переносят upstream delta и повторно накладывают минимальные project overlays.
|
||||
После этого sync обновляет derived root, а authority fixtures проверяют marker,
|
||||
missing/content drift, permissive archive, conditional store selection и второй
|
||||
version сначала проверяют в isolated staging и повторно накладывают минимальные
|
||||
project constraints: fixed store, one-artifact-at-a-time, stage planning gate,
|
||||
Apply feedback routing и hard archive blockers. Authority fixtures проверяют
|
||||
version preflight, permissive archive, conditional store selection и второй
|
||||
`openspec` root как failures.
|
||||
|
||||
## Реализация и проверка change
|
||||
@@ -102,7 +89,6 @@ Requirement покрывается точной ссылкой хотя бы о
|
||||
|
||||
```bash
|
||||
bash specs/scripts/verify-openspec-authority.sh
|
||||
bash specs/scripts/verify-agent-projection.sh
|
||||
openspec validate <change> --type change --strict --store wealth-ledger-specs
|
||||
openspec validate --specs --strict --store wealth-ledger-specs
|
||||
```
|
||||
|
||||
Reference in New Issue
Block a user