aget-save-state

name	aget-save-state
description	Save workflow state for resume/recovery. Use at natural breakpoints before context-intensive operations, major refactors, or session interruptions.

Save State Protocol

You are saving workflow state for session continuity.

Renamed: /aget-checkpoint → /aget-save-state per S-V-O naming convention (L584) and Microsoft Agent Framework "State" grounding.

Input

$ARGUMENTS

Mode Detection

Input Pattern	Mode	Behavior
Empty or blank	Auto-name	Generate timestamp-based checkpoint name (YYYYMMDD-HHMMSS)
Text provided	Named	Use provided name (sanitized: lowercase, hyphens for spaces)

Checkpoint Capture

Create checkpoint file at sessions/checkpoints/<name>.checkpoint.yaml:

1. Session Context:

   • Current session file path (if exists in sessions/)
   • Summary of current work focus (1-2 sentences)

2. Active Tasks:

   • In-progress tasks with status
   • Pending questions or decisions

3. Artifacts:

   • Recently modified files (from git status or session context)
   • Whether uncommitted git changes exist

4. Resume Prompt:

   • Human-readable summary for context recovery
   • Recommended next action

Output Format

Write this YAML structure to sessions/checkpoints/<name>.checkpoint.yaml:

checkpoint:
  name: "<name>"
  created: "<ISO 8601 timestamp>"
  agent: "private-cli-aget"
  version: "3.4.0"

context:
  session_file: "<path or null>"
  current_focus: "<1-2 sentence summary of current work>"
  active_tasks:
    - subject: "<task description>"
      status: "in_progress|pending"
  pending_questions:
    - "<unanswered question or decision needed>"

artifacts:
  modified_files:
    - path: "<file path>"
      summary: "<brief description of changes>"
  uncommitted_changes: true|false

resume_prompt: |
  Continue from checkpoint "<name>".

  Context: <summary of where you left off>

  Next action: <recommended next step>

After Checkpoint Creation

1. Report checkpoint file location
2. Confirm what was captured
3. Provide the resume prompt for future reference

Constraints

These are INVIOLABLE - you MUST NOT violate these constraints:

1. NEVER modify files in specs/, governance/, or .aget/
2. NEVER modify planning/RESEARCH_BACKLOG.md
3. NEVER create checkpoints outside sessions/checkpoints/
4. NEVER include sensitive data (credentials, API keys) in checkpoints
5. DO create sessions/checkpoints/ directory if it doesn't exist
6. DO use ISO 8601 timestamp format
7. DO sanitize checkpoint names (replace spaces with hyphens, lowercase)
8. DO overwrite existing checkpoint if same name is used

Rationale

Per AGET theoretical grounding:

• Stigmergy (Grasse): Checkpoint artifacts enable cross-session coordination
• Extended Mind (Clark/Chalmers): Externalizing state prevents cognitive loss
• Session Continuity: Enables break-and-continue workflow patterns
• Context Recovery: Checkpoints provide structured resume context

This skill implements the "save state, resume later" pattern for AGET session management.

Traceability

Link	Reference
Vocabulary	Checkpoint_Protocol (CLI_VOCABULARY.md v1.30.0)
Requirements	R-SKILL-005-001 through R-SKILL-005-011
Skill Spec	SKILL-005
L-docs	L570, L574, L575
RQ	RQ-054
Project	PROJECT_PLAN_AGET_CHECKPOINT_SKILL.md