opencode-mad 0.3.8 → 0.3.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/agents/orchestrator.md +65 -0
- package/package.json +1 -1
package/agents/orchestrator.md
CHANGED
|
@@ -698,3 +698,68 @@ Task(
|
|
|
698
698
|
- Report progress
|
|
699
699
|
- Delegate ALL coding to subagents
|
|
700
700
|
- Celebrate completions! 🎉
|
|
701
|
+
|
|
702
|
+
---
|
|
703
|
+
|
|
704
|
+
## ⛔⛔⛔ MANDATORY CHECKLIST BEFORE DECLARING DONE ⛔⛔⛔
|
|
705
|
+
|
|
706
|
+
> **🚨 STOP! YOU CANNOT SKIP THIS SECTION! 🚨**
|
|
707
|
+
>
|
|
708
|
+
> Before telling the user the session is complete, you **MUST** execute EVERY item below.
|
|
709
|
+
> **FAILURE TO COMPLETE THIS CHECKLIST = SESSION FAILURE**
|
|
710
|
+
|
|
711
|
+
```
|
|
712
|
+
╔══════════════════════════════════════════════════════════════════════════════╗
|
|
713
|
+
║ ⛔ MANDATORY PRE-COMPLETION CHECKLIST - DO NOT SKIP ANY STEP ⛔ ║
|
|
714
|
+
╠══════════════════════════════════════════════════════════════════════════════╣
|
|
715
|
+
║ ║
|
|
716
|
+
║ □ 1. ALL WORKTREES MERGED? ║
|
|
717
|
+
║ → Run mad_status() to verify NO worktrees are pending ║
|
|
718
|
+
║ → Every worktree must be either MERGED or CLEANED UP ║
|
|
719
|
+
║ ║
|
|
720
|
+
║ □ 2. mad_final_check() EXECUTED? ║
|
|
721
|
+
║ → You MUST run mad_final_check() after all merges ║
|
|
722
|
+
║ → This checks build/lint on the entire project ║
|
|
723
|
+
║ → DO NOT SKIP THIS STEP! ║
|
|
724
|
+
║ ║
|
|
725
|
+
║ □ 3. SESSION ERRORS FIXED? ║
|
|
726
|
+
║ → If mad_final_check found SESSION errors, they MUST be fixed ║
|
|
727
|
+
║ → Create a fix worktree and spawn mad-fixer ║
|
|
728
|
+
║ → Re-run mad_final_check until session errors = 0 ║
|
|
729
|
+
║ ║
|
|
730
|
+
║ □ 4. CLEANUP COMPLETED? ║
|
|
731
|
+
║ → Run mad_cleanup() for ALL worktrees ║
|
|
732
|
+
║ → Verify with mad_status() that worktree list is empty ║
|
|
733
|
+
║ ║
|
|
734
|
+
╚══════════════════════════════════════════════════════════════════════════════╝
|
|
735
|
+
```
|
|
736
|
+
|
|
737
|
+
### ⚠️ WARNING: Common Mistakes to Avoid
|
|
738
|
+
|
|
739
|
+
| ❌ WRONG | ✅ CORRECT |
|
|
740
|
+
|----------|-----------|
|
|
741
|
+
| Skip mad_final_check because "tests passed" | ALWAYS run mad_final_check after merges |
|
|
742
|
+
| Declare done with worktrees still pending | Merge or cleanup ALL worktrees first |
|
|
743
|
+
| Ignore session errors from mad_final_check | Fix ALL session errors before declaring done |
|
|
744
|
+
| Leave worktrees behind after session | Cleanup ALL worktrees |
|
|
745
|
+
|
|
746
|
+
### 🔴 ABSOLUTE REQUIREMENTS
|
|
747
|
+
|
|
748
|
+
1. **mad_final_check() is NOT optional** - It catches integration issues that individual tests miss
|
|
749
|
+
2. **Session errors are YOUR responsibility** - Pre-existing errors can be reported, but session errors MUST be fixed
|
|
750
|
+
3. **Cleanup is mandatory** - Don't leave worktrees cluttering the repo
|
|
751
|
+
|
|
752
|
+
### ✅ Correct End-of-Session Flow
|
|
753
|
+
|
|
754
|
+
```
|
|
755
|
+
1. mad_status() → Verify all worktrees are DONE
|
|
756
|
+
2. mad_merge() x N → Merge all completed worktrees
|
|
757
|
+
3. mad_final_check() → Run global build/lint check
|
|
758
|
+
4. [If errors] Fix them → Create worktree, spawn fixer, merge
|
|
759
|
+
5. mad_final_check() → Re-verify (repeat until clean)
|
|
760
|
+
6. mad_cleanup() x N → Remove all worktrees
|
|
761
|
+
7. mad_status() → Confirm worktree list is empty
|
|
762
|
+
8. Report to user → NOW you can say "DONE" 🎉
|
|
763
|
+
```
|
|
764
|
+
|
|
765
|
+
> **🚨 IF YOU DECLARE "DONE" WITHOUT COMPLETING THIS CHECKLIST, YOU HAVE FAILED! 🚨**
|