Get help on DevTeam commands, concepts, and troubleshooting.
Provides help and troubleshooting for DevTeam commands, concepts, and workflows.
npx claudepluginhub michael-harris/devteamThis skill is limited to using the following tools:
Command: /devteam:help [topic]
Get help on DevTeam commands, concepts, and troubleshooting.
/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
| 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 |
| 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 |
| Topic | Description |
|---|---|
getting-started | New user guide |
troubleshooting | Problem solving |
best-practices | Recommended practices |
migration | Migrating from v2.x |
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' }
}
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 locked" or corruption
Solution:
bash scripts/db-init.sh # Reinitialize
5. Worktree Issues
Symptoms: Merge conflicts, missing worktrees
Solutions:
/devteam:worktree-status # Debug command
/devteam:worktree-cleanup # Manual cleanup
Getting Help
Logs: /devteam:logs --level error
Status: /devteam:status --all
GitHub: https://github.com/michael-harris/devteam/issues
/devteam:status - System status/devteam:logs - Execution logsdocs/GETTING_STARTED.md - Full documentationActivates when the user asks about AI prompts, needs prompt templates, wants to search for prompts, or mentions prompts.chat. Use for discovering, retrieving, and improving prompts.
Search, retrieve, and install Agent Skills from the prompts.chat registry using MCP tools. Use when the user asks to find skills, browse skill catalogs, install a skill for Claude, or extend Claude's capabilities with reusable AI agent components.
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.