planning-with-teams

Planning with Teams

Manus-style context engineering for Claude Code Agent Teams.

Coordinate multiple Claude Code instances with shared planning files, structured task assignment, and persistent working memory. The first skill to apply proven context engineering methodology to multi-agent workflows.

Based on planning-with-files methodology

---

⚠️ IMPORTANT: Agent Teams Must Be Enabled

<details> <summary><strong>Click to expand - You MUST enable Agent Teams before using this skill</strong></summary>

Why This Matters

Without Agent Teams enabled, this skill will fall back to using Task subagents. While subagents work, they cannot use the native Agent Teams features:

• ❌ No peer-to-peer messaging between teammates
• ❌ No Teammate, SendMessage, TaskCreate tools
• ❌ Limited to Task tool (standard subagents)

How to Enable

Option 1: Settings.json (Recommended)

Add this to ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

Option 2: Environment Variable

Add to your shell profile (~/.bashrc, ~/.zshrc, etc.):

export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

Verify It's Enabled

After enabling, restart Claude Code and check that the skill uses "Agent Teams" mode instead of "Task subagents" mode in the team plan.

</details>

---

Why This Exists

Claude Code's Agent Teams feature lets you coordinate multiple Claude instances working in parallel. But without proper coordination:

• Teammates forget the overall goal
• Findings get siloed in individual contexts
• Work gets duplicated or conflicts
• Token costs skyrocket with no benefit

Planning with Teams solves this by applying Manus principles to multi-agent coordination:

Single Agent:     Context Window = RAM (volatile)
                  Filesystem = Disk (persistent)

Agent Team:       Each Agent = Separate RAM (isolated)
                  Shared Files = Shared Disk (accessible to ALL)

→ Shared planning files become the team's "collective memory"

---

Features

• 100% Native Agent Teams — Uses Anthropic's built-in Teammate, SendMessage, TaskCreate tools
• Shared Planning Files — team_plan.md, team_findings.md, team_progress.md
• Manus Methodology — Re-read before decide, log errors, 3-Strike Protocol
• Clear Ownership — File ownership prevents conflicts
• Hooks Integration — Automatic status checks on session end
• Cross-Platform Scripts — Bash, PowerShell, and Python utilities

---

Quick Start

1. Enable Agent Teams

# In your shell
export CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1

# Or in settings.json
{
  "env": {
    "CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1"
  }
}

2. Install the Skill

npx skills add OthmanAdi/planning-with-teams --skill planning-with-teams -g

Works with Claude Code, Cursor, Codex, Gemini CLI, and 40+ agents supporting the Agent Skills spec.

<details> <summary><strong>🔧 Claude Code Plugin (Advanced Features)</strong></summary>

For Claude Code-specific features like /team autocomplete commands:

# Add marketplace
/plugin marketplace add OthmanAdi/planning-with-teams

# Install plugin
/plugin install planning-with-teams

Or clone manually:

git clone https://github.com/OthmanAdi/planning-with-teams.git ~/.claude/plugins/planning-with-teams

</details>

3. Use It

/team

Or describe your task:

Create an agent team to review PR #142 for security, performance, and test coverage.
Use planning-with-teams for coordination.

---

How It Works

The Coordination Pattern