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
- •Discover interns: Scan
./interns/for subdirectories — each subdirectory is an intern - •Read their work: Check files, session logs, or any artifacts in each intern's directory to understand what they're doing
- •Update tasks.md: Write/update the
tasks.mdfile in the project root with current status
tasks.md Format
The file should follow this structure:
markdown
# 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
- •List directories in
./interns/ - •For each intern directory, examine its contents (files, session logs, outputs)
- •Read the current
tasks.mdif it exists - •Update
tasks.mdwith the latest findings
Add/Update a Task
- •Read the current
tasks.md - •Find the intern's section (or create one if new)
- •Update their status, current task, and append to history
- •Write back to
tasks.mdwith updated timestamp
Add a New Intern
- •Check if
./interns/<name>/exists; create it if not - •Add a new section to
tasks.mdwith status 🟡 Idle - •Update the last-updated timestamp
Example Workflow
bash
# 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