open-loops

Open Loops

Track and manage open threads - things waiting for follow-up, hanging items, commitments made.

When to Use

• Something needs follow-up but isn't a full project
• Reviewing what's hanging at session start
• Marking something as done/resolved
• Feeling like things are slipping through cracks

Data Structure

Open loops live in state/session-context.json under open_threads:

{
  "open_threads": [
    "Thread description - context if needed",
    "Another hanging item"
  ]
}

For richer tracking, can optionally use state/open-loops.json:

{
  "loops": [
    {
      "id": "loop-001",
      "description": "Send invoices",
      "context": "Price TBD - waiting on confirmation",
      "added": "2025-12-28",
      "area": "finance",
      "status": "waiting",
      "stale_after_days": 7
    }
  ]
}

Execution Steps

Quick Status

Read current threads:

cat state/session-context.json | jq '.open_threads'

Report:

• Total count
• Flag any that look stale (been mentioned in multiple sessions)
• Group by apparent area if patterns emerge

Add New Loop

When user mentions something that needs follow-up:

1. Ask for clarification if needed:

   • What's the actual action?
   • Any deadline or "stale by" date?
   • Which area does this relate to?

2. Add to session-context.json:

   "open_threads": [
     "existing thread",
     "New thread - brief context"
   ]
   

3. Confirm what was added

Resolve Loop

When something is done:

1. Read current threads
2. Remove the resolved item
3. Optionally note in session summary that it was closed
4. Update the file

Review Loops

Full review of what's hanging:

1. Read state/session-context.json
2. Cross-reference with recent state/journal.jsonl entries
3. Identify:
   • Active: Recently mentioned, making progress
   • Stale: Not mentioned in 3+ sessions, may be stuck
   • Waiting: Blocked on external input
   • Maybe obsolete: Context has changed