session

name: session description: Load for session lifecycle management, TODO tracking, phase transitions (START/WORK/END), and session cleanup. Maintains session structure and gate compliance.

Session Management

Merged Skills

• workflow: Phase transitions, gate compliance
• todo-management: TODO tracking, structured naming

⚠️ Critical Gotchas

Rules

Avoid

Phase Flow

START → WORK → END → VERIFY

⛔ END Phase: AKIS Framework Updates

At END phase, run these scripts to keep AKIS framework current:

# 1. Update knowledge graph
python .github/scripts/knowledge.py --update

# 2. Update skills index
python .github/scripts/skills.py --update

# 3. Update agents
python .github/scripts/agents.py --update

# 4. Update instructions
python .github/scripts/instructions.py --update

Results Table (present to user):

TODO Format

○ [agent:phase:skill] Task description [context]

Patterns

# Pattern 1: Increment session counter
python .github/skills/session/scripts/session_tracker.py increment

# Pattern 2: Check if maintenance due
python .github/skills/session/scripts/session_tracker.py check-maintenance

# Pattern 3: Session cleanup at END
python .github/skills/session/scripts/session_cleanup.py

# Pattern 4: Get current session number
python .github/skills/session/scripts/session_tracker.py current

Workflow Log Template

---
session:
  id: "YYYY-MM-DD_task"
  complexity: medium  # simple|medium|complex

skills:
  loaded: [skill1, skill2]

files:
  modified:
    - {path: "file.tsx", domain: frontend}

agents:
  delegated:
    - {name: code, task: "Task", result: success}

root_causes:  # REQUIRED for debugging
  - problem: "Error description"
    solution: "Fix applied"
---

# Session: Task Name

## Summary
Brief description.

## Tasks
- ✓ Task 1
- ✓ Task 2

Commands

Gate Compliance