mode-controller

Mode Controller Skill

Expert in managing craft plugin execution modes for different use cases.

Mode Definitions

Mode	Time Budget	Use Case	Behavior
default	< 10s	Quick tasks	Minimal output, fast
debug	< 120s	Problem solving	Verbose, traces, detailed
optimize	< 180s	Performance	Profiling, benchmarks
release	< 300s	Pre-release	Thorough, comprehensive

When to Use Each Mode

Default Mode

• Quick code checks
• Simple lookups
• Status queries
• Day-to-day operations

Debug Mode

• Investigating errors
• Tracing execution
• Understanding behavior
• Finding root causes

Optimize Mode

• Performance profiling
• Identifying bottlenecks
• Memory analysis
• Speed improvements

Release Mode

• Pre-deployment validation
• Complete test suites
• Documentation checks
• Full audits

Mode Selection Logic

If user specifies mode → use that mode
Else if error/bug context → debug mode
Else if performance context → optimize mode
Else if release/deploy context → release mode
Else → default mode

Mode-Specific Behaviors

Code Commands

Command	Default	Debug	Optimize	Release
lint	Quick check	All rules + fix suggestions	Perf rules	All rules + strict
coverage	Summary	Line-by-line	Branch analysis	Full report
deps-check	Version only	Dependency tree	Size analysis	Security + licenses
ci-local	Fast checks	Full trace	Parallel jobs	All CI steps

Test Commands

Command	Default	Debug	Optimize	Release
run	Quick tests	Verbose + traces	Parallel	Full suite
coverage	Summary %	Uncovered lines	Branch %	HTML report
debug	Quick trace	Full stack trace	Profiling	All info

Architecture Commands

Command	Default	Debug	Optimize	Release
analyze	Overview	Deep dive	Hotspots	Full audit
review	Quick check	Line-by-line	Perf review	Comprehensive
diagram	Simple	Detailed	Data flow	Complete

Documentation Commands

Command	Default	Debug	Optimize	Release
validate	Links only	All checks	Load time	Full validation
sync	Changed files	All files + diff	Minimal updates	Complete sync
changelog	Recent	Full history	Compact	Detailed

Integration

This skill is automatically activated when:

• User includes mode keyword (debug, optimize, release)
• Context suggests specific mode
• Command supports mode parameter

Example Usage

/craft:code:lint                    # default mode
/craft:code:lint debug              # debug mode - verbose
/craft:code:lint optimize           # optimize mode - perf focus
/craft:code:lint release            # release mode - thorough

Output Format by Mode

Default

✓ Lint passed (3 files checked)

Debug

╭─ Lint Results (Debug Mode) ─────────────────────────╮
│ Files: 3                                            │
│ Rules: 45 active                                    │
├─────────────────────────────────────────────────────┤
│ src/main.py:12  - Line too long (82 > 80)          │
│ src/main.py:45  - Unused import 'os'               │
│ src/utils.py:8  - Missing docstring                │
├─────────────────────────────────────────────────────┤
│ Suggestions:                                        │
│   - Run: ruff check --fix                          │
╰─────────────────────────────────────────────────────╯

Optimize

╭─ Lint Results (Optimize Mode) ──────────────────────╮
│ Performance Impact:                                 │
│   - 2 inefficient patterns found                   │
│   - Estimated speedup: 15% with fixes              │
├─────────────────────────────────────────────────────┤
│ src/main.py:30  - Use list comprehension           │
│ src/utils.py:15 - Cache repeated call              │
╰─────────────────────────────────────────────────────╯

Release

╭─ Lint Results (Release Mode) ───────────────────────╮
│ Status: READY FOR RELEASE                          │
├─────────────────────────────────────────────────────┤
│ ✓ Style checks passed (45 rules)                   │
│ ✓ Type hints validated                             │
│ ✓ Documentation coverage: 95%                      │
│ ✓ No security issues                               │
│ ✓ License headers present                          │
├─────────────────────────────────────────────────────┤
│ Quality Score: 98/100                              │
╰─────────────────────────────────────────────────────╯