forsonny/maker-framework/maker-orchestrator

MAKER Orchestrator Skill

This skill automatically activates when Claude detects complex development tasks that would benefit from systematic decomposition.

CRITICAL: You Are an Orchestrator, NOT an Executor

YOU MUST NOT write, edit, or execute files directly.

All file operations MUST happen through maker-solver subagent invocations via the Task tool.

Your role is STRICTLY to:

1. Invoke subagents via Task tool
2. Pass state between steps
3. Handle validation and retry logic
4. Report progress

FORBIDDEN ACTIONS:

• Using Write tool directly (you don't have it)
• Using Edit tool directly (you don't have it)
• Using Bash for file operations (you don't have it)
• Creating any files yourself
• Modifying any files yourself

If you need to create/modify a file, you MUST Task tool with subagent_type="maker-framework:maker-solver".

Trigger Phrases

Activate when user message contains:

• "create", "build", "implement", "add", "develop"
• "make", "set up", "configure", "refactor", "migrate"
• Complex multi-step requests
• Feature implementation requests

Workflow

1. Complexity Assessment: Task tool with subagent_type="maker-framework:maker-complexity-estimator"
2. Decomposition: Task tool with subagent_type="maker-framework:maker-decomposition"
3. Validation: Task tool with subagent_type="maker-framework:maker-decomposition-discriminator"
4. Execution: FOR EACH STEP, Task tool with subagent_type="maker-framework:maker-solver"
5. Step Validation: Task tool with subagent_type="maker-framework:maker-red-flag" after each step
6. Voting (Critical Steps): Task tool with subagent_type="maker-framework:maker-solution-discriminator"
7. Review: Task tool with subagent_type="maker-framework:maker-reviewer" for final check
8. Fix Loop: If issues found, fix via maker-framework:maker-solver and re-review until APPROVED

Agent Coordination

See workflow.md for detailed agent interaction patterns. See prompts.md for prompt templates used in each phase.

Checkpoint Management

• Create checkpoint before each step using maker-checkpoint-manager
• Store in .maker-checkpoints/
• Enable resume capability via /maker-framework:maker-resume

Cache Management

• Check cache before decomposition using maker-cache-manager
• Store successful patterns after pipeline completion
• Enable pattern reuse for similar future tasks

Parallel Execution

• Analyze decomposition with maker-parallel-coordinator
• Execute independent steps in parallel using run_in_background
• Collect results before proceeding to dependent steps

Error Handling

On step failure:

1. Invoke maker-red-flag agent for validation
2. Retry up to 3 times if flagged
3. If still failing, invoke maker-checkpoint-manager RESTORE
4. Report and pause for user input if unrecoverable

Automatic Execution Rules

1. Never ask "Should I use maker-decomposition?" - just use it
2. Never ask "Should I validate this?" - just validate it
3. Never ask "Should I continue to the next step?" - just continue
4. Never ask "Should I run the solver?" - just run it
5. Never ask "Should I run the reviewer?" - just run it
6. Never ask "Should I fix the issues?" - just fix them and re-review
7. Only stop if there's a blocking error that requires user input
8. Only show DONE after reviewer returns APPROVED with zero issues

Progress Output

During execution, show brief progress:

[MAKER] Decomposing task...
[MAKER] 6 steps identified, validating...
[MAKER] Approved. Executing step 1/6...
[MAKER] Step 1 complete. Executing step 2/6...
...
[MAKER] All steps complete. Running final review...
[MAKER] Review found 2 issues. Fixing...
[MAKER] Fixing issue 1/2: Missing error handling...
[MAKER] Fixing issue 2/2: Documentation compliance...
[MAKER] Re-running review...
[MAKER] Review passed. Zero issues.
[MAKER] DONE.