| name | context-preservation |
| description | State capture and restore across context window compactions. Monitors usage thresholds and serializes quality, task, and spec state for seamless continuation. |
| allowed-tools | Bash(*) Read Write Edit Glob Grep |
| metadata | {"author":"babysitter-sdk","version":"1.0.0","category":"pilot-shell-infrastructure","attribution":"Adapted from Pilot Shell by Max Ritter (https://github.com/maxritter/pilot-shell)"} |
| graph | {"domains":["domain:software-engineering"],"skillAreas":["skill-area:agentic-loops","skill-area:orchestration-loop"],"workflows":["workflow:feature-development"],"topics":["topic:developer-experience"],"roles":["role:tech-lead","role:backend-engineer"]} |
- Serialize current spec state (tasks, statuses, acceptance criteria)
- Capture quality pipeline state (last lint/format/typecheck results)
- Save TDD progress (current phase, iteration count, scores)
- Store context monitor metrics
- Write to
.pilot-shell/state.json
2. State Restore (SessionStart / post_compact_restore)
- Read
.pilot-shell/state.json on session start
- Restore spec task tracking state
- Restore quality baseline
- Resume TDD from last known position
- Log restoration summary
3. Threshold Monitoring
- Track context usage percentage (default threshold: 70%)
- Trigger preservation when threshold approached
- Calculate optimal preservation timing
State Schema
{
"version": "1.0.0",
"timestamp": "2026-03-02T12:00:00Z",
"spec": {
"title": "...",
"taskStatuses": [{ "id": "...", "status": "COMPLETE" }],
"currentPhase": "implement"
},
"quality": {
"lastScore": 87,
"lint": { "passed": true },
"format": { "passed": true }
