/devteam-plan

DevTeam Plan Command

**Command:** `/devteam:plan [options]`

Conduct interactive requirements gathering, research the codebase, create a PRD, and generate a development plan with tasks and sprints.

Usage

/devteam:plan                                # Start interactive planning
/devteam:plan "Build a task manager"         # Start with description
/devteam:plan --feature "Add dark mode"      # Plan a feature for existing project
/devteam:plan --from spec.md                 # Load from single spec file
/devteam:plan --from specs/                  # Load from folder of spec files
/devteam:plan --from existing                # Auto-detect existing docs in project
/devteam:plan --skip-research                # Skip research phase

Options

| Option | Description | |--------|-------------| | `--feature "<desc>"` | Plan a feature for existing project | | `--from <path>` | Load from spec file or folder | | `--skip-research` | Skip codebase research phase | | `--skip-interview` | Skip interview (use with --from) |

File-Based Specification Support

Supported File Formats

| Format | Extensions | Best For | |--------|------------|----------| | Markdown | `.md` | Human-readable specs, PRDs | | YAML | `.yaml`, `.yml` | Structured specs, existing PRDs | | JSON | `.json` | API specs, structured data | | Plain Text | `.txt` | Simple requirements lists | | PDF | `.pdf` | Formal documents (extracted) |

Single File Mode (`--from file.md`)

Reads a specification file and extracts:

• Project description
• Features/requirements (from headers, lists)
• Technical constraints
• User stories
• Acceptance criteria

**Example Input (`project-spec.md`):**

# Task Manager App

## Overview
A simple task management app for teams.

## Features
- User authentication with OAuth
- Create, edit, delete tasks
- Assign tasks to team members
- Due date reminders

## Technical Requirements
- Backend: FastAPI
- Database: PostgreSQL
- Frontend: React + TypeScript

**Process:** 1. Read and parse file 2. Extract structured information 3. Confirm understanding with user (brief) 4. Skip redundant interview questions 5. Generate PRD from extracted data

Folder Mode (`--from specs/`)

Reads all spec files from a folder and merges them:

specs/
├── overview.md           # Project overview
├── features/
│   ├── auth.md          # Authentication spec
│   ├── tasks.md         # Task management spec
│   └── notifications.md # Notification spec
├── api-design.yaml      # API specification
└── wireframes.md        # UI descriptions

**Process:** 1. Scan folder recursively 2. Categorize files by type/content 3. Merge into unified understanding 4. Resolve conflicts (ask user if ambiguous) 5. Generate comprehensive PRD

Auto-Detect Mode (`--from existing`)

Searches project for existing documentation:

**Search locations:**

docs/                    # Common docs folder
documentation/           # Alternative name
spec/                    # Spec folder
specifications/          # Alternative name
requirements/            # Requirements folder
*.md in root            # README, CONTRIBUTING, etc.
.github/                # Issue templates, etc.

**Process:** 1. Scan project structure 2. Find and list discovered docs 3. Ask user to confirm which to use 4. Parse and extract requirements 5. Fill gaps with brief questions

File Parsing Examples

**From Markdown with headers:**

# Feature: User Authentication

## Requirements
- [ ] OAuth 2.0 support (Google, GitHub)
- [ ] Session management
- [ ] Password reset flow

## Acceptance Criteria
1. User can sign in with Google
2. Session persists for 7 days
3. Password reset email sent within 1 minute

→ Extracted as:

{
  "feature": {
    "name": "User Authentication",
    "requirements": [
      "OAuth 2.0 support (Google, GitHub)",
      "Session management",
      "Password reset flow"
    ],
    "acceptance_criteria": [
      "User can sign in with Google",
      "Session persists for 7 days",
      "Password reset email sent within 1 minute"
    ]
  }
}

**From YAML directly:**

# Already structured - use as-is
project:
  name: Task Manager
features:
  - name: Authentication
    priority: must_have

**From JSON (OpenAPI):**

{
  "openapi": "3.0.0",
  "paths": {
    "/tasks": { "get": {...}, "post": {...} }
  }
}

→ Extract API endpoints as features

User Confirmation

After parsing file-based specs, always confirm:

📄 Loaded specification from: project-spec.md

Extracted:
  • Project: Task Manager App
  • Features: 4 identified
  • Tech Stack: FastAPI + PostgreSQL + React
  • Constraints: None specified

Is this correct? (yes/edit/add more)

If `edit`: Allow user to modify extracted data If `add more`: Continue with remaining interview questions

Your Process

This command combines PRD generation and sprint planning into a single workflow.

Phase 0: Git Repository Check (REQUIRED)

Before any planning, verify git repository exists:

# Check for git repository
git rev-parse --git-dir 2>/dev/null

**If NOT a git repository:**

┌──────────────────────────────────────────────────────────────┐
│  📁 Git Repository Required                                  │
│                                                              │
│  DevTeam requires a git repository for:                      │
│  • Change tracking and rollback                              │
│  • Parallel plan execution (worktrees)                       │
│  • Safe merge of feature branches                            │
│  • Circuit breaker recovery                                  │
│                                                              │
│  Initialize a git repository now? (yes/no): _                │
└──────────────────────────────────────────────────────────────┘

If user says **yes**:

git init
git add .
git commit -m "Initial commit before DevTeam planning"
echo "✅ Git re