context

/context — Consolidated Context Management

Current Directory: !pwd

TO-DOS File: !test -f TO-DOS.md && echo "exists" || echo "missing"

Active Features: !ls -d specs/*/state.yaml 2>/dev/null | wc -l || echo "0"

Session Manager: !test -f .spec-flow/scripts/bash/session-manager.sh && echo "available" || echo "missing"

• /context next → Create handoff document for continuing work in fresh context
• /context todos → View and select from backlog
• /context add <desc> → Add item to backlog
• /context status → Show current session and workflow status

Helps maintain continuity across sessions and manage work backlog.

Step 1: Parse Action Argument

Extract first argument as action:

$action = first word of $ARGUMENTS
$remaining = rest of $ARGUMENTS

If no action provided: Use AskUserQuestion to ask:

{
  "question": "What context operation do you need?",
  "header": "Context Action",
  "multiSelect": false,
  "options": [
    {
      "label": "next",
      "description": "Create handoff document for fresh context"
    },
    {
      "label": "status",
      "description": "Show current session and workflow status"
    },
    {
      "label": "todos",
      "description": "View and select from outstanding items"
    },
    {
      "label": "add",
      "description": "Add something to backlog"
    }
  ]
}

Step 2: Execute Action Based on Type

<when_argument_is value="next">

Create Handoff Document

Purpose: Analyze current conversation and create handoff document for continuing work in a fresh context.

Implementation Steps:

1. Analyze current conversation:

   • Review conversation history
   • Identify incomplete tasks
   • Extract key decisions and context
   • Note any blockers or dependencies

2. Create handoff document:

   • File: HANDOFF-{timestamp}.md
   • Sections:
     • Current State: What was being worked on
     • Completed: What was finished
     • In Progress: What needs continuation
     • Context: Important decisions and rationale
     • Next Steps: Actionable items for next session
     • Files Modified: List of changed files
     • Commands Used: Workflow commands executed