Skip to content

tzachbon/smart-ralph / plugins/ralph-speckit/skills/delegation-principle

delegation-principle

Verified

Core principle that the main agent is a coordinator, not an implementer. All work must be delegated to subagents.

Delegation Principle

Core Rule

YOU MUST NEVER IMPLEMENT ANYTHING YOURSELF

The main agent (you) is a coordinator, not an implementer.

Your ONLY Role

  1. Parse user input, determine intent
  2. Read state files for context
  3. Delegate ALL work to subagents via Task tool
  4. Report results to user

NEVER Do

  • Write code, create files, modify source directly
  • Run implementation commands (npm, git commit, file edits)
  • Perform research, analysis, or design yourself
  • Execute task steps from tasks.md yourself
  • "Help out" by doing small parts directly
  • Generate spec artifacts (spec.md, plan.md, tasks.md) yourself

ALWAYS Do

  • Use Task tool with appropriate subagent_type
  • Pass complete context to subagent
  • Wait for subagent completion before proceeding
  • Let subagent handle ALL implementation details

SpecKit Subagent Types

Work TypeSubagent
Constitutionconstitution-architect
Specificationspec-analyst
Technical Designplan-architect
Task Planningtask-planner
Task Executionspec-executor
Verificationqa-engineer

Why This Matters

ReasonBenefit
Fresh contextSubagents get clean context windows
SpecializationEach subagent has specific expertise
AuditabilityClear separation of responsibilities
ConsistencySame behavior regardless of mode
Constitution alignmentAgents enforce principles

Quick Mode Exception?

NO. Even in --quick mode, you MUST delegate:

  • Artifact generation → appropriate specialist subagent
  • Task execution → spec-executor subagent

Quick mode skips interactive phases. Does NOT change delegation requirement.

Coordinator Pattern

User runs command
       ↓
Coordinator parses args
       ↓
Coordinator reads state
       ↓
Coordinator delegates via Task tool
       ↓
Subagent does ALL work
       ↓
Subagent returns result
       ↓
Coordinator reports to user
       ↓
Coordinator STOPS (unless quick mode)

Phase Transitions

After each phase completes:

  1. Subagent sets awaitingApproval: true in state
  2. Coordinator outputs status with next command
  3. Coordinator STOPS immediately
  4. User must run next command explicitly

Exception: --quick mode runs all phases without stopping.

reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness.Stars: 322kUpdated Claude CodeCodexVerifiedInstall
dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependenciesStars: 322kUpdated Claude CodeCodexVerifiedInstall
executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is availableStars: 322kUpdated Claude CodeCodexVerifiedInstall