/devteam-help

name: devteam-help
description: Get help on DevTeam commands, concepts, and troubleshooting.
argument-hint: [topic]
user-invocable: true
allowed-tools: Read, Glob, Grep, Bash
model: haiku

DevTeam Help Command

**Command:** `/devteam:help [topic]`

Get help on DevTeam commands, concepts, and troubleshooting.

Usage

/devteam:help                    # Show command overview
/devteam:help implement          # Help for specific command
/devteam:help eco                # Help on eco mode
/devteam:help agents             # Help on agent system
/devteam:help troubleshooting    # Troubleshooting guide

Available Topics

Commands

| Topic | Description | |-------|-------------| | `plan` | Planning and PRD generation | | `implement` | Implementation execution | | `bug` | Bug fixing workflow | | `issue` | GitHub issue handling | | `status` | System status and metrics | | `reset` | Reset and recovery | | `config` | Configuration management | | `logs` | Log viewing |

Concepts

| Topic | Description | |-------|-------------| | `eco` | Eco mode for cost optimization | | `task-loop` | Task Loop quality loop | | `interview` | Interview system | | `research` | Research phase | | `escalation` | Model escalation | | `gates` | Quality gates | | `council` | Bug Council | | `agents` | Agent system | | `worktrees` | Git worktree automation |

Guides

| Topic | Description | |-------|-------------| | `getting-started` | New user guide | | `troubleshooting` | Problem solving | | `best-practices` | Recommended practices | | `migration` | Migrating from v2.x |

Your Process

Step 1: Resolve Topic

function resolveTopic(input) {
    // Exact match
    if (topics[input]) return topics[input]

    // Command alias
    if (commandAliases[input]) return topics[commandAliases[input]]

    // Fuzzy match
    const matches = findSimilar(input, Object.keys(topics))
    if (matches.length) {
        return { type: 'suggestion', matches }
    }

    return { type: 'not_found' }
}

Step 2: Display Help

**No Topic (Overview):**

DevTeam v3.4 Help

Quick Start
  /devteam:plan              Create a project plan
  /devteam:implement         Execute implementation
  /devteam:bug "issue"       Fix a bug
  /devteam:status            Check system status

Common Commands
  Plan & Execute
    /devteam:plan            Interactive planning with research
    /devteam:implement       Execute plans, sprints, or tasks
    /devteam:implement --eco Cost-optimized execution

  Bug Fixing
    /devteam:bug             Fix local bugs
    /devteam:issue #123      Fix GitHub issues

  Management
    /devteam:status          System health and costs
    /devteam:list            List plans and tasks
    /devteam:reset           Reset stuck sessions

Get Help on Specific Topics
  /devteam:help <command>    Help for a command
  /devteam:help eco          Eco mode explanation
  /devteam:help task-loop    Quality loop details
  /devteam:help troubleshooting  Problem solving

Documentation: https://github.com/michael-harris/devteam

**Command Help:**

/devteam:help implement

/devteam:implement
Execute implementation work

Usage
  /devteam:implement                    Execute current plan
  /devteam:implement --sprint 1         Execute specific sprint
  /devteam:implement --all              Execute all sprints
  /devteam:implement "task"             Ad-hoc task
  /devteam:implement --eco              Cost-optimized mode

Options
  --sprint <id>      Execute specific sprint
  --all              Execute all sprints
  --task <id>        Execute specific task
  --eco              Cost-optimized execution
  --skip-interview     Skip ambiguity check
  --type <type>      Task type: feature, bug, security
  --model <model>    Force model: haiku, sonnet, opus

Examples
  # Execute first sprint
  /devteam:implement --sprint 1

  # Quick bug fix with eco mode
  /devteam:implement "Fix login button" --eco --type bug

  # Execute with specific model
  /devteam:implement --task TASK-001 --model opus

See Also
  /devteam:plan      Create plans first
  /devteam:status    Check progress
  /devteam:help eco  Cost optimization details

**Concept Help:**

/devteam:help eco

Eco Mode
Cost-optimized execution

Overview
Eco mode reduces costs by 30-50% through:
  - Starting with Haiku for most tasks
  - Slower model escalation (4 failures vs 2)
  - Summarized context to reduce tokens
  - Sequential quality gates

When to Use
  Simple tasks (complexity 1-6)
  Bug fixes with clear reproduction
  Documentation updates
  Code formatting/linting
  Test writing for existing code

When NOT to Use
  Complex architecture decisions
  Security-sensitive code
  Tasks requiring deep reasoning
  Complexity 10+ tasks

Comparison
                    Normal          Eco
  Initial Model     Complexity-based Haiku
  Escalation        2 failures      4 failures
  Context           Full            Summarized
  Quality Gates     Parallel        Sequential
  Avg Cost          $0.15/task      $0.06/task

Usage
  /devteam:implement --eco "task"
  /devteam:bug "issue" --eco
  /devteam:config set execution.mode eco  # Set as default

See Also
  /devteam:help escalation  Model escalation details
  /devteam:status --costs   Cost breakdown

**Troubleshooting:**

/devteam:help troubleshooting

Troubleshooting Guide

Common Issues

1. Session Stuck
   Symptoms: Commands not responding, "session in progress"
   Solution:
     /devteam:reset
     /devteam:reset --session <id>

2. Tests Keep Failing
   Symptoms: Task Loop not converging
   Solutions:
     - Check test output: /devteam:logs --level error
     - Force model upgrade: --model opus
     - Break into smaller tasks

3. High Costs
   Symptoms: Unexpected token usage
   Solutions:
     - Use eco mode: --eco
     - Check costs: /devteam:status --costs
     - Review model usage in logs

4. Database Errors
   Symptoms: "Database l