Skip to content
cccskills
FreePublished on GitHub

delivery-orchestrator

Decompose an epic into atomic parallelizable tasks, route each to the right skill, and keep the four delivery records straight — issues, STATUS, ROADMAP, CHANGELOG. Use as a meta-router when several skills could apply, and as the baseline for how delivery state is recorded. Trigger at the start of any multi-track epic, when the skill count exceeds ~12, or when the records have drifted from reality.

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

Works withGoogle Cloud
See how to install

Files included (1)

  • SKILL.md8.5 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Delivery Orchestrator

A skill for choosing skills. Once your harness grows past a handful of skills, the agent needs a way to select the right one. This is that skill.

The orchestrator has three jobs: decompose work into the smallest independently executable units, route each unit to the skill that owns it, and keep the delivery records honest — because a plan nobody can trust is worse than no plan, and it takes longer to discover.

When to use

  • Starting a new epic or multi-track piece of work
  • When an agent is about to attempt everything in one context window
  • When parallel execution across multiple agents is needed
  • When you need to decide which skill applies to an incoming task
  • When the records have drifted — a status file that stops before today's work, a roadmap asking for a decision already made, a tracker claiming gated with nothing that walks it

The delivery records — the baseline

One fact, one owner. Four artefacts carry delivery state, and each answers exactly one question. Full doctrine, including the issue template and the audit: docs/DELIVERY-RECORDS.md.

RecordThe one question it answersWritten when
GitHub issuesWhat exactly is this work, and how will we know it is done?Before the first line of code
STATUS.mdWhat is happening now, and what waits on whom?One entry per working session
ROADMAP.mdWhat are we building toward, in what order?When a milestone or the plan changes
CHANGELOG.mdWhat merged or released, with checks and version links?When user-visible work merges

The four rules that keep them from drifting:

  1. ROADMAP owns build order. Where another document disagrees about what is next, the roadmap wins.
  2. CHANGELOG records the proven, not the intended. A changelog of intentions reads as evidence, which makes it worse than none.
  3. An issue not filed is not started. The tracker is current before the code, because the failure this prevents is work that accretes from a small fix and is reconciled afterwards, if at all.
  4. gated means a test proves a user can reach it; shipped means a person used it. These two are the ones routinely overclaimed. Code existing is built, and deployment is not shipping.

Golden-thread ownership

For intake, dispatch, scope changes and completion, follow the golden-thread section of the adopting project's DELIVERY-WORKFLOW.md, located by its profile. Without an adopted workflow, start with operating-model-bootstrap in the consumer project. Use the workflow template as a checklist while mapping existing records; unresolved placeholders are project questions, not executable paths or permission to invent defaults. Product Owner maintains accepted intent and priorities; CXO provides material oversight; test strategy corroborates coverage. The orchestrator actions and reconciles the tickets, dependencies, status and delivery links. Check in-flight owners before selecting roadmap work.

Procedure

Part 1 — Decomposition

  1. Read the spec or brief — confirm a feature spec or HLD exists. If not, invoke spec-first-delivery first.
  2. Identify tracks — group work into independent tracks (e.g. backend API, frontend, infrastructure, testing). Tracks can run in parallel. Dependencies between tracks must be explicit.
  3. Break each track into atomic tasks — an atomic task is one that:
    • Can be assigned to a single agent
    • Has a clear input and a clear output
    • Does not require coordination with another concurrent task to complete
    • Can be validated independently
  4. Sequence dependencies — where task B requires output from task A, mark the dependency. Everything else is parallel.
  5. Assign context boundaries — each agent gets only the context it needs. Avoid stuffing all specs into every agent's context.

Part 2 — Skill routing

  1. Map each task to a skill using the routing table below. If no skill matches exactly, use the closest and note the gap.
  2. Validate integration after parallel work — run the full regression suite (make check or the project's equivalent convergence command) after all parallel tracks complete. Parallel work that skips integration validation is not done.

Skill routing table

Task typeRoute to skill
New feature / epic planningspec-first-delivery
Vision, requirements, user journeys and product acceptanceproduct-owner
Material strategic, cost/risk or operating ownership decisioncxo-oversight
Acceptance coverage and executable user-path checkstest-strategy
Architecture decision or trade-offthe-architect
High-stakes design reviewadversarial-gate
Pre-deployment go/no-gorelease-readiness
Release process governance, SemVer, ADR, changelogrelease-manager
Enterprise policy, compliance, or governance alignmentgovernance-guardrail
GitHub repo operations: CI triggers, billing, issues, labels, branch protectiongithub-manager
Google ADK agent patternsadk-expert
Cloud infrastructure guardrails (GCP, AWS, Azure, Alibaba Cloud)cloud-expert
MCP server design or governancemcp-server-scaffold
Agent output validationdomain-validator
PR or code reviewpr-reviewer
LLM cost or model selectioncost-guardrail
Status or standup synthesissitrep
Plugin-directory, marketplace, or curated-list submissionplugin-submission
New repo or operating model install / repairoperating-model-bootstrap
Delivery controls: source of truth, issue/PR conventions, DoD, escalationdelivery-orchestrator (own it here)
An agreed goal to pursue autonomously to a merged outcomeget-it-done
Developer-machine contention, orphaned automation browsers, cloud-sync stallssystem-performance-guardrail
Read-only SRE checkup of a GCP project: probes, status table, one OVERALL: linecloud-checkup
Frontend performance measurement: Core Web Vitals, traces, Lighthouse, heap growthfrontend-performance-audit
Routing this listdelivery-orchestrator (you are here)

Adoption and review recovery

Use the adoption guide to reconcile conversational requirements, skill maintenance ownership, early operational dependencies and measured improvement. Preserve one integration owner and include review/integration in WIP.

Before consequential review declare the work-item attempt/time ceiling. On repeated findings or exhaustion, follow Council loop recovery; changing candidate or reviewer never erases unresolved findings or spent attempts.

Outputs

  • Task breakdown: tracks, atomic tasks, dependencies
  • Skill routing: task → skill mapping
  • Parallel execution plan with integration validation step
  • A brief orchestration summary for the human lead

Guardrails

  • Atomic means independently validatable. If you cannot describe how to verify a task in isolation, it is not atomic — split it further or merge it with its dependency.
  • Parallel agents must not share mutable state without a coordination strategy. If two tracks write to the same file or schema, they are not independent. Use worktrees or serialise them.
  • Integration validation is not optional. Parallel work that skips the post-merge regression check is not complete.
  • Keep agent context lean. Each agent gets its task spec and relevant ADRs, not the entire repo.

Model choice at the delegation boundary

Use the adopting project's model-routing policy before dispatch. Record requested model/effort, allowed paths, Definition of Done and independent checks. Prefer deterministic tools where sufficient; do not equate a smaller task with a qualified cheaper model. Track failed attempts, escalation and parent integration costs. Preserve existing risk floors and stop rules. The routing guide shows a reversible approach; it does not automatically enable routing in consumers.

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

Google ADK (Agent Development Kit) orchestration patterns — boundaries, agent composition, and tool seams. Trigger when designing or reviewing multi-agent systems built on ADK. Authoritative source: adk.dev.

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

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

JP's signature red-team pass — "how would I break this?" Argue against your own approach before proceeding. Trigger on any high-stakes decision, architecture choice, or before marking work complete.

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

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

Read-only SRE checkup of any GCP project: deterministic probes of the edge, Cloud Run services, 7-day error logs, Cloud Scheduler, alert policies and uptime checks, Secret Manager and IAM, the data stores and the machine's own scheduled jobs, audited into one fixed status table (LIVE / WARNING / RED / INCONCLUSIVE) with evidence, findings by severity, what could not be checked, and a single OVERALL line delivered as one notification. Parametrised by a per-project manifest, so the same routine runs on every project. Use when the operator says "cloud checkup", "SRE check", "is everything live", "what's healthy / warning / red", "any errors this week", "audit the infra", "weekly checkup", "set up the weekly checkup", before a deploy or demo, or after an incident. Cloud Run first; App Engine and GKE differ only in the serving probes.

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

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

Cloud guardrails for any vendor workload — Google Cloud (GCP, Vertex AI, GKE), AWS (IAM, EKS, Bedrock), Azure (Entra ID, Policy, AKS), Alibaba Cloud (RAM, mainland/international residency). Enforces identity least-privilege, mechanical policy, data boundaries, residency, cost caps, network egress and observability, with official-source validation before any claim. Trigger on any cloud infrastructure design, review, Terraform plan, or LLM/agent deployment; the-architect routes here.

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

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

LLM and cloud cost awareness — model tiering, token budgets, right-sizing, and when a cheaper model suffices. Trigger before finalising any architecture that calls LLMs, before scaling a workload, or when a cost estimate is needed.

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

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

Challenge vision alignment, value, cost, risk and operating ownership at material scope or release decisions.

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

jpantsjoha/ai-native-developer-experience13Updated Oct 16, 2026

See all skills by jpantsjoha

Report a problem with this skill