Skip to content
cccskills
FreePublished on GitHub

subagent-driven-development

Use fresh agents for focused subtasks to avoid context pollution

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md3.1 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Subagent Driven Development

Core Concept

FRESH AGENT = FRESH CONTEXT
Use subagents for focused work without baggage

When to Use Subagents

SituationWhy Subagent Helps
Complex subtaskFocused context, clear scope
Going in circlesFresh perspective breaks loops
Parallel workMultiple things at once
Context pollutionMain agent too cluttered
Specialized taskPass only relevant info
Research/explorationKeep main context clean

How to Launch Subagent

The Handoff:

1. DEFINE clear scope - what exactly to do
2. PROVIDE needed context - files, constraints, requirements
3. SPECIFY deliverable - what to return
4. SET success criteria - how to know it's done

Template:

Task: [Specific action to take]

Context:
- Working in [repo/directory]
- Relevant files: [list]
- Constraints: [any limits]

Deliverable:
- [Exact output expected]

Success when:
- [Criteria 1]
- [Criteria 2]

Anti-Patterns

❌ Vague handoffs

Bad: "Look into this bug"
Good: "Find root cause of TypeError in user.ts:45"

❌ Context dumping

Bad: Passing entire conversation history
Good: Passing only relevant files and specific question

❌ No success criteria

Bad: "Make it better"
Good: "Refactor to reduce duplication, all tests must pass"

❌ Too broad scope

Bad: "Implement the whole feature"
Good: "Implement the validation logic for email field"

Good Subagent Tasks

✅ Research:

  • "Find how X is implemented in this codebase"
  • "Search for similar patterns in the repo"
  • "Understand the data flow from A to B"

✅ Focused fixes:

  • "Fix the specific test failure in X"
  • "Resolve the lint error in file Y"
  • "Update function Z to handle edge case"

✅ Generation:

  • "Generate tests for this function"
  • "Create documentation for this module"
  • "Write migration for schema change"

✅ Analysis:

  • "Analyze dependencies of this module"
  • "Identify all usages of this API"
  • "Review this PR for issues"

Receiving Subagent Results

When subagent returns:

1. READ the full response
2. VERIFY against success criteria
3. INTEGRATE results into main context
4. CONTINUE from where you left off

Integration with Checkers

Before launching subagent:

  • scope-boundary-checker → Is scope clear and bounded?
  • assumption-checker → Are handoff assumptions valid?

After receiving results:

  • fact-checker → Verify subagent claims
  • pre-action-verifier → Before using results

Context Management

Main agent responsibilities:

  • High-level plan
  • User communication
  • Final integration
  • Overall progress

Subagent responsibilities:

  • Focused execution
  • Detailed work
  • Return clean results
  • No side conversations

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Complete methodology for preventing AI hallucinations. Use when accuracy is critical and you need Claude to verify before claiming, cite before asserting, and admit uncertainty instead of guessing.

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Transform rough ideas into solid designs through structured questioning

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Canvas API Connection Skill

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Forces every code-related claim to include file:line citations. No citation means the claim must be verified or removed. Use when building documentation, writing code reviews, or any output that others will rely on.

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Assign confidence scores (0-100) to every claim in a response. Helps users understand which parts are verified facts and which are educated guesses. Use when the user needs to know how much to trust each part of the answer.

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

Forces Claude to extract exact quotes from files before making claims about them. Prevents hallucinations by grounding every statement in actual text from the codebase. Use when working with large files or unfamiliar code.

The English summary is being prepared. Showing the original description.

a-ariff/ariff-claude-plugins14Updated Mar 29, 2026

See all skills by a-ariff

Report a problem with this skill