dev-team-workflow/README.md

Claude Code commands for business analysis, product management, and workflow automation

# Dev Team Workflow (DTW)

Claude Code commands for business analysis and workflow automation.

## 🚀 Quick Install

```bash
npx dev-team-workflow install
```

## 📋 Available Commands

### /dtw business-analyst
Interactive guided session with Alex, your Senior Business Analyst, for systematic business analysis using a proven 2-phase approach.

**Features:**
- **Phase 1:** Opportunity Canvas (Problem validation & stakeholder analysis)
- **Phase 2:** Customer Experience Brief (Solution design & user validation)  
- Template-driven questioning with built-in phase dependencies
- Confluence/Jira integration with proper parent location handling
- Evidence-based analysis and systematic brainstorming techniques

### /dtw product-manager
Interactive guided session with Jordan, your Senior Product Manager, for detailed requirements definition and go-to-market planning.

**Features:**
- **Requirements Planning:** Detailed iteration planning with in/out scope definition
- **GTM Strategy:** Comprehensive launch planning with phased rollout approach
- **Risk Assessment:** RAID analysis and pre-mortem planning
- **Stakeholder Management:** RACI matrix and influence mapping
- **Methodologies:** MoSCoW prioritization, RICE scoring, User Story Mapping, Kano Model
- **Pipeline Integration:** Requires completed BA phases, prepares handoff for Architect

### /dtw architect
Interactive guided session with Morgan, your Lead System Architect, for comprehensive technical architecture using a proven 3-phase approach.

**Features:**
- **Phase 1:** Technical Feasibility Assessment (Stakeholder go/no-go decision)
- **Phase 2:** Backend System Architecture Design (Server-side engineering blueprints)
- **Phase 3:** Frontend Architecture Design (Client-side engineering blueprints)
- Complete UML diagrams, API specifications, database schemas with indexes (ASCII format)
- Engineering-level technical questions for seasoned developers
- Performance benchmarks, security implementation, deployment architecture
- **Methodologies:** Domain-Driven Design, Event Storming, C4 Model, Technology Decision Matrix
- **Pipeline Integration:** Requires completed PM phase, produces actionable engineering tickets

## 🗂️ Project Structure

```
.claude/
├── commands/
│   └── dtw/
│       ├── business-analyst.md     # Business analyst command
│       ├── product-manager.md      # Product manager command
│       └── architect.md            # System architect command (3-phase)
└── resources/
    └── dtw/
        ├── business-analyst/
        │   ├── brainstorming-techniques.md
        │   └── templates/
        │       ├── opportunity-canvas-template.md
        │       └── customer-experience-brief-template.md
        ├── product-manager/
        │   ├── pm-methodologies.md
        │   └── templates/
        │       └── requirements-gtm-template.md
        └── architect/
            ├── architecture-methodologies.md
            └── templates/
                ├── technical-feasibility-template.md
                ├── system-architecture-design-template.md
                └── frontend-architecture-design-template.md
```

## 📦 Installation

The installer creates a clean, namespaced installation in your global Claude config (~/.claude):
- Creates `/dtw business-analyst`, `/dtw product-manager`, and `/dtw architect` slash commands
- Keeps all support files organized in the resources directory
- Avoids conflicts with other Claude commands
- Provides clean uninstall functionality

```bash
# Install
npx dev-team-workflow install

# Uninstall  
npx dev-team-workflow uninstall

# Help
npx dev-team-workflow help
```

## 🔧 Manual Installation

If the automated installer doesn't work, you can manually copy the files:

1. Copy `.claude/commands/dtw/` directory to your `~/.claude/commands/` directory
2. Copy `.claude/resources/dtw/` directory to your `~/.claude/resources/` directory

## 🎯 Usage

Once installed, start with business analysis:

```
/dtw business-analyst
```

Interactive session with Alex for 2-phase business analysis:
- **Phase 1:** Problem validation and opportunity assessment
- **Phase 2:** Solution design and customer validation

Then proceed to product management:

```
/dtw product-manager
```

Interactive session with Jordan for requirements and go-to-market planning:
- Reads your completed BA documents automatically
- Creates detailed requirements with iteration planning
- Develops comprehensive GTM strategy and risk assessment

Finally, complete technical architecture:

```
/dtw architect
```

Interactive session with Morgan for comprehensive technical architecture:
- **Phase 1:** Technical feasibility assessment (stakeholder decisions)
- **Phase 2:** Backend system architecture design (server-side engineering tickets)
- **Phase 3:** Frontend architecture design (client-side engineering tickets)
- Produces UML diagrams, API specs, database schemas with indexes
- Engineering-level technical depth for precise ticket generation

**Template Customization:** Commands prioritize project-local templates in `.claude/resources/dtw/` over global defaults.

## 🤝 Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes  
4. Push to the branch
5. Create a Pull Request

## 📄 License

MIT License - see LICENSE file for details.