feat: harden OpenSpec SDD workflow

2026-08-26 00:42:35 +03:00
parent 039b72eed3
commit a8b2c4eed9
42 changed files with 4024 additions and 181 deletions
@@ -0,0 +1,24 @@
+# OpenCode agent projection authority
+
+This directory is the committed canonical source for WealthLedger-owned
+OpenCode `commands` and `skills`. Workspace root `.opencode/commands` and
+`.opencode/skills` are derived output, not a second SDD authority.
+
+The source intentionally excludes `.opencode/package.json`, lockfiles,
+`node_modules`, `.gitignore` and all machine-local runtime state.
+
+From the workspace root:
+
+```bash
+bash specs/scripts/sync-agent-projection.sh
+bash specs/scripts/verify-agent-projection.sh
+```
+
+Edit this source tree first. The sync performs a verified cutover and restores
+the previous local projection if installation or verification fails. The
+non-mutating verifier checks the exact required file set, contents and each
+skill's `generatedBy` marker against `specs/openspec/.cli-version`.
+
+For an OpenSpec upgrade, prepare the upstream projection in isolated staging,
+reapply the minimal WealthLedger overlays, update the exact version contract
+only after compatibility fixtures pass, then sync this canonical tree.