Назад към всички

delegation-core

// Delegate tasks to external LLM services (Gemini, Qwen) with quota, logging, and error handling. Use when tasks exceed context window or need cheaper processing. Do not use when task requires reasoning by Claude.

$ git log --oneline --stat
stars:201
forks:38
updated:March 4, 2026
SKILL.mdreadonly
SKILL.md Frontmatter
namedelegation-core
descriptionDelegate tasks to external LLM services (Gemini, Qwen) with quota, logging,
version1.7.1
alwaysApplyfalse and error handling. Use when tasks exceed context window or need cheaper processing. Do not use when task requires reasoning by Claude.
categorydelegation-framework
tagsdelegation,external-llm,gemini,qwen,task-management,quality-control
dependenciesleyline:quota-management,leyline:usage-logging,leyline:service-registry,leyline:error-patterns,leyline:authentication-patterns
toolsdelegation-executor
usage_patternstask-assessment,delegation-planning,quality-validation,integration-workflows
complexityintermediate
model_hintstandard
estimated_tokens250
progressive_loadingtrue
modulesmodules/task-assessment.md,modules/cost-estimation.md,modules/handoff-patterns.md,modules/troubleshooting.md
referencesleyline/skills/quota-management/SKILL.md,leyline/skills/usage-logging/SKILL.md,leyline/skills/error-patterns/SKILL.md,leyline/skills/authentication-patterns/SKILL.md,leyline/skills/service-registry/SKILL.md,references/execution-modes.md

Table of Contents

Delegation Core Framework

Overview

A method for deciding when and how to delegate tasks to external LLM services. Core principle: delegate execution, retain high-level reasoning.

When To Use

  • Before invoking external LLMs for task assistance.
  • When operations are token-heavy and exceed local context limits.
  • When batch processing benefits from different model characteristics.
  • When tasks require routing between models.

When NOT To Use

  • Task requires reasoning by Claude

Philosophy

Delegate execution, retain reasoning. Claude handles architecture, strategy, design, and review. External LLMs perform data processing, pattern extraction, bulk operations, and summarization.

Delegation Flow

  1. Task Assessment: Classify task by complexity and context size.
  2. Suitability Evaluation: Check prerequisites and service fit.
  3. Handoff Planning: Formulate request and document plan.
  4. Execution & Integration: Run delegation, validate, and integrate results.

Quick Decision Matrix

ComplexityContextRecommendation
HighAnyKeep local
LowLargeDelegate
LowSmallEither

High Complexity: Architecture, design decisions, trade-offs, creative problem solving.

Low Complexity: Pattern counting, bulk extraction, boilerplate generation, summarization.

Detailed Workflow Steps

1. Task Assessment (delegation-core:task-assessed)

Classify the task:

  • See modules/task-assessment.md for classification criteria.
  • Use token estimates to determine thresholds.
  • Apply the decision matrix.

Exit Criteria: Task classified with complexity level, context size, and delegation recommendation.

2. Suitability Evaluation (delegation-core:delegation-suitability)

Verify prerequisites:

  • See modules/handoff-patterns.md for checklist.
  • Evaluate cost-benefit ratio using modules/cost-estimation.md.
  • Check for red flags (security, real-time iteration).

Exit Criteria: Service authenticated, quotas verified, cost justified.

3. Handoff Planning (delegation-core:handoff-planned)

Create a delegation plan:

  • See modules/handoff-patterns.md for request template.
  • Document service, command, input context, expected output.
  • Define validation method.

Exit Criteria: Delegation plan documented.

4. Execution & Integration (delegation-core:results-integrated)

Execute and validate results:

  • Run delegation and capture output.
  • Validate format and correctness.
  • Integrate only after validation passes.
  • Log usage.

Exit Criteria: Results validated and integrated, usage logged.

MCP Authentication

OAuth Client Credentials (Claude Code 2.1.30+)

For MCP servers that don't support Dynamic Client Registration (e.g., Slack), pre-configured OAuth client credentials can be provided:

claude mcp add <server-name> --client-id <id> --client-secret <secret>

This enables delegation workflows through MCP servers that require pre-configured OAuth, expanding the range of external services available for task delegation.

Claude.ai MCP Connectors (Claude Code 2.1.46+)

As an alternative to manual OAuth setup, users can configure MCP servers directly in claude.ai at claude.ai/settings/connectors. These connectors are automatically available in Claude Code when logged in with a claude.ai account — no claude mcp add or credential management required. This provides a browser-based auth flow that may be simpler for services with complex OAuth requirements.

Worktree Isolation for File-Modifying Delegations (Claude Code 2.1.49+)

When delegating tasks that modify files to subagents, use isolation: worktree in the agent frontmatter to run each agent in a temporary git worktree. This prevents file conflicts when multiple delegated agents operate in parallel on overlapping paths. The worktree is auto-cleaned if no changes are made; preserved with commits if the agent produces changes.

# Agent frontmatter for isolated delegation
isolation: worktree

Leyline Infrastructure

Conjure uses leyline infrastructure:

Leyline SkillUsed For
quota-managementTrack service quotas and thresholds.
usage-loggingSession-aware audit trails.
service-registryUnified service configuration.
error-patternsConsistent error handling.
authentication-patternsAuth verification.

See modules/cost-estimation.md for leyline integration examples.

Service-Specific Skills

For detailed service workflows:

  • Skill(conjure:gemini-delegation): Gemini CLI specifics.
  • Skill(conjure:qwen-delegation): Qwen MCP specifics.

Execution Modes

When delegating to multiple agents, choose the appropriate execution mode:

ModeWhen to UseHow It Works
single-sessionSequential tasks, same-file editsClaude works through tasks in order
subagentsParallel independent tasksAgents work independently, report back
agent-teamParallel coordinated tasksAgents can communicate with each other

See references/execution-modes.md for the selection decision matrix, mode compatibility notes, and anti-patterns to avoid.

Module Reference

  • task-assessment.md: Complexity classification, decision matrix.
  • cost-estimation.md: Pricing, budgets, cost tracking.
  • handoff-patterns.md: Request templates, workflows.
  • troubleshooting.md: Common problems, service failures.

Exit Criteria

  • Task assessed and classified.
  • Delegation decision justified.
  • Results validated before integration.
  • Lessons captured.