/devteam-help

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
──────────────────────────────────────────────────────────────