task-tracker

name	task-tracker
description	Manage a tasks.md file that tracks what each intern in the ./interns subdirectory is working on. Use when you need to check, update, or report on intern task status, or when coordinating work across multiple interns.

Task Tracker

Maintain a tasks.md file in the project root (/Users/micn/Development/squad/tasks.md) that tracks the status and activity of each intern working in the ./interns/ subdirectory.

When to Use

• A new intern directory is created or discovered in ./interns/
• An intern starts, completes, or updates a task
• You need to check what all interns are working on
• You need to assign or log work for an intern
• The user asks about task status, progress, or what's happening

How It Works

1. Discover interns: Scan ./interns/ for subdirectories — each subdirectory is an intern
2. Read their work: Check files, session logs, or any artifacts in each intern's directory to understand what they're doing
3. Update tasks.md: Write/update the tasks.md file in the project root with current status

tasks.md Format

The file should follow this structure:

# Tasks

> Last updated: YYYY-MM-DD HH:MM

## Intern: <intern-name>

- **Status**: 🟢 Active | 🟡 Idle | 🔴 Blocked | ✅ Done
- **Current Task**: Brief description of what they're working on
- **Details**: Any additional context, files being worked on, progress notes
- **History**:
  - [YYYY-MM-DD HH:MM] Completed X
  - [YYYY-MM-DD HH:MM] Started Y

---

## Intern: <another-intern-name>

...

Status Icons

Icon	Meaning
🟢	Actively working on something
🟡	Idle / no current task
🔴	Blocked, encountered an error, or evicted to make room
✅	Task completed
🗄️	Archived — work done, intern directory cleaned up to free a slot
💀	Shut down — intern was lost/spinning and terminated

Operations

Check Status

1. List directories in ./interns/
2. For each intern directory, examine its contents (files, session logs, outputs)
3. Read the current tasks.md if it exists
4. Update tasks.md with the latest findings

Add/Update a Task

1. Read the current tasks.md
2. Find the intern's section (or create one if new)
3. Update their status, current task, and append to history
4. Write back to tasks.md with updated timestamp

Add a New Intern

1. Check if ./interns/<name>/ exists; create it if not
2. Add a new section to tasks.md with status 🟡 Idle
3. Update the last-updated timestamp

Example Workflow

# Discover interns
ls ./interns/

# Check what an intern has been doing
ls -la ./interns/alice/
# Look at their session or output files

# Then update tasks.md accordingly

Notes

• Always update the "Last updated" timestamp when modifying tasks.md
• Keep history entries concise — one line per event
• When an intern's directory is empty or has no recent activity, mark them as 🟡 Idle
• If an intern directory disappears, mark them as removed in tasks.md but keep their history