Session Capsule Protocol (SCP)

SCP is a tool-agnostic protocol for keeping long-running LLM/agent projects coherent across:

• long sessions (context-window pressure)
• model switches (planner/executor, different vendors)
• fresh sessions (handoffs)

This repo contains:

• The spec: docs/spec.md
• Templates: templates/
• Examples: examples/
• Dependency-free checks: tools/, scripts/, continuitybench/

Minimal workflow

1. Start (or restart) by pasting a Session Capsule into the chat.
2. Use the Manager template to:
   • report progress toward a milestone (done vs remaining)
   • generate the next Executor task prompt
3. Executor implements the task and updates the capsule.
4. When context is getting tight, use the Hydration template to produce a capsule + bootstrap prompt for a new session.

Capsule templates:

• YAML (human-friendly): templates/capsule.schema.yaml
• JSON Schema (tool-friendly): templates/capsule.schema.json

Prompt templates:

• Manager: templates/manager.prompt.md
• Hydration: templates/hydrate-new-session.prompt.md
• Repo readiness (ecosystem-agnostic): templates/repo-readiness.prompt.md

Optional checks (no package managers)

Shell-only (basic):

./scripts/selfcheck.sh

Python (stdlib only):

python3 tools/selfcheck.py
python3 continuitybench/runner/continuitybench.py

CI

GitHub Actions runs the Python checks using actions/setup-python.

Versioning

• Protocol version lives in the capsule (capsule_version) and the spec.
• Repo version is in VERSION.

License

MIT. See LICENSE.