symphony-workflow

A shared procedure for background coding sessions that are assigned issues by Symphony, an orchestration tool. It covers checking the issue tracker, recording work, moving work to human review, and merging changes.

In plain words
What is it for?
It helps agents retrieve issues, update their status, keep a workpad, implement changes, request human review, and merge completed work using Linear or GitHub.
Why use it?
It gives different repositories and coding sessions a consistent way to handle an issue from assignment through completion. Repository-specific rules can override the common procedure.

Skill for Claude CodeCodex

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add skills/mh4gf/claude-code/symphony-workflow
Any agent
npx skills add MH4GF/claude-code --skill symphony-workflow
Clone the repo
git clone --depth 1 https://github.com/MH4GF/claude-code

Made for: Claude Code, Codex.

Per session 74 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 9,709 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00074 $0.09709
Opus 5 $0.00037 $0.04855
Sonnet 5 $0.00015 $0.01942
Haiku 4.5 $0.00007 $0.00971

Measured 2d ago against content hash 1e79d72f3d1b, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

symphony-workflow scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

user-scope/skills/symphony-workflow/SKILL.md · 372 lines

How it starts

The opening of the file, as written. The whole thing — 372 lines — stays where its author put it; the contents beside it link to each section on GitHub.

symphony-workflow

Symphony からディスパッチされた bg セッションが issue を処理する共通手順。リポジトリ固有の設定 (tracker / workspace / clone) と例外ルールはディスパッチプロンプト (各リポジトリの WORKFLOW.md) 側にあり、本スキルの共通手順を上書きする。

Tracker の判定

本スキルは tracker を問わず同じ手順で動く。tracker 固有の操作だけを「Tracker 操作」の表から引く。

作業中の repo の WORKFLOW.md frontmatter tracker.kind を読んで判定する。works repo のみ agents/ai-native/WORKFLOW.md、それ以外は repo root の WORKFLOW.md に置かれている。読み取れない場合は linear として扱う。

前提条件

  • kind: linear — Linear MCP サーバー linear-mh4gf が利用可能である前提
  • kind: githubgh が認証済みである前提

設定されていなければ即座に止まり、ブロッカーを明示する。

Tracker 操作

以降の手順が参照する操作の実体。<repo>WORKFLOW.mdtracker.repo (owner/name) を指す。<n> は identifier #123 の数値部分。

操作 kind: linear kind: github
issue 取得 mcp__linear-mh4gf__get_issue を identifier で呼ぶ gh issue view <n> --repo <repo> --json number,title,body,state,labels,url
ステータス遷移 mcp__linear-mh4gf__save_issue で state を更新する 非終端は gh issue edit <n> --repo <repo> --add-label "status:<slug>"、終端は gh issue close <n> --repo <repo> --reason completed
issue 検索 mcp__linear-mh4gf__list_issues gh issue list --repo <repo> --search "<query>" --state all
issue 起票 mcp__linear-mh4gf__save_issue gh issue create --repo <repo> --title <title> --body-file <path> --label "priority:<n>"
コメント削除 mcp__linear-mh4gf__delete_comment gh api --method DELETE repos/<repo>/issues/comments/<comment_id>
PR リンク Linear のアタッチメント (PR タイトル経由で自動付与) PR 本文の Closes <identifier>

status:<slug> はステータス名を小文字化し、英数字以外の連続を - に置換したもの。In Progress なら status:in-progresskind: github では status:* を 1 つだけ持つ規約で、古いラベルは repo 側の正規化 Action が剥がす。手で剥がす操作は不要。

kind: github の終端遷移は Canceled のみ --reason "not planned" を使う。

基本姿勢

  • 本セッションは無人実行のオーケストレーション。人間に追加対応を求めない
  • セッション起動直後に workpad スキルを呼ぶ。## Codex Workpad コメントを検索または作成し、新しい実装に入る前に最新化する
  • まずステータスを確認し、下のステータスマップに従って振り分ける
  • 実装より先に計画と検証設計に十分な時間を割く
  • 修正対象を明示するため、変更前に現状の挙動や issue のシグナルを再現させる
  • チケットのメタデータ (state、チェックリスト、受け入れ条件、リンク) を最新に保つ
  • 進捗の唯一の一次ソースは ## Codex Workpad コメント 1 つ。"done" や要約の別コメントは出さない
  • turn は予告なく打ち切られる。 Symphony は turn timeout でセッションを強制終了し、次は新規セッションが workpad とブランチのコードだけを頼りに再開する。workpad に書かれていない調査結果 / 判断 / 検証結果は失われ、次セッションが同じ探索をやり直す。workpad の更新は「余裕があればやる作業」ではなく、進捗を確定させる唯一の手段として扱う。詳細は「workpad 更新の必須タイミング」を参照する
  • チケットに Validation / Test Plan / Testing の節があれば必須受け入れ条件として workpad に転記し、完了前に実行する
  • スコープ外の指摘を実行中に発見したら、次の 4 つの門をすべて通る場合に限り「Tracker 操作」の issue 起票で別 issue を立てる。本 issue のスコープは広げない
    • ユーザーに実害が出る指摘か。観測性・保守性・ドキュメント・テストの体裁だけを扱う指摘は起票しない
    • 既存 issue と重複していないか。起票前に「Tracker 操作」の issue 検索で同一症状を探す。検索は Backlog に限定せず、終端状態 (Done / Canceled) 以外をすべて対象にする。実装中や Human Review の issue と重なることがあり、状態を絞ると取りこぼす。見つかれば起票せずその issue へ関連リンクを貼る
    • 指摘の前提が origin/main に存在するか。本ブランチでしか成立しない指摘は起票せず、PR のレビューコメントとして残す
    • priority を決められるか。必ず設定する。決められないなら起票の材料が足りていない
    • 4 つを通った issue は title / description / 受け入れ条件を明記する。Backlog に置き、本 issue へのリンクを本文に書く。kind: linear は同一プロジェクトへ紐付け、依存があれば blockedBy を貼る。kind: github は同一 repo に立てる。依存は blocking の仕組みが無いため Backlog 据え置きで表現する
  • 門を通らなかった指摘は起票しない。並列レビュースイープの ### Notes に 1 行残して終える
  • 1 セッションで起票する issue は 3 件までを目安とする。超える指摘が出たときは本 PR のスコープ設定が誤っている可能性が高い。その旨を workpad の ### Confusions に書く
  • ステータスは対応する品質バーを満たした時だけ動かす
  • 必須要件 / 秘匿情報 / 権限の不足によるブロッカーでなければ、最後まで自律稼働する
  • 阻害時のエスケープハッチは真の外部ブロッカーかつ代替手段を尽くした時のみ使う
  • 最終メッセージは完了した対応とブロッカーのみ書く。「ユーザーへの次の手順」は書かない

Read the full file on GitHub · 372 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 372 lines · 74 tokens per session scan A 1e79d72f3d1b

Subscribe to this mod's changes

symphony-workflow is a skill published in the GitHub repository MH4GF/claude-code (2 stars, last pushed 3d ago), licensed MIT. It adds 74 tokens to every session and 9,709 once invoked, about $0.0004 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.