ai-team-workflow

Coordinate cross-role AI teams within a Codex tmux workflow.

1|1|Updated Jan 9, 2026
One-click install
npx skills add https://github.com/kunhuang12345/team-skill --skill ai-team-workflow
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ai-team-workflow
Source: https://github.com/kunhuang12345/team-skill/tree/main/.codex/skills/ai-team-workflow
Command: npx skills add https://github.com/kunhuang12345/team-skill --skill ai-team-workflow

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve?

This Skill enables a cohesive AI-driven team by coordinating multiple Codex roles (PM, Architect, Product, Dev, QA, Ops, Coordinator, and Liaison) through a tmux-based workflow, providing a shared registry, routing logic, and escalation paths to keep work flowing smoothly.

Core Features & Use Cases

  • Role-based multi-agent coordination: assign responsibilities and spawn sub-roles to scale teams.
  • Centralized registry and design flow: a shared registry, design docs, and consolidated task management.
  • Controlled user interaction: Coordinator routes internal questions; Liaison handles user-facing questions, ensuring proper escalation.
  • Lifecycle operations: spawn, up, tree, route, and report across roles to accelerate delivery.
  • Quick-start workflows: init, spawn, route, and report tasks across roles to accelerate delivery.

Quick Start

Initialize the AI team workflow in your project: bash .codex/skills/ai-team-workflow/scripts/atwf init "Task: set up initial registry and PM-Arch-Dev-QA trio"

Frequently Asked Questions about ai-team-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate multiple AI agents for software development tasks?

You can coordinate multiple AI agents by assigning specific roles like PM, Architect, Dev, and QA within a tmux-based workflow. This skill handles role spawning, task routing, and artifact consolidation across subteams using a shared registry to keep work flowing.

What is tmux-based multi-agent workflow orchestration?

Tmux-based multi-agent workflow orchestration is a coordination method that uses tmux sessions to manage distinct AI roles such as Ops, Coordinator, and Liaison. It provides routing logic and escalation paths to ensure cross-role communication and task delivery remain cohesive.

Can I use tmux to route tasks between different AI development roles?

Yes, you can use tmux to route tasks between AI roles. The Coordinator role routes internal questions while the Liaison handles user-facing queries, ensuring proper escalation paths and task assignment across PM, Architect, Product, Dev, QA, and Ops subteams.

How do I initialize a multi-agent AI team workflow in my project?

To initialize a multi-agent AI team workflow, run the provided script to set up the initial registry and spawn a PM-Arch-Dev-QA trio. This creates a shared registry at the skill root directory to govern routing and ownership configuration.

Do I need a shared registry to manage AI team coordination across roles?

Yes, a shared registry is required for AI team coordination. The skill uses a centralized registry file to govern routing logic, track ownership, and consolidate design docs and task artifacts across all spawned subteams and active roles.

What are the limitations of using tmux for multi-agent AI role coordination?

The primary limitation is that this tmux workflow requires the tmux-workflow skill to be installed alongside it. Without this dependency, the system cannot spawn tmux sessions or execute cross-role lifecycle operations like route and report.