Agent-Skills.md

Agent Skills: Debundle Orchestrator

Coordinate a generic AI-driven debundling loop across intake, lane worker, architect, integrator, planning, and naming skills. Use for multi-agent debundle rounds, work routing, graph refreshes, gate/regen command broadcast, progress tracking, and adapter-specific workflow control.

UncategorizedID: agentydragon/ducktape/debundle_orchestrator

Repository

agentydragon/ducktape
agentydragon
41

Install this agent skill to your local

pnpm dlx add-skill https://github.com/agentydragon/ducktape/tree/HEAD/devinfra/js/debundle/skills/debundle_orchestrator

Skill Files

Browse the full folder contents for debundle_orchestrator.

Download Skill

Loading file tree…

devinfra/js/debundle/skills/debundle_orchestrator/SKILL.md

Skill Metadata

Name
debundle_orchestrator
Description
Coordinate a generic AI-driven debundling loop across intake, lane worker, architect, integrator, planning, and naming skills. Use for multi-agent debundle rounds, work routing, graph refreshes, gate/regen command broadcast, progress tracking, and adapter-specific workflow control.

Debundle Orchestrator

Use this role to keep an AI-driven debundling loop moving. The orchestrator routes work between specialist roles and owns project-adapter details.

Shared CLI workflows land here so planner, intake, and worker routing use the same command semantics:

@references/docs/cli.md @references/docs/spec_editing.md

Read other bundled references as needed:

  • references/workflow.md for the shared multi-agent workflow
  • references/README.md for the crate pitch + Comments
  • references/docs/bazel_integration.md for the debundle_pipeline rule and profiling targets
  • references/module_shape.md for when to route to architect or lane workers
  • references/docs/selectors.md for the bar selector-stabilization work must meet

Adapter Contract

Before dispatching work, collect:

  • <debundle-target> and graph-refresh command
  • <graph>, <modules-dir>, <emitted-js-root>, source root if available
  • gate, regen, uniqueness-check, and optional smoke-test commands
  • project conventions/taxonomy docs
  • architecture notes and reorg recommendation paths
  • worktree policy, base branch, commit/push policy, and scratch paths

Role Routing

  • Use debundle_plan_work to refresh planner evidence.
  • Send modules propose output to debundle_intake for seeds.
  • For selector-stabilization rounds, start with debundle spec selector-debt --group-module-depth N --format json and dispatch broad, coherent buckets to lane workers. Prefer buckets that can be handled by debundle spec synthesize-selectors over hand-authored YAML; the bar their output must meet is references/docs/selectors.md § The contract and the ladder.
  • Send seed clusters or reorg tasks to debundle_lane_worker.
  • Wake debundle_architect periodically or when module shape seems to drift.
  • Use debundle_integrator for merge trains of worker commits.
  • Use debundle_mint_names for naming-only passes.

Do not absorb specialist work when it becomes substantial. If you are reading many source bodies, dispatch intake. If you are redesigning module shape, dispatch the architect. If you are hand-landing worker commits one by one, dispatch the integrator.

Round Loop

  1. Refresh the debundle outputs, manifest, and owner graph.
  2. Run debundle modules propose and debundle graph-summary to update progress metrics. Use graph-summary --include-proposals only when proposal and diagnostic counts are needed.
  3. For structural-selector cleanup, run selector-debt with module grouping, choose high-yield buckets, and decide whether missing support should become Ducktape tooling work before asking humans or workers to hand-edit many selectors. Do not dispatch work whose expected output is a pile of manually maintained exact generated bodies.
  4. Ask intake for dispatchable seeds. Only landable_today: true proposals are directly dispatchable; what the others need first: references/docs/cli.md § --batch JSON format.
  5. Dispatch independent lane workers and any reorg/naming/doc cleanup work.
  6. Integrate green worker branches in batches.
  7. Rerun gate, regen, and adapter smoke tests as required.
  8. Update queues, architecture notes, and durable project conventions.

Prefer larger parallel fan-out only when write scopes are disjoint and each worker has an isolated worktree/output base.

State

Track work by stable owner IDs and binding IDs, not only generated proposal IDs. Maintain:

  • inflight assignments
  • landed assignments
  • failed/blocker diagnostics
  • graph/build command that produced the current evidence
  • progress metrics such as residual owners, patch-stream members, named module fraction, selector-debt totals, grouped selector-debt buckets, and largest remaining generated files

Failure Policy

  • Environment failure: find one working command, then broadcast it.
  • Stale graph: refresh evidence before reassigning blame.
  • Gate failure: read structured cycle/report output before bisection.
  • Split atomic unit: expand one lane to cover the whole unit or redispatch as a coordinated task.
  • Repeated unclear destinations: wake architect rather than creating a grab-bag module.

Boundaries

  • Do not modify the upstream/source bundle in reverse-engineering workflows.
  • Do not let public generic guidance override project-local conventions.
  • Do not put private project names, paths, or product assumptions into the generic role prompts; adapters supply those.