file-backed-state-module

What problem does it solve?

This Skill solves the problem of losing or misordering agent state during long runs, delegation, and context compression by making all transferable information durable and addressable by file path.

Core Features & Use Cases

• Durable, path-addressable handoffs: Ensures tasks, role instructions, and reusable replies are written to stable files before any child stage reads them.
• Authoritative run and child status tracking: Uses STATE_ROOT/RESPONSE.md and children/<id>/RESPONSE.md to record the current completion/status and where to continue next.
• Auditability and recoverability: Maintains an append-only state/task_history.jsonl log and requires recovery via relaunch/retry when durable outputs are missing or corrupted.
• Artifact promotion discipline: Maintains artifacts/manifest.json to index final deliverables (and key supporting files) for later evaluation.

Quick Start

Configure STATE_ROOT under /sa-output, then write STATE_ROOT/TASK.md, create STATE_ROOT/RESPONSE.md early, and persist each child’s outputs into STATE_ROOT/children/<child_id_or_role>/RESPONSE.md only after the required durable files are complete.