Agent Team Manager

Manage Claude agent teams — create, assign tasks, track progress, persist context across sessions.

Agent Team Manager (ATM) là npm package cho phép bạn tạo và quản lý nhiều Claude agent như một team. Mỗi agent có vai trò riêng, nhận task cụ thể, và toàn bộ context được lưu vào JSON file trên disk — để Claude có thể đọc lại và tiếp tục công việc mà không mất context.

Features

• Team Management — Tạo, liệt kê, xem chi tiết, xóa team
• Agent Management — Thêm agent với role và specialty
• Task Management — Phân công task, cập nhật trạng thái (pending → in_progress → done)
• Context Persistence — Lưu goal, notes, checkpoint vào JSON file để Claude đọc được
• CLI + SDK — Dùng qua command line hoặc import vào code TypeScript/JavaScript

Tech Stack

TypeScript · Node.js ≥18 · Commander.js · Vitest · Biome

Quick Start

Install

npm install -g agent-team-manager

Hoặc dùng local trong project:

npm install agent-team-manager

CLI Usage

# Tạo team mới
atm team:create -n "Web App Team" -g "Build a full-stack web app"

# Liệt kê tất cả teams
atm team:list

# Xem chi tiết team
atm team:show <teamId>

# Thêm agent vào team
atm agent:add <teamId> -n "Alice" -r "Frontend Dev" -s "React"

# Thêm task
atm task:add <teamId> -t "Build login page" -p high

# Cập nhật trạng thái task
atm task:update <teamId> <taskId> -s done

# Liệt kê tasks
atm task:list <teamId>

# Cập nhật team context
atm context:update <teamId> -g "Build a web app" -p "Phase 1: Setup"

SDK Usage

import { AgentTeamManager } from 'agent-team-manager';

const atm = new AgentTeamManager();
await atm.init();

// Tạo team
const team = await atm.createTeam({
  name: 'My Team',
  goal: 'Build a web app',
});

// Thêm agent
const alice = await atm.addAgent(team.id, {
  name: 'Alice',
  role: 'Frontend Dev',
  specialty: 'React',
});

// Thêm task
const task = await atm.addTask(team.id, {
  title: 'Build login page',
  assignedAgentId: alice.id,
  priority: 'high',
});

// Cập nhật task
await atm.updateTask(team.id, task.id, { status: 'done' });

Storage

Data được lưu tại ~/.agent-team-manager/teams/:

~/.agent-team-manager/teams/
├── {teamId}.json         # Full team state
└── {teamId}/
    ├── context.json       # Context (Claude-readable)
    └── shared/            # Shared files giữa agents

Đặt custom storage directory:

const atm = new AgentTeamManager({ storageDir: '/path/to/data' });

Documentation

• 📋 Project PDR — Mục tiêu sản phẩm, roadmap, tính năng
• 🏗️ Architecture — Thiết kế hệ thống, data flow
• 📁 Codebase — Map các file, entry points
• 📐 Code Standard — Quy ước code, tooling

Development

# Install dependencies
npm install

# Build TypeScript
npm run build

# Run tests
npm test

# Lint
npm run lint

# Format
npm run format

License

MIT