CCS Delegation

Delegate deterministic tasks to cost-optimized models via CCS CLI.

Core Concept

Execute tasks via alternative models using:

• Initial delegation: ccs {profile} -p "task"
• Session continuation: ccs {profile}:continue -p "follow-up"

Profile Selection:

• Auto-select from ~/.ccs/config.json via task analysis
• Profiles: glm (cost-optimized), kimi (long-context/reasoning), custom profiles
• Override: --{profile} flag forces specific profile

User Invocation Patterns

Users trigger delegation naturally:

• "use ccs task]" - Auto-select best profile
• "use ccs --glm task]" - Force GLM profile
• "use ccs --kimi task]" - Force Kimi profile
• "use ccs:continue task]" - Continue last session

Examples:

• "use ccs to fix typos in README.md"
• "use ccs to analyze the entire architecture"
• "use ccs --glm to add unit tests"
• "use ccs:continue to commit the changes"

Agent Response Protocol

For /ccs [task]:

1. Parse override flag

• Scan task for pattern: --(\w+)
• If match: profile = match[1], remove flag from task, skip to step 5
• If no match: continue to step 2

1. Discover profiles

• Read ~/.ccs/config.json using Read tool
• Extract Object.keys(config.profiles) → availableProfiles[]
• If file missing → Error: "CCS not configured. Run: ccs doctor"
• If empty → Error: "No profiles in config.json"

1. Analyze task requirements

• Scan task for keywords:
• /(think|analyze|reason|debug|investigate|evaluate)/i → needsReasoning = true
• /(architecture|entire|all files|codebase|analyze all)/i → needsLongContext = true
• /(typo|test|refactor|update|fix)/i → preferCostOptimized = true

1. Select profile

• For each profile in availableProfiles: classify by name pattern (see Profile Characteristic Inference table)
• If needsReasoning: filter profiles where reasoning=true → prefer kimi
• Else if needsLongContext: filter profiles where context=long → prefer kimi
• Else: filter profiles where cost=low → prefer glm
• selectedProfile = filteredProfiles[0]
• If filteredProfiles.length === 0: fallback to glm if exists, else first available
• If no profiles: Error

1. Enhance prompt

• If task mentions files: gather context using Read tool
• Add: file paths, current implementation, expected behavior, success criteria
• Preserve slash commands at task start (e.g., /cook, /commit)

1. Execute delegation

• Run: ccs {selectedProfile} -p "$enhancedPrompt" via Bash tool

1. Report results

• Log: "Selected {profile} (reason: {reasoning/long-context/cost-optimized})"
• Report: Cost (USD), Duration (sec), Session ID, Exit code

For /ccs:continue [follow-up]:

1. Detect profile

• Read ~/.ccs/delegation-sessions.json using Read tool
• Find most recent session (latest timestamp)
• Extract profile name from session data
• If no sessions → Error: "No previous delegation. Use /ccs first"

1. Parse override flag

• Scan follow-up for pattern: --(\w+)
• If match: profile = match[1], remove flag from follow-up, log profile switch
• If no match: use detected profile from step 1

1. Enhance prompt

• Review previous work (check what was accomplished)
• Add: previous context, incomplete tasks, validation criteria
• Preserve slash commands at start

1. Execute continuation

• Run: ccs {profile}:continue -p "$enhancedPrompt" via Bash tool

1. Report results

• Report: Profile, Session #, Incremental cost, Total cost, Duration, Exit code

Decision Framework

Delegate when:

• Simple refactoring, tests, typos, documentation
• Deterministic, well-defined scope
• No discussion/decisions needed

Keep in main when:

• Architecture/design decisions
• Security-critical code
• Complex debugging requiring investigation
• Performance optimization
• Breaking changes/migrations

Profile Selection Logic

Task Analysis Keywords (scan task string with regex):

| Pattern | Variable | Example | |---------|----------|---------| | /(think\|analyze\|reason\|debug\|investigate\|evaluate)/i | needsReasoning = true | "think about caching" | | /(architecture\|entire\|all files\|codebase\|analyze all)/i | needsLongContext = true | "analyze all files" | | /(typo\|test\|refactor\|update\|fix)/i | preferCostOptimized = true | "fix typo in README" |

Profile Characteristic Inference (classify by name pattern):

| Profile Pattern | Cost | Context | Reasoning | |----------------|------|---------|-----------| | /^glm/i | low | standard | false | | /^kimi/i | medium | long | true | | /^claude/i | high | standard | false | | others | low | standard | false |

Selection Algorithm (apply filters sequentially):

profiles = Object.keys(config.profiles)
classified = profiles.map(p => ({name: p, ...inferCharacteristics(p)}))

if (needsReasoning):
  filtered = classified.filter(p => p.reasoning === true).sort(['kimi'])
else if (needsLongContext):
  filtered = classified.filter(p => p.context === 'long').sort(['kimi'])
else:
  filtered = classified.filter(p => p.cost === 'low').sort(['glm', ...])

selected = filtered[0] || profiles.find(p => p === 'glm') || profiles[0]
if (!selected): throw Error("No profiles configured")

log("Selected {selected} (reason: {reasoning|long-context|cost-optimized})")

Override Logic:

• Parse task for /--(\w+)/. If match: profile = match[1], remove from task, skip selection

Example Delegation Tasks

Good candidates:

• "/ccs add unit tests for UserService using Jest"

→ Auto-selects: glm (simple task)

• "/ccs analyze entire architecture in src/"

→ Auto-selects: kimi (long-context)

• "/ccs think about the best database schema design"

→ Auto-selects: kimi (reasoning)

• "/ccs --glm refactor parseConfig to use destructuring"

→ Forces: glm (override)

Bad candidates (keep in main):

• "implement OAuth" (too complex, needs design)
• "improve performance" (requires profiling)
• "fix the bug" (needs investigation)

Execution

Commands:

• /ccs "task" - Intelligent delegation (auto-select profile)
• /ccs --{profile} "task" - Force specific profile
• /ccs:continue "follow-up" - Continue last session (auto-detect profile)
• /ccs:continue --{profile} "follow-up" - Continue with profile switch

Agent via Bash:

• Auto: ccs {auto-selected} -p "task"
• Continue: ccs {detected}:continue -p "follow-up"

References

Template: CLAUDE.md.template - Copy to user's CLAUDE.md for auto-delegation config Troubleshooting: references/troubleshooting.md