Skip to content

Cursor AI Agent Team Framework: A three-agent collaboration system for AI-assisted work

License

Notifications You must be signed in to change notification settings

thiswind/cursor-agent-team

Repository files navigation

Cursor AI Agent Team Framework

Framework Banner

A three-agent collaboration system for Cursor IDE and Qwen Code that installs custom commands and enables team expansion.

Now supports both Cursor IDE and Qwen Code platforms!

What is cursor-agent-team?

cursor-agent-team is a lightweight, IDE-integrated multi-agent collaboration framework that enables multiple specialized AI agents to work together within Cursor IDE. It belongs to:

  • Academic: Multi-Agent System (MAS), Prompt Engineering Toolchain, Workflow Automation Framework
  • Industry: Developer Tools (AI-enhanced), AI Agent Platform (lightweight), IDE Extension Framework

For detailed classification analysis, see Classification Analysis.

Overview

This framework installs three core Cursor commands (roles) into your project:

  • /discuss - Discussion Partner: The strategist who analyzes problems, explores ideas, and creates execution plans
  • /crew - Crew Member: The executor who implements plans strictly according to specifications
  • /prompt_engineer - Prompt Engineer: The HR and trainer who creates new roles (new Cursor commands)

With these three core roles installed, the team can operate. The Prompt Engineer can create additional roles as needed, allowing the team to expand.

Key Features

  • Lightweight: File-based architecture, no complex infrastructure required
  • IDE Native Integration: Deeply integrated with Cursor IDE, seamless user experience
  • Command-Driven: Commands as roles (Commands as Roles philosophy)
  • Rule Management: Persistent rules via .mdc files for consistent behavior
  • Extensible: Create custom roles via /prompt_engineer
  • Workflow Automation: Complete discussion → planning → execution workflow

Team Roles

Discussion Partner (/discuss)

The strategist. Engages in discussions, analyzes problems, explores solutions, and generates executable plans. Does not modify project files directly—only provides strategies and plans.

Crew Member (/crew)

The executor. Receives plans from the Discussion Partner and executes them step by step. Strictly follows plan specifications without deviation.

Prompt Engineer (/prompt_engineer)

The HR and trainer. Creates and maintains new roles (Cursor commands). When you need a new specialized role, the Prompt Engineer helps create it as a new command file and rule file.

Workflow

  1. Plan: Use /discuss to explore ideas and generate execution plans
  2. Execute: Use /crew to execute the plans
  3. Expand: Use /prompt_engineer to create new roles when needed

Comparison with Similar Products

Feature cursor-agent-team LangChain/AutoGen GitHub Copilot
Positioning IDE Extension Framework General Application Framework Code Completion Tool
Integration IDE Native External API/Library IDE Plugin
Multi-Agent ✅ Yes ✅ Yes ❌ No
Role System ✅ Commands as Roles ✅ Explicit Definition ❌ No
Workflow ✅ Discussion→Execution ✅ Configurable ❌ No
Lightweight ✅ Yes ❌ No ✅ Yes
Extensible ✅ Yes ✅ Yes ❌ No

Additional Features

The framework also includes additional features that extend the core functionality:

Spec-Kit Translator (/spec_translator)

A conversion tool for Spec-Kit workflow integration. Converts execution plans generated by /discuss into spec-kit formatted documents.

Purpose: When your project uses Spec-Kit for specification-driven development, this tool automatically converts Plan files into three spec-kit documents:

  • constitution.md - Project governance principles and development guidelines
  • specify.md - Feature specification document
  • plan.md - Technical implementation plan

Usage:

/spec_translator PLAN-B-001

Workflow Integration:

  1. Use /discuss to generate an execution plan for a software development task
  2. Use /spec_translator to convert the plan to spec-kit documents
  3. Use spec-kit commands (clarify, tasks, etc.) to continue development

Note: This is an additional feature, not a core team role. It only processes software development tasks and automatically rejects non-software development plans.

For more information about Spec-Kit, visit the Spec-Kit repository.

Usage Example

Step 1: Discuss and Plan

/discuss
I want to add a new section about computational complexity to the paper. 
What should be included?

After discussion, generate a plan:

/discuss
The discussion is ready, please generate the execution plan

The Discussion Partner generates a plan: PLAN-A-001

Step 2: Execute the Plan

/crew PLAN-A-001

The Crew Member executes the plan step by step.

Step 3: Create New Roles (Optional)

If you need a specialized role for a specific task:

/prompt_engineer
I need a role for generating figure captions

The Prompt Engineer creates:

  • .cursor/commands/figure_caption.md - A new command /figure_caption
  • .cursor/rules/figure_caption_assistant.mdc - Rules for this role

You can now use /figure_caption in Cursor, just like the three core commands.

Installation

For Cursor IDE

Step 1: Add as Git Submodule

git submodule add https://github.com/thiswind/cursor-agent-team.git cursor-agent-team

Step 2: Run Install Script

./cursor-agent-team/install.sh

This installs the three core commands into .cursor/commands/ and rules into .cursor/rules/.

Update

git submodule update --remote cursor-agent-team
./cursor-agent-team/install.sh

Uninstall

./cursor-agent-team/uninstall.sh

For Qwen Code

Step 1: Add as Git Submodule

git submodule add https://github.com/thiswind/cursor-agent-team.git cursor-agent-team

Step 2: Run Qwen Code Install Script

./cursor-agent-team/install_qwen.sh

This installs the three core commands into .qwen/commands/ (TOML format) and context files into .qwen/context/ (Markdown format).

Note: The workspace at cursor-agent-team/ai_workspace/ is SHARED between Cursor and Qwen Code platforms. This allows seamless switching between platforms while maintaining the same discussion history, plans, and execution records.

Update

git submodule update --remote cursor-agent-team
./cursor-agent-team/install_qwen.sh

Uninstall

./cursor-agent-team/uninstall_qwen.sh

Platform Compatibility

  • Cursor IDE: Uses .cursor/ directory with .md commands and .mdc rules
  • Qwen Code: Uses .qwen/ directory with .toml commands and .md context files
  • Shared Workspace: cursor-agent-team/ai_workspace/ is shared between both platforms
  • Compatibility: You can install both versions in the same project - they work independently

License

This project is licensed under the GNU General Public License v3.0 (GPL-3.0).

See LICENSE file for details.

Version

Current version: v0.3.0

See CHANGELOG.md for version history.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Author

thiswind

About

Cursor AI Agent Team Framework: A three-agent collaboration system for AI-assisted work

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages