{
  "markdown": "# agent-team\n\nEnglish | [中文](./README.zh.md)\n\n**Orchestrate your AI workforce with surgical precision.** 🚀\n\n`agent-team` is a multi-agent development manager that uses a **Role + Worker** model to run AI agents in isolated Git worktrees and dedicated terminal sessions.\n\n- **🎭 Role**: Reusable skill packages (`.agent-team/teams/`) defining goals, prompts, and tools.\n- **🛠️ Worker**: Isolated runtime instances (`.worktrees/`) with their own branch and session.\n\n---\n\n## Table of Contents\n\n- [Installation](#️-installation)\n  - [AI-Native (Recommended)](#-ai-native-recommended)\n  - [Manual Installation](#-manual-installation)\n- [Upgrade](#-upgrade)\n- [Quick Start](#-quick-start)\n- [The Toolkit](#-the-toolkit)\n- [Supported Providers](#-supported-providers)\n- [Advanced Usage](#️-advanced-usage)\n  - [CLI Reference](#cli-reference)\n  - [Directory Structure](#directory-structure)\n  - [Environment Variables](#environment-variables)\n- [License](#-license)\n\n---\n\n## 🛠️ Installation\n\n### 🤖 AI-Native (Recommended)\nLet your AI agent set itself up. It only takes two steps:\n\n1. **Install the Skill**:\n   ```bash\n   npx skills add JsonLee12138/agent-team -a <platform> -y\n   ```\n   Replace `<platform>` with your provider: `claude`, `gemini`, `opencode`, or `codex`.\n2. **Tell your Agent**:\n   > \"Install agent-team and initialize the project.\"\n\n---\n\n### 📦 Manual Installation\n\n| Method | Command |\n| :--- | :--- |\n| **Homebrew** | `brew tap JsonLee12138/agent-team && brew install agent-team` |\n| **Go Install** | `go install github.com/JsonLee12138/agent-team@latest` |\n| **Claude Plugin** | `/plugin marketplace add JsonLee12138/agent-team` |\n| **Gemini Ext** | `gemini extensions install https://github.com/JsonLee12138/agent-team` |\n| **OpenCode Plugin** | `{ \"plugin\": [\"opencode-agent-team\"] }` in `~/.config/opencode/opencode.json` |\n\n---\n\n## 🔄 Upgrade\n\n| Method | Command |\n| :--- | :--- |\n| **Claude Plugin** | `/plugin marketplace update agent-team` |\n| **Skill** | `npx skills add JsonLee12138/agent-team -a '*' -y` |\n| **Homebrew** | `brew update && brew upgrade agent-team` |\n| **Go Install** | `go install github.com/JsonLee12138/agent-team@latest` |\n\n---\n\n## 🚀 Quick Start\n\nManage your entire team through natural language. Your AI agent will handle the commands for you.\n\n### 1. Define your Team\n> \"Create a **frontend-architect** role to manage our UI infrastructure.\"\n\n### 2. Install Curated Roles (Optional)\nPull in expert roles from this repository:\n```bash\nagent-team role-repo add JsonLee12138/agent-team\n```\n\n### 3. Spawn a Worker\n> \"Create a worker for **frontend-architect** using Claude.\"\n*This opens a new terminal window with an isolated worktree.*\n\n### 4. Assign & Brainstorm\n> \"Assign **frontend-architect-001** to design the new auth flow.\"\n*The agent will brainstorm a design doc before touching any code.*\n\n### 5. Merge & Cleanup\n> \"Merge **frontend-architect-001** and delete the worker.\"\n\n---\n\n## 🧰 The Toolkit\n\n### Built-in Roles\nAvailable in `.agent-team/teams/`:\n- `pm`: Product Manager & Requirement Shaping.\n- `frontend-architect`: High-level UI/UX structure.\n- `vite-react-dev`: Specialized for Vite + React.\n- `pencil-designer`: UI design tool specialist.\n\n### Built-in Skills\n- `task-orchestrator`: Task lifecycle entry.\n- `workflow-orchestrator`: Governance-only workflow plan entry.\n- `worker-dispatch`: Controller-side worker open/reply entry.\n- `worker-recovery`: Worker-first resume entry.\n- `worker-reply-main`: Worker -> main reporting entry.\n- `context-cleanup`: Session cleanup + index-first file re-anchoring.\n- `task-inspector`: Read-only task inspection.\n- `role-repo-manager`: Role source management.\n- `catalog-browser`: Read-only catalog browsing.\n- `project-bootstrap`: `init` / `migrate` entry.\n- `rules-maintenance`: `rules sync` entry.\n- `skill-maintenance`: Skill cache maintenance.\n- `worker-inspector`: Read-only worker status.\n- `role-browser`: Read-only local role browsing.\n- `role-creator`: Interactively build new agent roles.\n- `brainstorming`: Validates ideas via dialogue before implementation, including planning-target selection (`roadmap` / `milestone` / `phase` / `task` / `generic topic`) and explicit save-destination choices (`docs/brainstorming/`, target-object directory, custom path, or skip saving).\n- `agent-team`: Legacy compatibility shell that now routes to the dedicated scenario skills.\n\n---\n\n## 🤖 Supported Providers\n\n| Provider | CLI Value | Integration |\n| :--- | :--- | :--- |\n| **Claude Code** | `claude` | Plugin |\n| **Gemini CLI** | `gemini` | Extension |\n| **OpenCode** | `opencode` | NPM Plugin |\n| **OpenAI Codex** | `codex` | Prompt-only |\n\n---\n\n## ⚙️ Advanced Usage\n\n<details>\n<summary><b>📖 CLI Reference</b></summary>\n\n### Role Management\n- `agent-team role list`: Show local roles.\n- `agent-team role create <name>`: Create a new role package (`SKILL.md`, `references/role.yaml`, `system.md`) under `skills/`, `.agent-team/teams/`, or a custom target path.\n- `agent-team role-repo add <owner/repo>`: Install roles from GitHub.\n\n### Worker Operations\n- `agent-team worker create <role> [--provider <provider>] [--model <model>]`: Prepare a new worker (does not start a session).\n- `agent-team worker open <worker-id> [--provider <provider>] [--model <model>] [--new-window]`: Start or reopen a worker session.\n- `agent-team worker close <worker-id>`: Close a worker session without deleting the worker.\n- `agent-team worker status`: View active workers and tasks.\n- `agent-team worker assign <id> \"<task>\"`: Dispatch work.\n- `agent-team worker merge <id>`: Sync worker changes back (does not close the session).\n- `agent-team worker delete <id>`: Remove a worker and its worktree.\n\n### Communication\n- `agent-team reply <id> \"<msg>\"`: Send message to worker.\n- `agent-team reply-main \"<msg>\"`: Worker talks back to main.\n\n### Planning Artifacts\n- `agent-team planning create --kind <roadmap|milestone|phase> \"<title>\"`: Create a planning artifact.\n- `agent-team planning list [--kind <kind>] [--lifecycle <planning|archived|deprecated>]`: List planning artifacts.\n- `agent-team planning show <id>`: Show a planning artifact and reference checks.\n- `agent-team planning move <id> --to <planning|archived|deprecated>`: Move a planning artifact across lifecycle directories.\n\n### Task Artifacts\nEvery active task package contains three standard artifacts under `.agent-team/task/<task-id>/`:\n- `task.yaml`: lifecycle metadata and status.\n- `context.md`: background, scope, constraints, and design input.\n- `verification.md`: acceptance contract, test scope boundary, performed checks, and final verification result.\n\n`verification.md` is created automatically with `agent-team task create`. Its default template keeps `E2E Required: no`, `Verified By: qa`, and a pending result so QA or human acceptance can complete the record later.\n\nLifecycle summary:\n- `task done` now moves a task from `assigned` to `verifying`.\n- `task archive` reads `verification.md` and only archives tasks whose `## Result` passes the gate.\n- `task deprecated` moves unfinished or abandoned work into `.agent-team/deprecated/task/<task-id>/` while preserving the task package.\n\n</details>\n\n<details>\n<summary><b>📂 Directory Structure</b></summary>\n\n```\nproject-root/\n├── .agent-team/task/                  <- Active task packages\n├── .agent-team/planning/roadmaps/     <- Active roadmap artifacts\n├── .agent-team/planning/milestones/   <- Active milestone artifacts\n├── .agent-team/planning/phases/       <- Active phase artifacts\n├── .agent-team/archive/task/          <- Archived task packages\n├── .agent-team/archive/roadmaps/      <- Archived roadmap artifacts\n├── .agent-team/archive/milestones/    <- Archived milestone artifacts\n├── .agent-team/archive/phases/        <- Archived phase artifacts\n├── .agent-team/deprecated/task/       <- Deprecated task packages\n├── .agent-team/deprecated/roadmaps/   <- Deprecated roadmap artifacts\n├── .agent-team/deprecated/milestones/ <- Deprecated milestone artifacts\n├── .agent-team/deprecated/phases/     <- Deprecated phase artifacts\n├── .agent-team/teams/                 <- Project-specific roles\n├── .worktrees/                        <- Isolated worker workspaces\n├── roles-lock.json                    <- Remote role version locking\n└── gemini-extension.json              <- Extension manifest\n```\n\n</details>\n\n<details>\n<summary><b>🌐 Environment Variables</b></summary>\n\n| Variable | Default | Description |\n| :--- | :--- | :--- |\n| `AGENT_TEAM_BACKEND` | `wezterm` | Terminal: `wezterm` or `tmux`. |\n| `AGENT_TEAM_ROLE_HUB_URL` | `https://...` | Ingest endpoint for analytics. |\n| `AGENT_TEAM_ROLE_HUB_DEBUG` | `0` | Wait for ingest if set to `1`. |\n\n</details>\n\n---\n\n## 📄 License\n\nMIT © [JsonLee](https://github.com/JsonLee12138)\n",
  "bytes": 8776,
  "sha": "3dab92c7c33115374917f0fa6f0e42c7bf7c150134938794742743ac11233956",
  "repo_slug": "jsonlee12138/agent-team",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/plg_jsonlee12138_agent_team_e94754eb/readme"
}