Ultrathink Orchestrator Skill
Purpose
This skill provides automatic orchestration for development and investigation tasks. It detects the task type from keywords and delegates to the appropriate workflow skill (investigation-workflow or default-workflow).
Auto-activation priority is LOW (5) to allow more specific skills to match first. When activated, this orchestrator selects between investigation-workflow and default-workflow based on the user's request keywords.
This skill acts as a thin wrapper around the canonical ultrathink command, following the amplihack pattern of single-source-of-truth for command logic.
Canonical Sources
This skill is a thin wrapper that references canonical sources:
- Primary Command:
~/.amplihack/.claude/commands/amplihack/ultrathink.md
- Workflow Sources:
- Development:
~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md
- Investigation:
~/.amplihack/.claude/workflow/INVESTIGATION_WORKFLOW.md
The canonical command contains complete task detection logic, complexity estimation, and orchestration patterns for both investigation and development workflows.
⛔ MANDATORY EXECUTION PROCESS (5 Steps)
When this skill is activated, you MUST follow this exact 5-step process:
Step 1: Read Canonical Command (MANDATORY)
Read(file_path="~/.amplihack/.claude/commands/amplihack/ultrathink.md")
Validation Checkpoint: Confirm ultrathink.md content is loaded before proceeding.
Step 2: Detect Task Type (MANDATORY)
Analyze user request using keywords from canonical command:
- Q&A keywords: what is, explain briefly, quick question, how do I run, simple question
- Investigation keywords: investigate, explain, understand, analyze, research, explore
- Development keywords: implement, build, create, add feature, fix, refactor, deploy
- Hybrid tasks: Both investigation and development keywords present
Validation Checkpoint: Task type must be determined (Q&A, Investigation, Development, or Hybrid).
Step 3: Invoke Workflow Skill (MANDATORY - BLOCKING)
⛔ THIS IS A BLOCKING REQUIREMENT - Session will be terminated if skipped.
For Q&A tasks:
Read(file_path="~/.amplihack/.claude/workflow/Q&A_WORKFLOW.md")
For Investigation tasks:
Skill(skill="investigation-workflow")
For Development tasks:
Skill(skill="default-workflow")
For Hybrid tasks:
Skill(skill="investigation-workflow")
# After investigation completes:
Skill(skill="default-workflow")
Validation Checkpoint: Confirm Skill tool was invoked OR proceed to Step 4.
Step 4: Fallback to Read Tool (IF Step 3 Fails)
Only if skill invocation fails, use Read tool as fallback:
Investigation fallback:
Read(file_path="~/.amplihack/.claude/workflow/INVESTIGATION_WORKFLOW.md")
Development fallback:
Read(file_path="~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md")
Validation Checkpoint: Confirm workflow content is loaded in context.
Step 5: Execute Workflow Steps (MANDATORY)
Follow all steps from loaded workflow without skipping.
Validation Checkpoint: All workflow steps must be completed.
Enforcement
Power-Steering Detection:
- Validates Skill tool invocation occurred
- Validates Read tool fallback if Skill failed
- Blocks session termination if workflow not loaded
Self-Check Protocol:
Before proceeding past Step 3, verify:
No Shortcuts:
- You cannot skip workflow invocation
- You cannot assume workflow content
- You must use Skill or Read tool explicitly
Why This Pattern
Benefits:
- Single source of truth for orchestration logic in canonical command
- No content duplication between command and skill
- Task detection rules defined once, maintained once
- Changes to ultrathink command automatically inherited by skill
Trade-offs:
- Requires Read tool call to fetch canonical logic
- Slight indirection vs. inline implementation
This pattern aligns with amplihack philosophy: ruthless simplicity through elimination of duplication.
Related Files
- Canonical Command:
~/.amplihack/.claude/commands/amplihack/ultrathink.md
- Development Workflow Skill:
~/.amplihack/.claude/skills/default-workflow/
- Investigation Workflow Skill:
~/.amplihack/.claude/skills/investigation-workflow/
- Canonical Workflows:
~/.amplihack/.claude/workflow/DEFAULT_WORKFLOW.md
~/.amplihack/.claude/workflow/INVESTIGATION_WORKFLOW.md