auto-orchestrator
Skill0 starsChanged 3 months agoApache-2.0View on GitHub
Route Phase 2 orchestration tasks to the appropriate workflow skill (system-planner / research-handoff / review-workflow / codex-caller / baseline-protection / harness-official-docs-update / codex-app-server-product-integration / client-distribution-readiness / deploy guards / language knowledge packs). Use at the start of any orchestrator turn to perform pre-flight classification (change surface, required checks, evidence destination, completion boundary) before delegating execution.
In this repository78 other files it gives its agents.
- AGENTS.mdAGENTS.md
- .agents/skills/go-skills-knowledge-pack/AGENTS.mdAGENTS.md
- .agents/skills/rust-skills-knowledge-pack/AGENTS.mdAGENTS.md
- .agents/skills/typescript-skills-knowledge-pack/AGENTS.mdAGENTS.md
- .claude/skills/go-skills-knowledge-pack/AGENTS.mdAGENTS.md
- .claude/skills/rust-skills-knowledge-pack/AGENTS.mdAGENTS.md
- .claude/skills/typescript-skills-knowledge-pack/AGENTS.mdAGENTS.md
- CLAUDE.mdCLAUDE.md
- .cursor/rules/00-general.mdcCursor rule
- .cursor/rules/revharness-critical.mdcCursor rule
- .cursor/rules/revharness-detailed.mdcCursor rule
- auto-orchestratorSkill
- baseline-protectionSkill
- client-distribution-readinessSkill
- cloudflare-deploy-guardSkill
- codex-app-server-guardSkill
- codex-app-server-product-integrationSkill
- codex-callerSkill
- context-compactorSkill
- cursor-callerSkill
- delegated-development-disciplineSkill
- deploy-command-disciplineSkill
- design-principlesSkill
- development-constitutionSkill
- development-junk-cleanupSkill
- go-skills-knowledge-packSkill
- harness-official-docs-updateSkill
- naming-normalization-guardSkill
- orchestrator-bootstrapSkill
- payload-cms-deploy-guardSkill
- production-function-implementerSkill
- research-handoffSkill
- rev-harness-lifecycleSkill
- review-workflowSkill
- root-cause-first-disciplineSkill
- rust-skills-knowledge-packSkill
- scope-guardSkill
- self-growth-proposal-triageSkill
- shared-client-wrapper-safetySkill
- slice-designerSkill
- staff-code-reviewerSkill
- structured-mentorSkill
- supabase-deploy-guardSkill
- system-plannerSkill
- typescript-skills-knowledge-packSkill
- baseline-protectionSkill
- client-distribution-readinessSkill
- cloudflare-deploy-guardSkill
- codex-app-server-guardSkill
- codex-app-server-product-integrationSkill
- codex-callerSkill
- context-compactorSkill
- cursor-callerSkill
- delegated-development-disciplineSkill
- deploy-command-disciplineSkill
- design-principlesSkill
- development-constitutionSkill
- development-junk-cleanupSkill
- go-skills-knowledge-packSkill
- harness-official-docs-updateSkill
- The first 60 shown.
The file
Files
Skill: Auto Orchestrator
Phase 2 の auto-orchestrator は、再利用可能な実務フローの実装本体ではなく、適切な workflow skill に処理を振り分ける薄いルーターとして扱う。
目的
- タスクの現在地を見て、どの skill が次の責務を持つかを即座に決める。
- 実行面では
./.claude/commands/auto_orchestrate.shと prompt/state 管理を使い、詳細手順は各 skill に委譲する。 - ルーティング前に pre-flight classification を行い、change surface / required checks / evidence destination / completion boundary を確定する。
Pre-flight Classification
ルーティング前に、必ず docs/manual/verification-truth-matrix.md を shared source of truth として読み、少なくとも次を分類する。
| 項目 | 必須内容 |
| change surface | 何を変更する slice か。docs only なのか、command/path/policy を含むのか、script 実行入口なのか |
| required checks | その surface に必要な deterministic checks の正確なコマンド |
| evidence destination | slice 固有の volatile evidence を置く plan / SOW / tmp。acceptance truth は docs/manual/verification-truth-matrix.md のまま維持する |
| completion boundary | 次 slice / reviewer に渡してよい境界 |
- slice record は
.agent/active/plan_*.md/.agent/active/sow/*.md/ handoff prompt のいずれかに残す。 - broad task のまま owner skill へ渡さない。安全に slice 化できない場合は fail-closed で停止し、
BLOCKとして planner へ戻す。 - routine work の active surface は最小化する。必要な active set は current request、該当 plan / SOW、lineage が slice scope に入る場合の task lineage ledger、touched files、次 gate に必要な deterministic check output までとする。
- ordinary
dev/reviewiteration で、tracked evidence manifest、dirty manifest、reviewer prompt artifact、normal-work final evidence packet を毎回増やさない。 - reviewer intake は current diff / status / required checks 結果 / plan-SOW scope から生成する volatile review input であり、acceptance truth ではない。materialize する場合は stdout または
.claude/tmp/**に限定し、registry / daemon / queue / durable manifest / control-plane subsystem を作らない。
Task-size / Risk Classifier
ceremony tiering の SINGLE 正本は contract-bound canonical classifier
scripts/rev-harness-task-classifier.sh。その task_class(=light / standard /
heavy)が そのまま ceremony tier になる。lightweight は historical alias のみで、
新規の canonical class 名として使わない。scripts/harness-governance-classifier.sh は
Slice-B fast preflight の advisory hint 専用で、ceremony を route しない(S6 で
operating_mode/reviewer_default 出力を撤去・demote 済み。emits_ceremony=false)。
orchestrated coder launch では auto_orchestrate.sh が coder 起動直前に canonical
classifier を呼び、task_class を ceremony tier として task-contract に ceremony_tier
で刻む。
| classifier | mode + tier | ceremony |
light | dev + quick | contract emit→validate round-trip を fast-path + single-family review。scoped signoff / final gate なし。non-normative typo / prompt wording / admin bookkeeping / 既存参照整理のみなら Orchestrator 直接処理可 |
standard | review + local | scoped reviewer signoff。final release gate なし。docs はここ(NOT light) |
heavy | release + full | orchestrator-bootstrap + contract emit/validate + dual-family review + final gate。acceptance-matrix docs / wrappers / release / security / role・specialty docs。I-3 dual-LGTM + I-12 smoke は決して skip しない(floor) |
FAIL CLOSED UPWARD: ambiguity / classifier error / class 解決不能 / floor surface
接触は、次に重い class へ昇格させる(canonical classifier の raise_to/rank_of
helper を再利用; orchestrator 側の解決不能は最重量 heavy へ落とす)。決して downgrade
しない。Orchestrator 直接処理できる light は、runtime code、role/policy/skill behavior、
wrapper/model-policy、registry/review queue、security/trust boundary、release/tag/merge、
gate-runner/release-gate evidence、acceptance/final-signoff、その他 high-risk surface に
触れない場合だけ。role / policy / skill の挙動を変える文書変更や曖昧な scope は fail-closed
で standard 以上に上げる。
Specialty Surface Boundary
Specialty selection is owned by scripts/rev-harness-task-classifier.sh and its matrix in docs/manual/matrix-vocabulary.json. Generated SKILL.md files under .claude/skills/<specialty-slug>/ and .agents/skills/<specialty-slug>/ are selection hints, or lenses, not workflow owners. The primary invocation surface is:
- orchestrator-canonical specialties: direct
Readofdocs/roles/orchestrator/specialties/<slug>.md - coder / reviewer canonical specialties:
scripts/codex-wrapper.sh --role <coder|high-coder|reviewer> --specialty <slug>
Auto-trigger via SKILL description matching is a discovery hint only. Specialty correctness is enforced by the classifier surface, not by SKILL projection. Future SKILL projections MUST NOT drift into workflow-owner language; the role-aware skill_body generator in agent-core specialty.rs is the single source of truth for projected bodies.
ルーティング表
| 状況 | owner skill | 実行面 |
| プラン未作成、または更新が必要 | system-planner | .agent/active/plan_*.md の作成/更新 |
| 実装後レビュー、修正反復、合格判定 | review-workflow | ./.claude/commands/auto_orchestrate.sh と .claude/tmp/ |
| 外部調査や最新版確認が必要 | research-handoff | 調査メモを planner/coder に受け渡し |
| Codex / Claude Code / prompting / Goal / subagent / skill / hook / settings の upstream 仕様に基づく harness 更新 | harness-official-docs-update | 公式ドキュメント参照から local authority mapping を作る |
| agent-enabled GUI / Mac app / IDE-like client / image-generation GUI / product integration で Codex を裏側 engine として使う | codex-app-server-product-integration | codex app-server / codex exec / SDK / codex-plugin-cc の住み分けを決める |
codex app-server を露出・proxy・deploy・rich client に組み込む | codex-app-server-guard | app-server transport / auth / approval / sandbox / tool side effects の GO/NO-GO gate |
| Client handoff / clean distribution / final cleanup readiness / stale archive or absolute-path audit | client-distribution-readiness | 配布直前の stale refs、local path、semantic DB regeneration、skill sync、doctor clean-distribution 前提を inspect-first で確認 |
| Cloudflare Workers / Pages / Wrangler / R2 / KV / D1 / Queues / Durable Objects / OpenNext を deploy する | cloudflare-deploy-guard | 課金・Bot・security・rollback gate。Cloudflare 公式 skill と併用 |
| Supabase migration / Edge Functions / Auth / Storage / Realtime / MCP/API 変更を deploy する | supabase-deploy-guard | RLS・secret・billing・rollback gate。Supabase 公式 skill と併用 |
| Payload CMS production deploy / schema / access-control / upload / Jobs Queue / migration を行う | payload-cms-deploy-guard | data exposure・privilege・upload・queue・rollback gate。Payload 公式 skill と併用 |
| Go system design / review / implementation / dependency governance | go-skills-knowledge-pack | go-skills-knowledge-pack 由来の Go architecture skill |
| Rust system design / implementation / benchmarking / dependency governance | rust-skills-knowledge-pack | Rust architecture, implementation, benchmarking, and dependency governance |
| TypeScript / Node / Bun / Deno / React / Next / edge runtime system design / review / implementation | typescript-skills-knowledge-pack | typescript-skills-knowledge-pack 由来の TypeScript architecture skill |
| Skill / knowledge pack addition, import, rename, or reorganization | naming-normalization-guard | Skill package naming, required entrypoint filenames, internal references, and stale-path hygiene |
| Self-growth, skill promotion, proposal queue triage, HermesAgent-inspired workflow evolution, or cleanup evolution | self-growth-proposal-triage | proposal-only workflow; classifier + skill routing matrix + provenance check before any mutation slice |
| Codex の CLI 呼び出し方法を決める | codex-caller | canonical wrapper 契約 |
この skill の責務
- plan、prompt、state.json を読んで次の owner skill を決める。
- routing 前に pre-flight classification を実施し、slice record の有無を確認する。
- session 開始時または handover 直後は
./.claude/skills/orchestrator-bootstrap/SKILL.mdを先に呼び、memory consult で bootstrap する。 - 自動化が必要なら
./.claude/commands/auto_orchestrate.shを実行入口として使う。 - handoff 用の入力ファイルと出力ファイルの置き場を揃える。
- coder -> reviewer の順で agent を回す slice では
./.claude/skills/baseline-protection/SKILL.mdと./.claude/commands/lib/baseline_freeze.shを使い、baseline を固定してから起動する。 - change surface に応じた required checks を matrix 参照で owner skill に引き渡す。
この skill の非責務
- review/fix loop の詳細定義
- research memo の詳細フォーマット
- planning template の詳細定義
- Codex wrapper 契約の定義
- MCP の機能定義
ガードレール
- acceptance / completion の正本は
docs/manual/verification-truth-matrix.md。wrapper 契約や command 実行そのものを acceptance 証拠に昇格させない。 - Codex の caller-facing runtime truth は常に
scripts/codex-wrapper.sh --role <standard|research|coder|high-coder|reviewer>。 codex-wrapper-medium.sh/high.sh/xhigh.shは互換 shim であり、primary guidance にはしない。- Claude 側の effort 既定値は
medium。caller-facing effort はlow|medium|high|xhighのみ許可し、maxは使わない。 - 初回設計 / ExecPlan drafting / ExecPlan review planning は
.agent/registry/model_policy.jsonのinitial_execplan_designlane としてgpt-5.5+xhigh+cachedを使う。これは routine docs-only / light planning ではない。 - MCP は capability transport に留める。
- slice record 欠落、required checks 未定義、evidence destination 不明、completion boundary 不明のいずれかがあれば fail-closed で停止する。
- generated reviewer intake 欠落は acceptance truth 欠落と同一視しない。ただし reviewer に渡す時点では current diff / status / required checks 結果 / plan-SOW scope を再生成または handoff に明記する。
最小ランブック
planと.claude/tmp/<task>/state.jsonを確認する。docs/manual/verification-truth-matrix.mdに従って change surface / required checks / evidence destination / completion boundary を分類する。- slice record が不足していれば
system-plannerへ戻す。安全に slice 化できない broad task はBLOCKにする。 - 必要な workflow owner skill を 1 つ選ぶ。
- Codex / Claude Code behavior update の場合は、実装前に
harness-official-docs-updateかresearch-handoffで公式参照と local authority mapping を作る。 - agent-enabled product / GUI / local app integration では、
codex-app-server-product-integrationで app-server vs exec/wrapper vs SDK vs plugin を先に選ぶ。 - Client handoff / clean distribution / final cleanup readiness では
client-distribution-readinessを読み、stale archive refs、local absolute paths、semantic DB regeneration、skill sync、doctor clean-distribution assumptions を確認する。 - 本番 deploy / external exposure / hosted service 変更では、該当 deploy guard を実装前と release 前に使い、GO/NO-GO を evidence として残す。
- Go / Rust / TypeScript の設計・実装・レビューでは該当 architecture skill を読み、公式 docs / latest stable / security checks の不足を required checks に反映する。
- Skill / knowledge pack の追加・取り込み・リネームでは
naming-normalization-guardを読み、package 名、SKILL.mdentrypoint、内部参照、install target の stale path を確認する。 - Self-growth / skill promotion / proposal queue / cleanup evolution では
self-growth-proposal-triageを読み、scripts/rev-harness-task-classifier.shとscripts/rev-harness-skill-routing-check.shの順で class と allowed skill set を固定する。 - Codex を呼ぶ必要がある場合だけ
codex-callerの契約に従う。 - stable truth は該当 manual / README に残す。reviewer intake は current facts から stdout または
.claude/tmp/**に生成する volatile input として扱い、tracked truth に昇格させない。
関連
docs/manual/verification-truth-matrix.md./.claude/skills/system-planner/SKILL.md./.claude/skills/review-workflow/SKILL.md./.claude/skills/research-handoff/SKILL.md./.claude/skills/codex-caller/SKILL.md./.claude/skills/codex-app-server-product-integration/SKILL.md./.claude/skills/client-distribution-readiness/SKILL.md./.claude/skills/codex-app-server-guard/SKILL.md./.claude/skills/cloudflare-deploy-guard/SKILL.md./.claude/skills/supabase-deploy-guard/SKILL.md./.claude/skills/payload-cms-deploy-guard/SKILL.md./.claude/skills/go-skills-knowledge-pack/SKILL.md./.claude/skills/rust-skills-knowledge-pack/SKILL.md./.claude/skills/typescript-skills-knowledge-pack/SKILL.md./.claude/skills/naming-normalization-guard/SKILL.md./.claude/skills/self-growth-proposal-triage/SKILL.md./.claude/skills/harness-official-docs-update/SKILL.md./.claude/commands/README.md
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
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.

