@bitlogicsolutions/dev-team

Supercharge your AI coding assistants with specialized development team agents 🚀

Transform Claude Code, Gemini CLI, and other AI assistants into a complete development team with specialized roles: Senior Engineers, Product Managers, Principal Engineers, Test Engineers, and UX Designers - all working together through intelligent workflows.

Why dev-team?

• ✨ Instant Expertise: Access specialized agents for PM, engineering, testing, and UX design
• 🔄 Smart Workflows: Automated prepare and iterate workflows that organize your entire development process
• 🎯 Multi-Tool Support: Works seamlessly with Claude Code, Gemini CLI, GitHub Copilot, and more
• 📁 Auto-Organization: Automatically creates and maintains project documentation structure
• 🧠 Context-Aware: Agents dynamically selected based on task requirements
• 🔥 Zero Config: Works out of the box with sensible defaults

Quick Start

Get up and running in 30 seconds:

# Install dev-team agents to your project
npx @bitlogicsolutions/dev-team install

The installer will:

1. ✅ Auto-detect your installed AI assistants (Claude Code, Gemini CLI, GitHub Copilot, etc.)
2. ✅ Let you choose which tools to configure
3. ✅ Set up agents and workflows automatically
4. ✅ You're ready to use specialized agents!

First Use - Start Building!

# 1. Create initial project plan with PM agent
/dev-team:prepare Create a task tracking app with React and Node.js

# 2. Start implementation with the dev team
/dev-team:iterate

That's it! Your AI assistant now has access to a complete development team. 🎉

Quick Command Reference

Invoking Commands by Tool

| Tool | Prepare Command | Iterate Command | Agent Access | | ------------------ | -------------------------- | ------------------- | ------------------------------------- | | Claude Code | /dev-team:prepare <task> | /dev-team:iterate | /dev-team:swe, /dev-team:pm, etc. | | Gemini CLI | /dev-team:prepare <task> | /dev-team:iterate | /dev-team:swe, /dev-team:pm, etc. | | GitHub Copilot | /dev-team-prepare | /dev-team-iterate | /dev-team-swe, etc. |

Installation Options

Installation Methods

Clean Installation (Recommended for Updates)

Remove any existing configurations before installing new ones:

# Clean and reinstall
npx @bitlogicsolutions/dev-team install --clean

# Clean and install specific tools
npx @bitlogicsolutions/dev-team install --clean --claude --gemini

The --clean option removes:

• Target directory (.dev-team by default or custom via --target-dir)
• Tool-specific configurations:
  • Claude: .claude/agents/dev-team and .claude/commands/dev-team
  • Gemini: .gemini/extensions/dev-team

Uninstalling Configurations

To completely uninstall dev-team configurations:

# Uninstall default installation
npx @bitlogicsolutions/dev-team uninstall

# Uninstall custom directory installation
npx @bitlogicsolutions/dev-team uninstall --target-dir .ai-assistants

The uninstall command removes all dev-team configurations from your system, including:

• Target directory with all agent prompts, commands, and scripts
• Tool-specific configurations (Claude symlinks, Gemini extensions)

Tool-Specific Installation

Install for specific AI assistants only:

# Claude Code only
npx @bitlogicsolutions/dev-team install --claude

# Gemini CLI only
npx @bitlogicsolutions/dev-team install --gemini

# GitHub Copilot only
npx @bitlogicsolutions/dev-team install --copilot

# All available tools
npx @bitlogicsolutions/dev-team install --all

# Custom directory
npx @bitlogicsolutions/dev-team install --target-dir .ai-assistants --claude

# Non-interactive mode
npx @bitlogicsolutions/dev-team install --all --no-interactive

# Clean previous installations before reinstalling
npx @bitlogicsolutions/dev-team install --clean --claude

# Clean and install all tools
npx @bitlogicsolutions/dev-team install --clean --all

Meet Your AI Development Team

Each agent brings specialized expertise to your project:

👥 Your Specialized Agents

| Agent | Claude/Gemini | GitHub Copilot | Role | Expertise | | ---------- | --------------- | --------------- | ------------------------- | ---------------------------------------------------------------- | | 🛠️ SWE | /dev-team:swe | /dev-team-swe | Senior Fullstack Engineer | Implements features, fixes bugs, writes production-ready code | | 📋 PM | /dev-team:pm | /dev-team-pm | Product Manager | Analyzes requirements, creates user stories, manages scope | | 🏗️ PE | /dev-team:pe | /dev-team-pe | Principal Engineer | System architecture, technical strategy, cross-team coordination | | ✅ SET | /dev-team:set | /dev-team-set | Senior Test Engineer | Test strategies, quality reviews, automated testing | | 🎨 UXD | /dev-team:uxd | /dev-team-uxd | UX Designer | Visual design, UI consistency, user experience optimization |

🔄 Intelligent Workflows

| Workflow | Claude/Gemini | GitHub Copilot | Purpose | What It Does | | ----------- | ------------------- | ------------------- | --------------------- | ----------------------------------------------------------------------------------------- | | Prepare | /dev-team:prepare | /dev-team-prepare | Project Planning | Creates comprehensive documentation: PRD, architecture, implementation plan, UX specs | | Iterate | /dev-team:iterate | /dev-team-iterate | Development Execution | Orchestrates the team to implement features, with automatic agent selection based on task |

Real-World Usage Examples

🚀 Building an MVP from Scratch

Claude Code / Gemini CLI

/dev-team:prepare Build a todo list app with user authentication
# → Creates PRD, architecture docs, implementation plan

/dev-team:iterate Implement the user registration flow
# → SWE builds it, SET reviews it, UXD validates UI

GitHub Copilot (VS Code)

# Use @workspace chat to invoke dev-team prompts
/dev-team-prepare plan a todo list app with user authentication
# → Creates comprehensive project documentation

/dev-team-iterate implement the user registration flow
# → Orchestrates team to build and validate

➕ Adding Features to Existing Projects

Claude Code / Gemini CLI

/dev-team:prepare Add real-time notifications to our app
# → Creates feature-specific docs in organized folders

/dev-team:iterate Implement WebSocket notification system
# → Coordinates team to build, test, and validate

GitHub Copilot (VS Code)

# Use @workspace chat with dev-team prompts
/dev-team-prepare add real-time notifications
# → Analyzes requirements and creates feature docs

/dev-team-iterate implement WebSocket notifications
# → Coordinates specialized agents for implementation

📁 Automatic Documentation Organization

Dev-team automatically creates and maintains your project docs:

your-app/docs/
├── PRD.md                    # Product requirements (auto-updated)
├── architecture.md           # System design (evolving)
├── implementation-plan.md    # Task breakdown
├── ux-design.md             # UI/UX specifications
└── features/
    └── notifications/       # Feature-specific docs
        ├── PRD.md          # Feature requirements
        ├── architecture.md  # Technical design
        └── tasks.md        # Implementation tasks

Supported AI Assistants

| Tool | Setup | Features | Auto-Detection | | ------------------ | ------------------------------------------- | --------------------------------------------- | ----------------------- | | Claude Code | .claude/ symlinks | Subagents, slash commands, live updates | .claude/ directory | | Gemini CLI | .gemini/extensions/ | Custom commands, rich context | gemini CLI installed | | GitHub Copilot | .github/prompts/, .github/instructions/ | Prompt templates, automatic context inclusion | VS Code with .vscode/ | | More coming | - | Contact us to add support | - |

Key Features

🎯 Smart Agent Selection

The right expert for each task - automatically. Building UI? UXD reviews it. Writing tests? SET guides the strategy. System design? PE leads architecture decisions.

📝 Living Documentation

Documents evolve with your project. PRDs update as features are added. Architecture docs reflect current system design. No more outdated documentation.

🔄 Unified Workflows

Same commands across all AI assistants. Learn once, use everywhere. Switch between Claude and Gemini without changing your workflow.

🏗️ Production-Ready Output

Agents follow best practices, write tests, consider edge cases, and produce code ready for deployment - not just demos.

Advanced Configuration

Custom Installation Paths

# Install to custom directory
npx @bitlogicsolutions/dev-team install --target-dir .ai-tools

# Non-interactive installation
npx @bitlogicsolutions/dev-team install --all --no-interactive

Executable Commands

Optional CLI tools become available after installation:

npx dev-team          # Main CLI

Troubleshooting

Installation not detecting your AI assistant?

• Ensure Claude Code or Gemini CLI is installed
• Check for .claude/ or .gemini/ directories in your project

Commands not working?

• Run npx @bitlogicsolutions/dev-team install --clean to reinstall
• Verify installation with npx @bitlogicsolutions/dev-team list
• For GitHub Copilot: Check that .github/prompts/ and .github/instructions/ directories exist

Need help?

• Open an issue on GitHub

⚠️ Migration Notice

Important for version 0.3.0+: This version introduces significant changes to workflow state management for improved performance and reliability.

• Do not upgrade mid-feature: Complete any in-progress features before upgrading
• Clean state after upgrade: Remove .workflow-state/ directories to start fresh
• No fallback mode: The new TSV-based progress tracking is not backward compatible

Release History

[0.3.0] - 2025-09-07

Features ✨

• Enhanced dev-team workflow with standardized implementation plan passing for improved task coordination
• Implemented state machine directives for enhanced task management workflow control
• Added strict error handling and validation in task management scripts for improved reliability

[0.2.1] - 2025-09-01

Features

• Added AGENTS.md compatibility layer for Claude integration
• Enhanced documentation with parallel execution support
• Improved CLI adapters with sourcePath support for file operations

Bug Fixes

• Refactored documentation paths in iterate and prepare commands
• Fixed workflow state directory exports in prepare command

[0.2.0] - 2025-09-01

Features

• GitHub Copilot integration - Full support for GitHub Copilot with prompt templates and workspace integration
• Enhanced tool integration across Claude Code, Gemini CLI, and GitHub Copilot
• Improved installation and test stability

Performance

• Streamlined tool detection and configuration process

[0.1.7] - 2025-08-29

Bug Fixes

• Updated agent command references in README for consistency
• Improved command template documentation

[0.1.6] - 2025-08-29

Bug Fixes

• Enhanced README with consistent command formatting across all AI assistants

[0.1.5] - 2025-08-29

Features

• Added comprehensive CLAUDE.md documentation for development guidance
• Enhanced Gemini adapter with improved directory handling and symlink functionality
• Improved installation and testing workflows

Bug Fixes

• Fixed command template references in iterate.md
• Corrected agent template paths
• Improved test environment cleanup logging

[0.1.4] - 2025-08-29

Features

• Enhanced script execution and logging in claude-repeat tool
• Updated testing scripts with better output file handling
• Improved packaging workflow

[0.1.3] - 2025-08-29

Features

• Enhanced testing and packaging workflow
• Updated publish command dependencies

[0.1.2] - 2025-08-29

Features

• Enhanced installation process with symlink support
• Refined project description and README content

[0.1.1] - 2025-08-28

Features

• UX Designer agent - Added specialized UX Designer agent with dynamic agent selection
• Task batching optimization for improved workflow performance
• Review phase parallelization for faster iteration cycles
• Enhanced claude-repeat command ergonomics

Bug Fixes

• Updated NPM namespace from @bitlogic-solutions to @bitlogicsolutions
• Improved relative path handling in claude-repeat
• Fixed bin folder copying in build process

[0.1.0] - 2025-08-27

Features

• Gemini CLI support - Full integration with Gemini CLI through custom extensions
• User review and confidence-based classification system
• Adaptive complexity workflow for intelligent task routing
• Automated shellcheck linting for script quality
• Test environment target for development workflows

Bug Fixes

• Fixed dev-team bin path resolution
• Cleaned up installation locations
• Improved claude-repeat logging output

[0.0.x] - 2025-08-26

Features

• Initial release of dev-team library
• Core agent system with PM, SWE, PE, and SET agents
• Prepare and iterate workflow commands
• Claude Code integration with symlink-based agent system
• NPM package publishing and distribution setup
• MIT license and initial documentation

License

This software is proprietary and confidential. See LICENSE for details.

For licensing inquiries, please contact: [email protected]