---

name: context-tracking description: Real-time work context tracking for session continuity. Maintains task/step state across sessions, tracks progress, manages logs, integrates with phase enforcement.

Context Tracking Skill

Maintain real-time work context in .aid/context.json.

Core Rule

Claude MUST maintain context:

1. READ context before starting work
2. UPDATE on every significant change
3. SYNC with phase state
4. INTEGRATE with feedback (/aid end)
5. SAVE at conversation end

Context Update Triggers

Context Structure

Copy{
  "last_updated": "2024-12-11T15:30:00Z",
  "session_id": "2024-12-11-afternoon",
  "phase": {
    "current": 4,
    "name": "development"
  },
  "project": {
    "name": "user-auth",
    "documents": {
      "prd": "docs/prd/...",
      "tech_spec": "docs/tech-spec/...",
      "implementation_plan": "docs/implementation-plan/..."
    }
  },
  "tasks": {
    "previous": { "key": "PROJ-123", "status": "done" },
    "current": { "key": "PROJ-124", "status": "in_progress" },
    "next": { "key": "PROJ-125", "status": "todo" }
  },
  "current_task_steps": {
    "previous": { "name": "Write tests", "status": "done" },
    "current": { "name": "Implement", "status": "in_progress", "progress": "60%" },
    "next": { "name": "Integration tests", "status": "pending" }
  },
  "session_log": [
    { "timestamp": "...", "action": "task_started", "details": "..." }
  ],
  "feedback": {
    "pending_for_phase": false,
    "sessions_since_feedback": 2
  }
}

Phase-Aware Context

Standard Step Templates

Component Development (Phase 4)

1. Load task context
2. Read Tech Spec
3. Write tests (TDD)
4. Implement
5. Run tests
6. Self review
7. Commit

Bug Fix (Phase 4)

1. Load context
2. Reproduce issue
3. Write failing test
4. Implement fix
5. Verify
6. Commit

Session Log Actions

Feedback Integration

CopyTask Complete?
  -> Update Context
  -> Phase ending? Prompt /aid end
  -> 3+ sessions without feedback? Remind
  -> Continue to next task

Error Handling

No context.json

CopyNo .aid/context.json found
Creating context:
1. What feature?
2. What phase?
3. What task?

Stale context (>24h)

CopyContext stale (36h old)
Last: PROJ-124 "AuthService" (60%)
Still accurate?
[1] Yes, continue
[2] No, completed offline
[3] Start fresh

Context-State mismatch

CopyContext: Phase 3
State: Phase 4
Syncing to Phase 4...

File Locations

Copy.aid/
  state.json     # Phase state
  context.json   # Task/step context

~/.aid/
  feedback/pending/
  feedback/processed/

Commands