/README

DevTeam Commands

Slash commands for the DevTeam multi-agent development system.

Command Overview

Command	Description
/devteam:plan	Interactive planning - creates PRD, tasks, and sprints
/devteam:implement	Autonomous execution until project/feature complete
/devteam:bug	Fix a bug with structured diagnostic workflow and Bug Council if needed
/devteam:issue <#>	Fix a GitHub issue by number
/devteam:issue-new "<desc>"	Create a new GitHub issue
/devteam:list	List all plans and their status
/devteam:select	Select a plan to work on
/devteam:status	Display system health, progress, costs, and execution history
/devteam:reset	Reset state, clear stuck sessions, and recover from errors
/devteam:merge-tracks	Manually merge parallel tracks (auto-merge is default)
/devteam:config	View and modify DevTeam configuration settings
/devteam:help	Get help on commands, concepts, and troubleshooting
/devteam:logs	View execution logs, events, and history
/devteam:worktree-status	Show worktree status for troubleshooting
/devteam:worktree-list	List all git worktrees for troubleshooting
/devteam:worktree-cleanup	Manually clean up worktrees if auto-cleanup failed
/devteam:design	Generate or update design system tokens and guidelines
/devteam:design-drift	Detect design drift between implementation and design system
/devteam:review	Run code review on current changes
/devteam:test	Run test suite with appropriate test writers

Quick Start

New Project

# 1. Plan your project (interactive)
/devteam:plan "Build a task manager"

# 2. Execute autonomously
/devteam:implement

Add a Feature (to existing project)

# 1. Create feature plan
/devteam:plan --feature "Add dark mode support"

# 2. Execute the feature
/devteam:implement

Multiple Features

# Plan several features
/devteam:plan --feature "Add notifications"
/devteam:plan --feature "Add dark mode"

# List all plans
/devteam:list

# Select which one to work on
/devteam:select notifications

# Execute selected plan
/devteam:implement

From Spec File

# Plan from existing specification
/devteam:plan --from project-spec.md
/devteam:plan --from specs/              # Folder of specs

Fix a Bug

# Fix GitHub issue #123
/devteam:issue 123

Create Issue

# Create and track a new issue
/devteam:issue-new "Login button broken on mobile"

Command Details

/devteam:plan

Combines PRD generation and sprint planning:

1. Interactive requirements interview
2. Technology stack selection
3. PRD generation (docs/planning/PROJECT_PRD.json)
4. Task breakdown (docs/planning/tasks/)
5. Sprint organization (docs/sprints/)
6. State initialization in SQLite (.devteam/devteam.db)

/devteam:implement

Autonomous execution mode:

• Executes all sprints continuously
• Uses stop hooks to prevent premature exit
• Circuit breaker prevents infinite loops
• Dynamic model selection for cost optimization
• Session memory preserved across compaction
• Outputs EXIT_SIGNAL: true when complete

/devteam:issue

Fix GitHub issues:

• Fetches issue details from GitHub
• Classifies severity and complexity
• Bug Council for complex bugs (5 Opus agents)
• Automatic fix implementation
• Closes issue when complete

/devteam:issue-new

Create GitHub issues:

• Parses description for type/severity
• Auto-applies labels
• Well-formatted issue template
• Suggests next steps

/devteam:list

View all development plans:

• Shows active plan indicator
• Status and progress for each plan
• Filter by type (--type feature)
• Include archived (--all)

/devteam:select

Select a plan to work on:

• By number: /devteam:select 2
• By name: /devteam:select dark-mode
• Partial match supported
• Shows plan details after selection

Plan Management

DevTeam supports multiple concurrent plans:

.devteam/plans/
├── index.json                    # Master plan index
├── project-taskmanager/          # Original project
├── feature-notifications/        # Feature 1
└── feature-dark-mode/            # Feature 2

Plan Types

Type	Description	Use Case
project	Full new project	Starting from scratch
feature	Addition to existing	New functionality
enhancement	Improvement	Optimization/refactor

Plan Lifecycle

planned → in_progress → complete → (archive)
                    ↘ failed → (retry/abandon)

State Management

Each plan has its state tracked in SQLite:

• .devteam/devteam.db (sessions, tasks, plans tables)

State tracks:

• Progress (sprints, tasks)
• Model selection history
• Circuit breaker status
• Session memory references

Migration from /multi-agent

Old Command	New Command
/devteam:prd	/devteam:plan
/devteam:planning	/devteam:plan
/devteam:sprint all	/devteam:implement
/devteam:sprint <id>	/devteam:implement --sprint
/devteam:issue	/devteam:issue
/devteam:feature	/devteam:plan (then auto)

Legacy Commands

The following commands are deprecated and removed - use the indicated replacement commands instead:

• prd.md → Use /devteam:plan
• planning.md → Use /devteam:plan
• sprint-all.md → Use /devteam:implement
• feature.md → Use /devteam:plan