context-preservation ยท diff
v1.0.0 to v1.0.0
55 added, 55 removed. Audit A to A.
- ---
- 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)"
+ ---
+ 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
-
- ```json
- {
- "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 },
- "typecheck": { "passed": true }
- },
- "tdd": {
- "iteration": 2,
- "score": 92,
- "compliant": true
- },
- "context": {
- "usagePercent": 72,
- "preservedAt": "2026-03-02T12:00:00Z"
- }
- }
- ```
+ - 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
+
+ ```json
+ {
+ "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 },
+ "typecheck": { "passed": true }
+ },
+ "tdd": {
+ "iteration": 2,
+ "score": 92,
+ "compliant": true
+ },
+ "context": {
+ "usagePercent": 72,
+ "preservedAt": "2026-03-02T12:00:00Z"
+ }
+ }
+ ```