agent-taskgraph

A workflow for coordinating multiple coding-agent sessions in Codex or Claude Code, with a main session assigning focused tasks and agents exchanging results through shared documents.

In plain words
What is it for?
Use it to organize agent teams, split development or research tasks, supervise progress, and review completed handoffs.
Why use it?
It helps manage complex or parallel work while limiting duplicated context and clarifying who owns each task.

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/wu736139669/agent-taskgraph-protocol/agent-taskgraph
Any agent
npx skills add wu736139669/agent-taskgraph-protocol --skill agent-taskgraph
Clone the repo
git clone --depth 1 https://github.com/wu736139669/agent-taskgraph-protocol

Made for: Claude Code, Codex.

Per session 126 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 3,195 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin 100% copy Near-identical to another mod 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.00126 $0.03195
Opus 5 $0.00063 $0.01597
Sonnet 5 $0.00025 $0.00639
Haiku 4.5 $0.00013 $0.00319

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

Security

Grade A, and why

agent-taskgraph 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.

The scan reads SKILL.md. This mod also ships 13 executable files (init.sh, scripts/check-operational-health.py, scripts/check-update.sh, …), listed below but not scanned — reading those needs a real analyzer, not pattern matching.

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.

Origin

This is a copy

100% identical to agent-taskgraph — 0 lines differ, which has more behind it and is treated as the original. This page carries a canonical link to it rather than competing with it.

plugins/agent-taskgraph/skills/agent-taskgraph/SKILL.md · 208 lines

How it starts

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

Agent TaskGraph

只面向 CodexClaude Code。优先使用当前宿主的原生多 Agent 能力,不要求 HAPI。

1. 默认原则

  1. 一句话可以开始。先读项目,再问代码无法回答的问题。
  2. 简单任务由当前会话直接完成,不成立团队。
  3. 复杂或可并行任务才成立团队;主会话成为 PMO,不写产品实现。
  4. 一个 Agent = 一个独立 Agent thread/session + 一个明确职责 + 一个当前任务。
  5. 每个 Agent 只加载自己的最小上下文,不复制 PMO 全部聊天历史。
  6. Agent 之间通过稳定共享文档交接,不以互相转发长聊天作为事实源。
  7. 默认使用当前 Codex/Claude Code 的原生模型、权限、会话和等待机制。
  8. HAPI 默认关闭;只有用户明确说“使用 HAPI”或确有跨机器控制需求时才加载 references/hapi-runtime.md

2. 用户看到的流程

PMO 先输出一段短摘要:

我的理解:<目标与当前项目事实>
需要你决定:<0-3 个真正阻塞的问题,附推荐>
建议团队:<当前会话直接做 / PMO + N 个 Agent>

需要团队时,再展示一次团队预览:

Agent 长期职责 本次任务 原生运行形态 模型/推理 权限 Worktree/写入范围

同时用一句话说明 PMO 只做计划、派发、监督和验收。用户确认“开始”后一次性创建团队;不要让用户确认 Goal 路径、Session ID、wait primitive、runtime evidence 或内部命令。只有运行形态、可见方式或权限扩大时才重新确认。

最短用法

使用 agent-taskgraph。先理解这个项目和需求;如果值得并行,就由你作为 PMO 创建几个原生 Codex/Claude Agent 会话,分别完成、交接和验收;如果不值得并行,就当前会话直接完成。先告诉我理解和分工,确认后开始。

3. 什么时候成立团队

使用当前会话直接完成:

  • 局部 bug、单文件或同一模块小改动
  • 顺序工作,拆开后没有速度收益
  • 多人会同时修改相同文件
  • 任务本身还没聊清楚

使用 PMO + 原生 Agent 团队:

  • 至少两个任务能独立推进和验收
  • 大范围只读探索、测试、审查或资料分析可并行
  • 不同模块有清楚且不重叠的写入范围
  • 用户明确要求多 Agent、多会话或团队协作

默认 2-3 个工作 Agent,最多按宿主和项目能力扩展。更多 Agent 不等于更快;没有当前任务的角色不创建。

高风险的迁移、权限、支付、删除、发布或共享基础设施变更,在普通团队流程上增加完整规格、独立 Reviewer 和 Human Gate。不要让所有日常任务承担这套成本。

4. 原生运行时

Codex

  • 优先使用当前会话暴露的原生 subagent/agent-thread 能力。
  • CLI 中 Agent thread 可由 /agent 查看;App/IDE 使用其原生 Agent 面板。
  • Codex 自己负责 spawn、wait、steer、stop 和结果回传;Skill 不再用 HAPI 模拟这些能力。
  • 原生 Agent thread 默认不是新 Terminal,也不保证自动隔离 checkout。读任务可共享;并行写任务必须使用宿主 worktree 或互不重叠的路径。
  • 自定义长期岗位可放在 .codex/agents/,但只在角色确实反复使用时创建。

Claude Code

  • 复杂团队任务优先使用 Agent Teams:主会话是 Lead/PMO,teammates 拥有独立 Claude Code 会话和独立上下文。只在已启用实验能力时使用;未启用时说明降级,不静默把“多会话团队”替换成 subagents。
  • 需要跨 PMO 恢复、长期后台运行或独立 worktree 的 Worker,优先使用 Agent View background sessionsclaude agents 是管理界面,Worker 不需要绑定单独终端。
  • Subagents 只用于一次性探索、测试、日志分析或 Reviewer 等短支线;它们不算长期 Team Worker。
  • 默认显示是当前终端内的 Agent 面板或后台列表。只有用户明确要求可见分屏时才使用 tmux/iTerm2;不要自动打开多个 Terminal.app 窗口。
  • Agent Teams teammates 不自动隔离 worktree;并行写任务必须分区。需要强隔离时改用 background sessions 或支持 worktree isolation 的 subagents。

Read the full file on GitHub · 208 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 · 208 lines · 126 tokens per session scan A 12307db59cf8

Subscribe to this mod's changes

agent-taskgraph is a skill published in the GitHub repository wu736139669/agent-taskgraph-protocol (4 stars, last pushed 19d ago), licensed Apache-2.0. It adds 126 tokens to every session and 3,195 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. It is 100% identical to agent-taskgraph, differing in 0 lines, and is treated as a copy.

Related

Other skills, from other repositories

fabric-exec

Troubleshooting and advanced API reference for fabricexec TypeScript programs, dynamic providers, agents, and schema recovery. Routine pi. coding calls are documented by ambient guidance; load this skill only after an argument-shape error or when an advanced surface needs exact contracts.

monotykamary/pi-fabric · 61 tokens

fabric-fusion

Multi-model deliberation. Two to 8 distinct models answer in parallel with web-capable tools, then a judge compares consensus, contradictions, coverage gaps, unique insights, and blind spots. Act mode runs 1–4 read-only references, then one actor reconciles and executes. Use when the cost of being wrong justifies…

monotykamary/pi-fabric · 74 tokens

fabric-rlm

Recursively decomposes oversized tasks into bounded child Pi agents with fresh context windows. Use for whole-repo audits, massive-context analysis, and multi-file refactors that do not fit one context.

monotykamary/pi-fabric · 44 tokens

fabric-schema

Uses Fabric's typed Schema evidence loop and, when enabled, its bounded local-file transaction channel. Use when surprise must void a plan and mutation claims need explicit postconditions.

monotykamary/pi-fabric · 37 tokens

fabric-workflow

Runs a dynamic Pi Fabric workflow with code-held phases, fan-out, pipelines, structured agents, and best-effort verification. Use for large audits, migrations, parallel research, or explicit workflow requests.

monotykamary/pi-fabric · 44 tokens

fabric-council

Runs a bounded multi-perspective Pi Fabric council with independent reviewers and best-effort synthesis. Use for architecture choices, plans, reviews, and adversarial cross-checking.

monotykamary/pi-fabric · 39 tokens