2real-team-framework

2real-team-framework

A drop-in AI agent team framework for Claude Code projects. Bootstrap a simulated team of specialized agents with persistent identities, trust matrices, feedback loops, and structured workflows — all driven by Claude Code's agent tooling.

What is this?

When working with Claude Code on complex software projects, a single AI agent can struggle with coordination, context management, and quality control. 2real-team-framework solves this by scaffolding a complete simulated team structure:

• Manager who decomposes work, creates GitHub Issues, and coordinates
• Architects who design systems and review for compliance
• Engineers who implement in isolated worktrees
• QA, Security, and Data specialists for quality gates

Each team member has a persistent name, personality, git identity, communication style, and trust relationships with other members. They commit under their own names, review each other's work, give feedback, and can be "fired and replaced" when performance drops.

Installation

Python (pip)

pip install 2real-team-framework

# With AI persona generation support
pip install '2real-team-framework[ai]'

Node.js (npm)

npm install -g 2real-team-framework

# Or use without installing
npx 2real-team-framework init --preset library

Quick Start

# 1. Bootstrap a new project with interactive prompts
2real-team init

# 2. Review the generated team structure
2real-team status

# 3. Validate everything is in place
2real-team validate

Or specify everything up front:

2real-team init --preset fullstack-monorepo --team-size 10 --project-name my-app

This creates the following in your project:

CLAUDE.md                # Team section, written at the project root
                         # (an existing CLAUDE.md is preserved as CLAUDE.md.bak
                         #  for you to reconcile)
.claude/
  team/
    charter.md           # Team rules, org chart, workflows
    trust_matrix.md      # Directional trust scores between members
    feedback_log.md      # Feedback history
    roster/
      manager_*.md       # One card per team member
      tech_lead_*.md
      ...

retro.md # Wave retrospective skill wave-start.md # Initialize a new wave wave-end.md # Finalize a wave review-pr.md # PR review using charter format plan-phase.md # Phase planning skill close-stale-issues.md