A Skill for Agentic AI Development Agentic AI開発向けのスキル

Delegate large dev tasks to AI agents — with every subtask traceable.

大きな開発タスクをAIエージェントに任せながら、すべてを追跡可能に。

Orchestune turns an approved decomposition plan into dependency-aware GitHub Issues, coordinates autonomous implementation by multiple AI agents, and links the resulting branches, pull requests, and CI outcomes back to the original task.

承認された分解計画を依存関係付きのGitHub Issueへ変換し、複数のAIエージェントによる自律的な実装を協調します。生成されたブランチ、プルリクエスト、CI結果は元のタスクに紐づけられます。

The Problem
課題

Delegating a big task to an AI agent is easy. Trusting the result isn't.

大きなタスクをAIエージェントに任せるのは簡単。でも、結果を信頼するのは別の話。

Once a task grows past a single prompt, dependencies, file conflicts, and progress become invisible — and by the time they surface, the rework has already cost you quota and time.

タスクが単一のプロンプトを超えて大きくなると、依存関係・ファイル競合・進捗が見えなくなります。それらが表面化する頃には、手戻りがすでにクオーターと時間を消費した後です。

Without Orchestune
Orchestuneなしだと
  • Conflicts surface only after agents have already written overlapping code
  • 競合は、エージェントが重複したコードを書き終えた後に初めて表面化する
  • Progress lives in your head — the pipeline stalls the moment you step away
  • 進捗は自分の頭の中にしかなく、席を外した瞬間にパイプラインが止まる
  • A wrongly scoped subtask means redoing the work — and burning quota twice
  • スコープを誤ったサブタスクはやり直しになり、クオーターを二重に消費する
With Orchestune
Orchestuneがあれば
  • Conflicts and unsafe parallel work are caught before any code is written
  • 競合や危険な並列実行を、コードを書く前に検出する
  • State lives in GitHub Issues and PRs — self-healing, no babysitting required
  • 状態はGitHubのIssueとPRに残り、自己修復するため見守り不要
  • A reviewable plan surfaces scope problems before agents ever start
  • レビュー可能な計画により、エージェントが着手する前にスコープの問題が見える
The Solution
解決策

Orchestune keeps every subtask, dependency, and result traceable.

Orchestuneは、すべてのサブタスク・依存関係・結果を追跡可能に保ちます。

1

Decompose large tasks into traceable work units

大きなタスクを追跡可能な作業単位へ分解

Creates a reviewable plan in which every subtask has an explicit scope, acceptance criteria, verification steps, dependencies, and expected file or symbol footprint.

各サブタスクの実装範囲、受け入れ基準、検証手順、依存関係、変更予定のファイルやシンボルを含む、レビュー可能な分解計画を作成します。

2

Validate dependencies and conflicts before implementation

実装開始前に依存関係と競合を検証

Builds a DAG from the plan and detects dependency cycles, overlapping files or symbols, shared-contract risks, and unsafe parallel work before agents modify the codebase.

計画からDAGを構築し、循環依存、ファイルやシンボルの重複、共有拡張点のリスク、危険な並列実行を、AIがコードを変更する前に検出します。

3

Provision an auditable execution plan on GitHub

実行計画をGitHub上の追跡可能なIssueへ変換

Converts the approved plan into parent and child Issues with dependency links, status labels, and implementation context, preserving why each unit of work exists.

承認された計画から、依存関係、ステータスラベル、実装に必要な文脈を持つ親Issueと子Issueを起票し、各作業の目的を記録します。

4

Coordinate autonomous implementation and integration

AIによる自律的な実装と統合を協調

Dispatches ready Issues to local or cloud coding agents, reconstructs progress from GitHub Issues and PRs, and coordinates downstream rebases and integration.

着手可能なIssueをローカルまたはクラウドのAIコーディングエージェントへ割り当て、GitHub IssueとPRから進捗を復元しながら、下流ブランチのリベースと統合を調整します。

What It Feels Like
使用感

You just describe the task in chat

チャットでタスクを伝えるだけ

No CLI flags to remember. Describe the task in plain language, and a reviewable decomposition_plan.md shows up right there in the conversation.

コマンドのオプションを覚える必要はありません。自然言語でタスクを伝えると、会話の中でそのままレビュー可能なタスク分解計画(decomposition_plan.md)が提示されます。

You

Build a Todo app: a simple web frontend, with the backend in JS.

シンプルなWebフロントエンド、バックエンドがJSのTodo管理ツールを作って

AI

Here's the breakdown — 3 subtasks, 2 can run in parallel once the API contract lands:

分解案を作成しました。3つのサブタスクのうち、API契約が固まれば2つは並列で進められます。

  • 1backend — Todo REST API (Express)backend — Todo REST API(Express)
  • 2frontend — list / add / complete UIfrontend — 一覧・追加・完了のUI
  • 3integration — wire frontend to API, e2e checkintegration — フロントとAPIの結線・E2E確認
decomposition_plan.md タスク分解計画(decomposition_plan.md)
subtasks:
  - id: backend-todo-api
    description: "Todo REST API (Express)""Todo REST API(Express)"
    footprint: [server/routes/todos.js]
    depends_on: []
    acceptance_criteria:
      - "CRUD endpoints return correct status codes""CRUDエンドポイントが正しいステータスコードを返す"

  - id: frontend-todo-ui
    description: "List / add / complete UI""一覧・追加・完了のUI"
    footprint: [src/components/TodoList.jsx]
    depends_on: []

  - id: integration-e2e
    description: "Wire frontend to API, e2e check""フロントとAPIの結線・E2E確認"
    footprint: [src/api/client.js]
    depends_on: [backend-todo-api, frontend-todo-ui]

The depends_on line is what tells subtask 3 to wait. Shall I go ahead?

depends_onの行が、サブタスク3が待つべきことを伝えています。この計画で進めてよいですか?

You

Looks good, go ahead.

それでお願い

AI

Creating the Issues and dispatching agents now — I'll keep working while you're away.

Issueを作成し、エージェントをディスパッチしました。あなたが離席していても作業を続けます。

  • backend — PR #124 opened, CI passedbackend — PR #124 作成、CI通過
  • frontend — PR #125 opened, CI passedfrontend — PR #125 作成、CI通過
  • integration — rebasing onto #124 & #125integration — #124・#125 の上にリベース中
Design Philosophy
設計思想

Quota efficiency, not wall-clock speed

実時間の速さではなく、クオーター効率

Orchestune is for individual developers and small teams working with AI coding agents. The scarce resource here is not wall-clock time — it is your AI usage quota (a subscription's session/weekly allowance) and the hours a human can actually be at the desk.

Orchestuneは、AIコーディングエージェントを使う個人開発者と少人数チームのためのものです。ここでの希少資源は実時間ではなく、AI利用クオーター(サブスクリプションのセッション/週次の使用枠)と、人間が席にいられる時間です。

  • Rework is the main waste. Conflict-prevention analysis and the shared-contract gate trade a small up-front planning cost for avoided rework.
  • 手戻りが最大の無駄。 競合防止の分析と共有拡張点のゲートは、わずかな事前計画コストと引き換えに手戻りを回避します。
  • Parallelism is the mechanism, not the goal. Independent subtasks let several agents burn quota at once instead of one agent burning it in sequence.
  • 並列性は目的ではなく手段。 独立したサブタスクにより、複数のエージェントが同時にクオーターを消費できます(1つのエージェントが順番に消費するのではなく)。
  • Unattended operation converts parallelism into quota efficiency. State is self-healing from GitHub, and human judgment is confined to two approval gates.
  • 無人での実行が、並列性をクオーター効率へ変換する。 状態はGitHubから自己修復し、人間の判断は2つの承認ゲートに限定されます。
How It Works
仕組み

The mechanics behind each stage

各段階を支える仕組み

The features above describe what you get. Here's what's actually running underneath.

上の「解決策」が「何が得られるか」だとすると、ここではその裏で実際に動いている仕組みを説明します。

01

Decompose & validate

分解と検証

Subtask footprints and symbols are compared with weighted similarity scoring to catch overlapping edits, and the DAG gets implicit dependency edges to keep parallel work safe. Shared extension points that don't exist yet (registries, CLI wiring) are gated explicitly via a shared_contract tag, since plain path matching can't catch those.

サブタスクのfootprintとsymbolsを重み付き類似度で比較して重複編集を検出し、DAGに暗黙的な依存エッジを追加して並列実行の安全性を確保します。まだ存在しない共有拡張点(レジストリやCLI配線など)は、パスの単純な一致では検出できないため、shared_contractタグで明示的にゲートします。

02

Provision

Issue起票

Filing is idempotent and resumable: issues are created in depends_on topological order, reusing any issue already filed for a subtask, so a partial failure never duplicates work on retry. Parent/child and blocked-by relationships are set natively, so GitHub itself tracks the dependency graph.

起票は冪等かつ再開可能です。Issueはdepends_onのトポロジカル順に作成され、既に起票済みのサブタスクは再利用されるため、途中で失敗しても再実行で重複作成されません。親子関係とブロック関係はGitHubネイティブの機能で設定され、依存グラフ自体をGitHub上で追跡できます。

03

Dispatch

ディスパッチ

Each subtask runs in its own isolated worktree. If an agent's edits deviate from its declared footprint, the DAG is recomputed automatically, falling back to forced serialization if that keeps happening.

各サブタスクは、それぞれ隔離されたworktreeで実行されます。エージェントの変更が宣言済みのfootprintから逸脱した場合はDAGを自動的に再計算し、それでも収まらなければ強制的に直列実行へフォールバックします。

04

Trace & integrate

追跡と統合

Dependent branches auto-rebase onto whichever dependency branch has already passed CI — not just the latest main. Child branches merge into the parent branch automatically as they complete; only the final parent-to-main merge needs a human, and state stays self-healing by reconstructing everything from GitHub Issues and PRs.

依存先ブランチのうち、既にCIを通過しているブランチに対して自動的にリベースされます(最新のmainにではなく)。子ブランチは完了するたびに親ブランチへ自動マージされ、親からmainへの最終マージだけ人間の判断が必要です。状態は常にGitHubのIssueとPRから復元されるため、自己修復します。

Read more in Architecture & Design → 詳細はこちら:アーキテクチャと設計思想 →

Getting Started
はじめかた

Install Orchestune

Orchestuneをインストール

Requires Python 3.12+, uv, and the GitHub CLI.

Python 3.12以上、uv、GitHub CLIが必要です。

1. Install globally (recommended, via pipx)
1. グローバルにインストール(推奨・pipx使用)
pipx install git+https://github.com/Saltmu/orchestune.git
2. Link Orchestune skills to your AI assistants (Claude Code, Codex CLI, Antigravity)
2. AIアシスタント(Claude Code, Codex CLI, Antigravity)へスキルを登録
orchestune setup
Under the Hood
舞台裏

What the skill runs on your behalf

その裏でスキルが実行しているコマンド

You never type these yourself — the orchestune skill calls them for you. Shown here to make each stage concrete, and for the rare manual recovery.

これらを人間が自分で打つことはありません。orchestuneスキルが代行実行します。各段階を具体的に示すため、また例外的な手動復旧のために掲載しています。

# 1. Validate the decomposition plan's DAG1. 分解計画のDAGを検証
$ orchestune dag --plan decomposition_plan.md
# 2. Preview, then create, GitHub Issues from the plan2. 計画からGitHub Issueをプレビューし、その後起票
$ orchestune provision --plan decomposition_plan.md
$ orchestune provision --plan decomposition_plan.md --apply
# 3. Start the dispatcher (dry-run, then execute)3. ディスパッチャーの起動(ドライラン、その後実行)
$ orchestune dispatch
$ orchestune dispatch --apply

Ready to keep your AI agents traceable?

AIエージェントの作業を追跡可能にしませんか?

Orchestune is open source under the MIT License and provided as a skill for Claude Code, Codex CLI, and Antigravity.

OrchestuneはMITライセンスのオープンソースで、Claude Code・Codex CLI・Antigravity向けのスキルとして提供されます。