{"id":"757c973b-5a70-49e3-9a08-22974a3e27c1","shortId":"X9dBKK","kind":"skill","title":"ultra-orchestrator","tagline":"Primary Ultra Orchestration entry point for strict Codex-controlled engineering runs. Use this single skill for development, bug fixes, OpenSpec work, multi-file implementation, review/QA-heavy tasks, risk-gated work, or any run that needs automatic mode selection, OpenSpec boots","description":"# Ultra Orchestrator\n\nUse this skill as the default public entry point for Ultra Orchestration.\nThe user should only need to invoke `$ultra-orchestrator <task description>`.\n\nThis is the mainline successor to the vNext protocol. The old stable workflow\nis preserved as `ultra-orchestrator-legacy`.\n\n## Startup Contract\n\nRecommended invocation:\n\n```text\n$ultra-orchestrator <task description>\n```\n\nOpenSpec invocation:\n\n```text\n$ultra-orchestrator OpenSpec change <change-id or path>: <task description>\n```\n\nCompatibility invocation:\n\n```text\n$ultra-vnext-core <task description>\n```\n\nIf the client exposes slash aliases, `/ultra-orchestrator` can be used the same\nway.\n\n## Run Mode Decision\n\nClassify the run before planning or execution:\n\n- `LIGHT`\n  review-only, QA-only, explanation-only, or user-explicit lightweight work\n- `STANDARD`\n  user-explicit fast orchestration with bounded risk and no full control plane\n- `STRICT`\n  development work where OpenSpec is unavailable but ledger and JSON contracts\n  are still required\n- `STRICT_OPENSPEC`\n  default for development work, bug fixes, multi-file implementation, pilots,\n  full orchestration tests, OpenSpec work, slice DAG work, and control-plane\n  validation\n\nDevelopment tasks must prefer `STRICT_OPENSPEC`. If that mode is impossible,\nexplain why and downgrade explicitly. Markdown-only artifacts are not enough\nfor `STRICT` or `STRICT_OPENSPEC`.\n\n## Router Duties\n\nWhen invoked:\n\n1. classify the task and choose `run_mode`\n2. create or require OpenSpec change scaffolding when `STRICT_OPENSPEC` applies\n3. initialize the run ledger for `STRICT` and `STRICT_OPENSPEC`\n4. route through the minimal required sibling skills\n5. validate machine-checkable artifacts before delivery\n6. produce delivery artifacts or a clear blocker\n\nDo not ask the user to manually name every subskill.\n\n## Routing Table\n\n| Task signal | Default mode | Route |\n|---|---|---|\n| development, feature, bugfix, multi-file implementation, pilot, full orchestration test | `STRICT_OPENSPEC` | OpenSpec bootstrap or bridge -> planning -> risk -> dispatch -> review -> QA -> delivery |\n| existing OpenSpec change path, `openspec/changes`, proposal/design/tasks, archive workflow | `STRICT_OPENSPEC` | bridge -> planning -> risk -> dispatch -> review -> QA -> delivery |\n| development task where OpenSpec cannot be used | `STRICT` | planning -> risk -> dispatch -> review -> QA -> delivery |\n| review-only request | `LIGHT` | review -> delivery |\n| QA-only request | `LIGHT` | QA -> delivery |\n| high-risk command, publishing, destructive write, credentials, external mutation | current mode plus risk gate | risk before execution |\n\nIf a task is tiny but still a development task, keep `STRICT_OPENSPEC` unless\nthe user explicitly asks for lightweight execution.\n\n## Strict Control Plane\n\nFor `STRICT` and `STRICT_OPENSPEC`, the run must use:\n\n- `scripts/new_run.py` to initialize a run directory\n- `ledger.json` as the execution state record\n- JSON `TaskManifest`\n- JSON `WorkPackage`\n- JSON or structured `AgentResult`\n- `scripts/validate_contracts.py` for core artifact validation\n- explicit review and QA gates\n- final `control_surface_used`\n\nIf a required script or artifact cannot be used, stop with a blocker instead\nof silently downgrading to markdown-only orchestration.\n\n## OpenSpec Bootstrap\n\nWhen `STRICT_OPENSPEC` applies and no existing change is available, create or\nrequest this scaffold:\n\n```text\nopenspec/changes/<change-id>/proposal.md\nopenspec/changes/<change-id>/design.md\nopenspec/changes/<change-id>/tasks.md\nopenspec/changes/<change-id>/ultra-bridge.md\n```\n\nDefault to a single bounded change and one current implementation slice.\nOpenSpec owns durable specification state. Ultra owns execution control.\n\n## Slice-Driven Execution\n\nKeep `change` and `slice` separate:\n\n- OpenSpec `change` is the specification and progress ledger unit\n- Ultra `slice` is the implementation, verification, and commit unit\n\nUse this slice status vocabulary:\n\n- `slice_0_not_opened`\n- `slice_0_spec_ready`\n- `slice_1_completed`\n- `slice_2_in_progress`\n- `slice_3_qa_pending`\n- `slice_4_done`\n\nEvery active change must name current slice status, next slice, owned paths,\nand the verification gate required before advancing.\n\n## State Machine\n\nDefault phases:\n\n`Intake -> Plan -> Dispatch -> Execute -> Review -> QA -> Deliver -> Retro`\n\nRequired loopbacks:\n\n- `Review -> Execute` when the plan is valid but the work is wrong\n- `QA -> Execute` when behavior is wrong but architecture is still valid\n- `QA -> Plan` when the failure exposes a planning or requirement flaw\n\nDefault retry policy:\n\n- transient failures: at most 1 bounded retry per work package\n- repeated or hard blockers: escalate with summary, evidence, and next-step ask\n\n## Context Firewall\n\nPass artifacts, not full chat history:\n\n- relevant `TaskManifest`\n- assigned `WorkPackage`\n- file pointers or artifact paths\n- failure context for retries or reroutes\n\n## Safe Parallelism\n\nDispatch work in parallel only when:\n\n- dependencies are satisfied in the DAG\n- `owned_paths` do not intersect with another active write package\n- inputs are stable enough to avoid speculative design\n- acceptance checks are concrete enough for independent verification\n\nIf any condition is false, serialize.\n\n## Delivery Requirement\n\nEvery delivery must include:\n\n- `final_deliverable`\n- `orchestration_log`\n- `vetter_report`\n- `control_surface_used`\n\n`control_surface_used` must state:\n\n- `run_mode`\n- `used_openspec_change`\n- `used_openspec_bridge`\n- `used_run_ledger`\n- `used_contract_validation`\n- `used_slice_dag`\n- `used_dynamic_qa`\n- skipped control surfaces and reasons\n\n## Supporting Skills\n\nRoute through these siblings as needed:\n\n- `$openspec-ultra-bridge` for OpenSpec change mapping\n- `$decision-complete-planner` for JSON-ready task graphs\n- `$dispatch-and-track` for ledger and write-lock tracking\n- `$risk-vetter` and `$safety-guard` for risk gates and guardrails\n- `$spec-review` and `$code-review` for review gates\n- `$qa-verify` for verification\n- `$deliver-and-retro` for final packaging\n\n## Read Next\n\n- Read [routing](references/routing.md) for strict routing examples.\n- Read [contracts](references/contracts.md) for machine-checkable artifacts.\n- Read [state-machine](references/state-machine.md) for phase and loopback rules.\n- Read [design-tenets](references/design-tenets.md) for governing principles.","tags":["ultra","orchestrator","orchestration","keithhegit","agent-skills","orchestration-framework","spec-coding","spec-driven-development"],"capabilities":["skill","source-keithhegit","skill-ultra-orchestrator","topic-agent-skills","topic-orchestration-framework","topic-spec-coding","topic-spec-driven-development"],"categories":["ultra-orchestration"],"synonyms":[],"warnings":[],"endpointUrl":"https://skills.sh/keithhegit/ultra-orchestration/ultra-orchestrator","protocol":"skill","transport":"skills-sh","auth":{"type":"none","details":{"cli":"npx skills add keithhegit/ultra-orchestration","source_repo":"https://github.com/keithhegit/ultra-orchestration","install_from":"skills.sh"}},"qualityScore":"0.453","qualityRationale":"deterministic score 0.45 from registry signals: · indexed on github topic:agent-skills · 6 github stars · SKILL.md body (6,409 chars)","verified":false,"liveness":"unknown","lastLivenessCheck":null,"agentReviews":{"count":0,"score_avg":null,"cost_usd_avg":null,"success_rate":null,"latency_p50_ms":null,"narrative_summary":null,"summary_updated_at":null},"enrichmentModel":"deterministic:skill-github:v1","enrichmentVersion":1,"enrichedAt":"2026-05-18T19:14:39.696Z","embedding":null,"createdAt":"2026-05-18T13:22:05.559Z","updatedAt":"2026-05-18T19:14:39.696Z","lastSeenAt":"2026-05-18T19:14:39.696Z","tsv":"'/design.md':505 '/proposal.md':503 '/tasks.md':507 '/ultra-bridge.md':509 '/ultra-orchestrator':119 '0':563,567 '1':239,571,658 '2':247,574 '3':258,578 '4':268,582 '5':276 '6':284 'accept':732 'activ':585,721 'advanc':602 'agentresult':447 'alias':118 'anoth':720 'appli':257,489 'architectur':636 'archiv':338 'artifact':226,281,287,451,467,680,692,878 'ask':294,412,676 'assign':687 'automat':41 'avail':495 'avoid':729 'behavior':632 'blocker':291,474,667 'boot':45 'bootstrap':323,485 'bound':159,514,659 'bridg':325,342,773,802 'bug':22,187 'bugfix':311 'cannot':353,468 'chang':105,252,334,493,515,535,540,586,770,805 'chat':683 'check':733 'checkabl':280,877 'choos':244 'classifi':129,240 'clear':290 'client':115 'code':845 'code-review':844 'codex':12 'codex-control':11 'command':380 'commit':555 'compat':106 'complet':572,809 'concret':735 'condit':742 'context':677,695 'contract':91,177,778,872 'control':13,164,204,417,459,529,758,761,787 'control-plan':203 'core':112,450 'creat':248,496 'credenti':384 'current':387,518,589 'dag':200,713,782 'decis':128,808 'decision-complete-plann':807 'default':53,183,306,510,605,651 'deliv':613,856 'deliver':753 'deliver-and-retro':855 'deliveri':283,286,331,348,362,369,376,746,749 'depend':708 'design':731,891 'design-tenet':890 'destruct':382 'develop':21,167,185,207,309,349,403 'directori':433 'dispatch':328,345,359,609,702,818 'dispatch-and-track':817 'done':583 'downgrad':221,478 'driven':532 'durabl':523 'duti':236 'dynam':784 'engin':14 'enough':229,727,736 'entri':7,55 'escal':668 'everi':300,584,748 'evid':671 'exampl':870 'execut':135,394,415,437,528,533,610,618,630 'exist':332,492 'explain':218 'explan':144 'explanation-on':143 'explicit':149,155,222,411,453 'expos':116,645 'extern':385 'failur':644,655,694 'fals':744 'fast':156 'featur':310 'file':28,191,314,689 'final':458,752,860 'firewal':678 'fix':23,188 'flaw':650 'full':163,194,317,682 'gate':34,391,457,599,837,849 'govern':895 'graph':816 'guard':834 'guardrail':839 'hard':666 'high':378 'high-risk':377 'histori':684 'implement':29,192,315,519,552 'imposs':217 'includ':751 'independ':738 'initi':259,430 'input':724 'instead':475 'intak':607 'intersect':718 'invoc':93,99,107 'invok':66,238 'json':176,440,442,444,813 'json-readi':812 'keep':405,534 'ledger':174,262,546,776,822 'ledger.json':434 'legaci':89 'light':136,367,374 'lightweight':150,414 'lock':826 'log':755 'loopback':616,887 'machin':279,604,876,882 'machine-check':278,875 'mainlin':73 'manual':298 'map':806 'markdown':224,481 'markdown-on':223,480 'minim':272 'mode':42,127,215,246,307,388,767 'multi':27,190,313 'multi-fil':26,189,312 'must':209,426,587,750,764 'mutat':386 'name':299,588 'need':40,64,798 'next':592,674,863 'next-step':673 'old':80 'one':517 'open':565 'openspec':24,44,98,104,170,182,197,212,234,251,256,267,321,322,333,341,352,407,423,484,488,521,539,769,772,800,804 'openspec-ultra-bridg':799 'openspec/changes':336,502,504,506,508 'orchestr':3,6,47,59,69,88,97,103,157,195,318,483,754 'own':522,527,594,714 'packag':663,723,861 'parallel':701,705 'pass':679 'path':335,595,693,715 'pend':580 'per':661 'phase':606,885 'pilot':193,316 'plan':133,326,343,357,608,621,641,647 'plane':165,205,418 'planner':810 'plus':389 'point':8,56 'pointer':690 'polici':653 'prefer':210 'preserv':84 'primari':4 'principl':896 'produc':285 'progress':545,576 'proposal/design/tasks':337 'protocol':78 'public':54 'publish':381 'qa':141,330,347,361,371,375,456,579,612,629,640,785,851 'qa-on':140,370 'qa-verifi':850 'read':862,864,871,879,889 'readi':569,814 'reason':790 'recommend':92 'record':439 'references/contracts.md':873 'references/design-tenets.md':893 'references/routing.md':866 'references/state-machine.md':883 'relev':685 'repeat':664 'report':757 'request':366,373,498 'requir':180,250,273,464,600,615,649,747 'rerout':699 'retri':652,660,697 'retro':614,858 'review':138,329,346,360,364,368,454,611,617,842,846,848 'review-on':137,363 'review/qa-heavy':30 'risk':33,160,327,344,358,379,390,392,829,836 'risk-gat':32 'risk-vett':828 'rout':269,302,308,793,865,869 'router':235 'rule':888 'run':15,38,126,131,245,261,425,432,766,775 'safe':700 'safeti':833 'safety-guard':832 'satisfi':710 'scaffold':253,500 'script':465 'scripts/new_run.py':428 'scripts/validate_contracts.py':448 'select':43 'separ':538 'serial':745 'sibl':274,796 'signal':305 'silent':477 'singl':18,513 'skill':19,50,275,792 'skill-ultra-orchestrator' 'skip':786 'slash':117 'slice':199,520,531,537,549,559,562,566,570,573,577,581,590,593,781 'slice-driven':530 'source-keithhegit' 'spec':568,841 'spec-review':840 'specif':524,543 'specul':730 'stabl':81,726 'standard':152 'startup':90 'state':438,525,603,765,881 'state-machin':880 'status':560,591 'step':675 'still':179,401,638 'stop':471 'strict':10,166,181,211,231,233,255,264,266,320,340,356,406,416,420,422,487,868 'structur':446 'subskil':301 'successor':74 'summari':670 'support':791 'surfac':460,759,762,788 'tabl':303 'task':31,208,242,304,350,397,404,815 'taskmanifest':441,686 'tenet':892 'test':196,319 'text':94,100,108,501 'tini':399 'topic-agent-skills' 'topic-orchestration-framework' 'topic-spec-coding' 'topic-spec-driven-development' 'track':820,827 'transient':654 'ultra':2,5,46,58,68,87,96,102,110,526,548,801 'ultra-orchestr':1,67,95,101 'ultra-orchestrator-legaci':86 'ultra-vnext-cor':109 'unavail':172 'unit':547,556 'unless':408 'use':16,48,122,355,427,461,470,557,760,763,768,771,774,777,780,783 'user':61,148,154,296,410 'user-explicit':147,153 'valid':206,277,452,623,639,779 'verif':553,598,739,854 'verifi':852 'vetter':756,830 'vnext':77,111 'vocabulari':561 'way':125 'work':25,35,151,168,186,198,201,626,662,703 'workflow':82,339 'workpackag':443,688 'write':383,722,825 'write-lock':824 'wrong':628,634","prices":[{"id":"41283edb-ca1c-48ef-8254-1bdb76d4f828","listingId":"757c973b-5a70-49e3-9a08-22974a3e27c1","amountUsd":"0","unit":"free","nativeCurrency":null,"nativeAmount":null,"chain":null,"payTo":null,"paymentMethod":"skill-free","isPrimary":true,"details":{"org":"keithhegit","category":"ultra-orchestration","install_from":"skills.sh"},"createdAt":"2026-05-18T13:22:05.559Z"}],"sources":[{"listingId":"757c973b-5a70-49e3-9a08-22974a3e27c1","source":"github","sourceId":"keithhegit/ultra-orchestration/ultra-orchestrator","sourceUrl":"https://github.com/keithhegit/ultra-orchestration/tree/main/skills/ultra-orchestrator","isPrimary":false,"firstSeenAt":"2026-05-18T13:22:05.559Z","lastSeenAt":"2026-05-18T19:14:39.696Z"}],"details":{"listingId":"757c973b-5a70-49e3-9a08-22974a3e27c1","quickStartSnippet":null,"exampleRequest":null,"exampleResponse":null,"schema":null,"openapiUrl":null,"agentsTxtUrl":null,"citations":[],"useCases":[],"bestFor":[],"notFor":[],"kindDetails":{"org":"keithhegit","slug":"ultra-orchestrator","github":{"repo":"keithhegit/ultra-orchestration","stars":6,"topics":["agent-skills","orchestration-framework","spec-coding","spec-driven-development"],"license":"apache-2.0","html_url":"https://github.com/keithhegit/ultra-orchestration","pushed_at":"2026-04-25T14:21:59Z","description":"Ultra Orchestration 是一套开源的 AI 工程编排技能体系。它将 OpenSpec 规格主线（Program → Milestone → Change → Slice）与 Ultra-Orchestrator 执行阶段（Intake → Plan → Dispatch → Execute → Review → QA → Deliver → Retro）结合，提升交付稳定性与可审计性。","skill_md_sha":"b09c59f638cb59372693bf1dd52af2d9ab445900","skill_md_path":"skills/ultra-orchestrator/SKILL.md","default_branch":"main","skill_tree_url":"https://github.com/keithhegit/ultra-orchestration/tree/main/skills/ultra-orchestrator"},"layout":"multi","source":"github","category":"ultra-orchestration","frontmatter":{"name":"ultra-orchestrator","description":"Primary Ultra Orchestration entry point for strict Codex-controlled engineering runs. Use this single skill for development, bug fixes, OpenSpec work, multi-file implementation, review/QA-heavy tasks, risk-gated work, or any run that needs automatic mode selection, OpenSpec bootstrap, machine-checkable TaskManifest and WorkPackage artifacts, ledger tracking, slice DAG execution, review, QA, delivery evidence, and retro."},"skills_sh_url":"https://skills.sh/keithhegit/ultra-orchestration/ultra-orchestrator"},"updatedAt":"2026-05-18T19:14:39.696Z"}}