Context Engineering: Optimization Orchestrator
When invoked, orchestrate context engineering optimization with interactive scoping:
Process
Interactive Scoping (if no --auto flag)
- Ask up to 4 multiple choice questions to define scope
- Questions cover: optimization focus, codebase areas, enhancement types, priority order
- Skip questions if --scope or --auto flag provided
Context System Audit
- Analyze
.claude/directory structure - Check workflow file coverage and accuracy
- Verify index file completeness
- Identify orphaned or outdated files
- Assess agent and command coverage gaps
- Analyze
Generate RPI TODO List
- Create actionable TODO with research, plan, implement phases
- Save to
.claude/plans/active/context-optimization_plan.md - Include specific commands for each task
Redundant File Detection
- Find files not referenced by any index
- Identify duplicate or overlapping content
- Flag outdated files with stale line references
- Report empty placeholder files
Enhancement Recommendations
- Suggest new specialized agents based on codebase patterns
- Recommend workflow commands for common tasks
- Identify undocumented workflows needing documentation
Scoping Questions (Max 4)
Q1: Optimization Focus
- A) Functionalize the entire context engineering system
- B) Update outdated documentation and line references
- C) Identify and remove redundant context files
- D) Discover enhancement opportunities (new agents/commands)
Q2: Codebase Coverage
- A) Core business logic
- B) API/External integrations
- C) Database/Data layer
- D) All areas equally
Q3: Enhancement Preferences
- A) New specialized agents for specific domains
- B) New workflow commands for common tasks
- C) Improved documentation structure
- D) Better cross-referencing and navigation
Q4: TODO Priority Order
- A) Quick wins first (< 30 min each)
- B) High impact first (regardless of effort)
- C) By workflow area (grouped logically)
- D) By dependency order (foundational first)
Context Budget
- Target: 20% of 200k tokens (40k)
- Output: TODO checklist + recommendations
Output
- TODO checklist saved to
.claude/plans/active/context-optimization_plan.md - Audit findings in
.claude/research/active/context-audit_research.md
Arguments
$ARGUMENTScan include:--auto- Use intelligent defaults, skip questions--scope documentation- Focus on docs only--scope agents- Focus on agent gaps--scope workflows- Focus on workflow coverage--scope cleanup- Focus on redundant file removal
Next Steps
After completion, execute the generated TODO list:
/rpi-research [first-research-task]/rpi-plan [first-plan-task]/rpi-implement [first-impl-task]/validate-all