next-group

Get the next context group that should be executed by an AI coding agent. This command helps with context window management by identifying which group to work on next.

Process

1. Parse arguments

   • $1 = Project name (optional)

2. Locate and read the task file

   • If project name provided: Read tasks/$1.tasks.json
   • If no project name: Find most recently modified .tasks.json

3. Verify context groups exist

   • Check for context_groups array in task file
   • If not found, suggest running /task-manager:context-groups first

4. Find active or next pending group

   • First, look for a group with status: "active" (already started)
   • If none active, find first group with status: "pending"
   • Skip groups with status: "completed"

5. Check if current group is complete

   • If active group exists, verify all tasks are complete
   • If all complete, mark group as completed and move to next pending

6. Mark next group as active

   • Update the group's status to "active"
   • Save the updated task file

7. Calculate group progress

   • Count completed tasks in this group
   • Calculate percentage complete
   • Identify remaining tasks

8. Display group information

Format output as:

## Next Context Group: CG-002

**Status:** Active
**Estimated Tokens:** 68,500 / 80,000 available

### Progress
- Tasks: 1 of 4 complete (25%)
- Phases Covered: 2, 3

### Tasks in This Group

| Order | Task | Status | Priority | Complexity | Est. Tokens |
|-------|------|--------|----------|------------|-------------|
| 1 | TASK-005: Setup auth module | complete | high | M | 4,200 |
| 2 | TASK-006: Implement login flow | not_started | high | L | 10,200 |
| 3 | TASK-007: Add session handling | not_started | medium | M | 4,200 |
| 4 | TASK-008: Create logout endpoint | not_started | medium | S | 1,700 |

### Dependencies Within Group
- TASK-006 depends on TASK-005 (complete)
- TASK-007 depends on TASK-006
- TASK-008 depends on TASK-005 (complete)

### Ready to Start
The following tasks have all dependencies satisfied:
- **TASK-006:** Implement login flow (high priority, L complexity)
- **TASK-008:** Create logout endpoint (medium priority, S complexity)

---

**Recommended:** Start with TASK-006 (high priority, unblocks TASK-007)

**Context Handoff Notes:**
Previous group (CG-001) completed:
- Auth configuration (TASK-004)
- Database schema (TASK-003)

These outputs are available for reference in this group.

---

When all tasks in this group are complete, run `/task-manager:next-group` to move to the next context group.