phase-new

name	phase-new
description	Create a delivery phase for grouping requirements. Use when defining roadmap phases, "add a phase", "create Phase 2", or organizing requirements into delivery milestones. Do NOT use for importing phases from a PRD (use prd-import instead) or creating requirements (use req-new instead).
argument-hint	[Phase Name]
user-invocable	true
metadata	{"author":"APME Team","version":"1.0.0"}

Phase New

Create a delivery phase for grouping requirements.

Arguments

If $ARGUMENTS is provided (e.g., "Enterprise Dashboard"), use it as the phase name and enter quick mode. Otherwise, run interactive mode.

Usage

/phase-new                    # Interactive mode
/phase-new "Phase Name"       # Quick mode with name

Behavior

1. Determine Next Phase Number

Scan .sdlc/phases/PHASE-* directories for highest number, increment by 1.

2. Gather Information

Phase name? (e.g., "CLI Scanner", "Enterprise Dashboard")

Overview - what does this phase deliver? (1-2 sentences)

Goals (one per line):

Success criteria (one per line):

Dependencies? (previous phases or external, or "none")

3. Create Phase Directory

.sdlc/phases/PHASE-NNN-slug/
└── phase.md

Slug: 2-4 words, lowercase, hyphens.

4. Fill Phase Template

# PHASE-NNN: Phase Name

## Status

Not Started

## Overview

[overview text]

## Goals

- Goal 1
- Goal 2

## Success Criteria

- [ ] Criterion 1
- [ ] Criterion 2

## Requirements

| REQ | Name | Status |
|-----|------|--------|
| — | No requirements yet | — |

## Dependencies

- [dependencies]

## Timeline

- **Target Start**: TBD
- **Target Complete**: TBD

5. Update Index

Edit .sdlc/phases/README.md:

• Add row to phase table
• Insert in numerical order

6. Summary

Done!
- Created: .sdlc/phases/PHASE-NNN-slug/
- Status: Not Started

Next steps:
- Create requirements: /req-new "Feature" --phase PHASE-NNN
- Or import from PRD: /prd-import

Quick Mode

With name provided:

/phase-new "Enterprise Dashboard"

Ask only for overview, use name for slug, skip optional fields.

Phase Lifecycle

Not Started → In Progress → Complete

Status is derived from requirements:

• Not Started: No REQs or all Draft
• In Progress: At least one REQ is In Progress/Approved
• Complete: All REQs are Implemented

Edge Cases

Situation	Handling
No overview provided	Use "Phase NNN delivery"
Duplicate name	Warn, suggest unique name
Phase has no REQs	Valid - REQs added later