Checklist 📋

Collaborative task checklist manager for AI agents with advanced execution modes.

---

🎯 When to Use

Use this skill when:

• - Multi-agent collaboration - Multiple AI agents need to coordinate
• Sequential tasks - Steps must execute in order
• Parallel tasks - Steps can run simultaneously
• Looping workflows - Repeat until condition is met
• Complex coordination - Avoid deadlocks and infinite loops

---

🌐 Execution Modes

1. Sequential (串行)

Steps execute one after another: CODEBLOCK0

2. Parallel (并行)

Steps execute simultaneously: CODEBLOCK1

3. Loop (循环)

Repeat until exit condition:

while condition:
    A → B
    if exit_condition:
        break

---

⚡ Quick Commands

Execution Control

CODEBLOCK3

Agent Commands

CODEBLOCK4

Task Commands

checklist create <template>
checklist done <item>
checklist depend <item> <dep>
checklist tree

---

🔄 Execution Modes Detail

Sequential Mode

CODEBLOCK6

Parallel Mode

CODEBLOCK7

Loop Mode

✅ Loop: Repeat until exit condition

Loop Config:
  - Max iterations: 5 (default, configurable)
  - Exit conditions:
    - All items done
    - Custom condition met
    - Manual break

Loop Example:
  Iteration 1: [1, 2, 3] → Check exit → Continue
  Iteration 2: [1, 2, 3] → Check exit → Continue
  Iteration 3: [1, 2, 3] → Exit condition met → Stop

---

🛡️ Safety Features

1. Loop Protection

CODEBLOCK9

2. Exit Conditions

CODEBLOCK10

3. Deadlock Prevention

CODEBLOCK11

4. Validation

# Validate entire workflow
checklist validate

🔍 Validation:
   - All items have valid references: ✅
   - No circular dependencies: ✅
   - Agents assigned: 3/15
   - Max loop iterations: 5
   - Exit condition: defined
   ✅ Checklist is valid

---

📋 Usage Examples

Example 1: Sequential Deployment

CODEBLOCK13

Example 2: Parallel Testing

CODEBLOCK14

Example 3: Loop with Exit

CODEBLOCK15

Example 4: Deadlock Prevention

User: Create conflicting dependencies

AI: [Execute: checklist add "Task A"]
[Execute: checklist add "Task B"]
[Execute: checklist depend 1 2]
[Execute: checklist depend 2 1]

[Execute: checklist check]

🔍 Deadlock Detection:
   ⚠️  WARNING: Circular dependency detected!
   
   1 → 2 → 1
   
   Resolution suggestions:
   - Remove one dependency
   - Merge into single item
   
✅ Checklist NOT safe - fix before running

---

🔧 Implementation

Loop State

CODEBLOCK17

Safety Checks

Before Execution:
1. Validate all references ✓
2. Check circular dependencies ✓
3. Verify agents available ✓
4. Check loop config ✓
5. Confirm exit condition ✓

During Execution:
- Monitor for infinite loops
- Track iteration count
- Check exit conditions

After Execution:
- Final validation
- Generate completion report

---

🎯 Best Practices

1. Always Set Exit Conditions

CODEBLOCK19

2. Use Sequential for Dependent Tasks

CODEBLOCK20

3. Use Parallel for Independent Tasks

CODEBLOCK21

4. Check Before Running

CODEBLOCK22

5. Monitor Loop Count

checklist loop count   # Show current iteration

---

⚠️ Important Notes

Loop Safety

Scenario	Behavior
No exit condition	Uses maxiterations (default: 5)
Exit condition never met

Stops at maxiterations | | Deadlock detected | Blocks execution, shows warning | | Circular dependency | Prevents running, suggests fix |

Maximum Limits

Limit	Default	Max
Loop iterations	5	100
Parallel items

10 | 50 | | Total items | 100 | 500 |

---

🦞 Summary

One line: Complex task → Choose mode (sequential/parallel/loop) → Set safety limits → Run with confidence → Automatic exit

---