agentleFS
lofingoindialofingoindia/codex-engineering-skills/skills/task-subagent-orchestration/SKILL.md

task-subagent-orchestration

Skill0 starsChanged 13 days agoMITView on GitHub

Scope engineering work, plan cohesive tasks, select skills, and coordinate useful subagent delegation through verification and integration. Use for substantial planning or coordination, including audits, or when deciding whether decomposition is needed; keep small coherent changes direct.

The file

We split this skill into the rules it gives an agent

2 rules. About 0 are common, 2 are distinctive, and 0 are very specific to this project.

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈2

    Distinctive · estimate

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Before task-based implementation, present this readable table in the main chat, with concise rows derived from the investigation:

    line 18
  2. Distinctive:

    Use sources for upstream rationale and limitations.

    line 49

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Task and Subagent Orchestration

Act as the lead responsible for the user's complete outcome. Plan and delegate only when that improves correctness, elapsed time or context use after coordination costs. This skill coordinates existing engineering capabilities; it does not define a new scheduler, agent runtime or project-management framework.

Understand before dividing

Inspect the request, prior decisions, applicable instructions, relevant architecture/current code, callers, dependencies, invariants and existing verification. Read only what the change needs; expand when evidence reveals a wider boundary. Do not invent a plan from a generic feature template or trust stale documents over current implementation.

A contained coherent change can stay with one owner, without a task table, agents or broad research. Directly implement and verify it proportionately. For meaningful dependencies, uncertainty, ownership or verification boundaries, use a formal plan. Scope is a judgment about outcomes and risk, not file/line counts or a required number of tasks.

Formal plans and research

Before task-based implementation, present this readable table in the main chat, with concise rows derived from the investigation:

TaskObjective & ScopeDependenciesSkillsResearch FocusOwnerVerificationStatus

Give each task an ID, cohesive behavioral outcome, owner, boundaries, prerequisites and completion criteria. Planning and skill selection covers the task contract and scope decisions. Keep all requested work represented without turning it into microtasks.

For every substantive task in a formal plan, use engineering-research-intelligence: read/apply its available instructions, identify the task's technical uncertainty, check applicable version-matched upstream evidence against current code, and record concise conclusions. Reuse still-current, directly applicable research; mandatory use does not require rereading the skill or repeating searches. If unavailable, perform equivalent targeted research and disclose the fallback; never claim it was invoked.

Inspect actual available skill descriptions and choose only relevant specialists. Show them in the table and handoff. Do not assume a testing or technology skill exists or load all skills because they are installed.

Delegate useful independent work proactively

For a formal plan, examine the whole remaining plan for worthwhile parallel work, including upcoming tasks. When permitted, tools are available and ownership/resources are safe, delegate ready independent implementation or investigation early. Subagents can write and test within assigned scope; they are not restricted to research. Do not wait for the lead to reach an independent task merely to preserve serial order.

Keep dependent mutations behind resolved prerequisites. Early read-only investigation can proceed without guessing an unfinished contract. Use delegation and integration for the decision, handoff and ownership rules. Check actual context, filesystem/worktree, permission and lifecycle behavior; do not assume isolation. If delegation is unavailable, forbidden or uneconomic, execute lead-owned and state that accurately.

Execute, integrate, and report

Each owner follows investigation, focused research, planning, relevant edge cases/tests, implementation, failure correction and verification within its assigned task. Choose/add meaningful tests for changed behavior; use normal validation for documentation/configuration where appropriate. Do not silently batch unrelated tasks or repeat successful checks without a reason.

The lead reviews actual changes and evidence, resolves interface/resource conflicts, and verifies the relevant integrated behavior. A subagent's self-reported PASS is not integrated proof. Publish a main-chat completion report before marking that task complete and before assigning its owner another task:

Findings → Changes → Tests & Evidence → Pending Issues → Status: PASS / PARTIAL / FAIL / BLOCKED.

State pending integration explicitly. Update task status, then release dependent work only when its prerequisites are satisfied. Reassess and explain significant changes to task boundaries, order, ownership or necessary scope; do not follow an obsolete plan. Continue until the requested outcome is handled or a genuine blocker remains.

Read-only audits

Explicit read-only scope governs every owner and specialist. No agent may fix code or mutate the audited environment. For substantial audits, apply available deep-readonly-system-audit guidance; otherwise preserve its equivalent boundary: one authorized Markdown report, updated alongside meaningful investigation segments and before major transitions/compaction. The report is the sole writable artifact unless the user authorizes others. Assign one report writer to prevent concurrent overwrites. See reporting and audits.

Use sources for upstream rationale and limitations. Report actual delegation, checks and outcomes; do not invent agents, measurements, activation results or end-to-end success.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.