Skip to content

docs(specs): shepherd durable patterns — checkpoints + rainbow shifts (OPS-482)#16

Merged
todie merged 1 commit into
mainfrom
docs/ops-482-shepherd-durable-patterns
Jul 9, 2026
Merged

docs(specs): shepherd durable patterns — checkpoints + rainbow shifts (OPS-482)#16
todie merged 1 commit into
mainfrom
docs/ops-482-shepherd-durable-patterns

Conversation

@todie

@todie todie commented Jul 8, 2026

Copy link
Copy Markdown
Member

Summary

  • Design spec for shepherd's resume-from-error checkpoint model and rainbow-style version-shift protocol, filling the blueprint gap left open by the 2026-07-07 deep-research pass (pattern confirmed 3-0, no engine/format prescribed).
  • Defines the Engram run-state vs. semantic-state boundary (and notes the interaction with OPS-480's hermes-memory question) and concrete Temporal-on-Postgres escalation criteria per the gap-closure Q1 verdict.
  • Design only — no implementation in this PR. Implementation tickets listed in §5, to be filed to Linear separately (API writes are rate-limited today).

Test plan

  • Doc review: checkpoint model (§1) matches shepherd's actual .vcscore//retained-changeset/claude-executor model as described in packages/shepherd/README.md and the adoption eval
  • Doc review: rainbow-shift protocol (§2) is consistent with install.sh's --force pin-bump behavior
  • Doc review: Temporal escalation criteria (§4) match the gap-closure doc's Q1 verdict and don't over- or under-claim readiness

… (OPS-482)

Fills the blueprint gap the 2026-07-07 deep-research pass left open:
Anthropic's resume-from-error + rainbow-deployment discipline is verified
3-0 but prescribes no engine or checkpoint format. Designs shepherd's
turn-boundary checkpoint model, version-fingerprinted rainbow shifting,
the Engram run-state/semantic-state boundary, and concrete Temporal
escalation criteria — evidence-anchored to the deep-research and
gap-closure eval docs and to shepherd's actual claude-only executor
constraints.
@todie todie merged commit 93f1e7e into main Jul 9, 2026
2 checks passed
@todie todie deleted the docs/ops-482-shepherd-durable-patterns branch July 9, 2026 01:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant