# Doit Roadmapit Command

**Completed**: 2026-01-10
**Branch**: 008-doit-roadmapit-command
**PR**: Pending

> **Historical note (0.2.0)**: As of doit 0.2.0, Claude Code templates
> also ship as Agent Skills at `.claude/skills/doit.<name>/SKILL.md`
> alongside the legacy `.claude/commands/doit.<name>.md` files referenced
> throughout this spec. See [agent-skills.md](../templates/agent-skills.md).

## Overview

The `/doit.roadmapit` command creates and manages project roadmaps with prioritized requirements, deferred functionality, and AI-suggested enhancements. It provides guided prompts to help users articulate their project vision and maintains a structured approach to requirement management.

## Requirements Implemented

| ID | Description | Status |
|----|-------------|--------|
| FR-001 | Create new roadmap from template | Done |
| FR-002 | Store roadmap in `.doit/memory/roadmap.md` | Done |
| FR-003 | Include Vision section | Done |
| FR-004 | Support P1-P4 priority levels | Done |
| FR-005 | Include rationale for each item | Done |
| FR-006 | Support feature branch references | Done |
| FR-007 | Support Deferred Items section | Done |
| FR-008 | Add items via `add [item]` argument | Done |
| FR-009 | Defer items via `defer [item]` argument | Done |
| FR-010 | Reprioritize via `reprioritize` argument | Done |
| FR-011 | Display current state before updates | Done |
| FR-012 | Ask clarifying questions | Done |
| FR-013 | Preserve unmodified content | Done |
| FR-014 | Include in scaffoldit (10 commands) | Done |
| FR-015 | Checkin triggers archive to completed_roadmap.md | Done |
| FR-016 | Match feature branch references for archiving | Done |
| FR-017 | Maintain 20-item limit in completed_roadmap.md | Done |
| FR-020 | Provide AI enhancement suggestions | Done |

## Technical Details

### Command Structure

The command supports multiple operations:

| Pattern | Operation | Example |
|---------|-----------|---------|
| `create [vision]` | Create new roadmap | `/doit.roadmapit create a task management app` |
| `add [item]` | Add item to roadmap | `/doit.roadmapit add user authentication` |
| `defer [item]` | Move item to deferred | `/doit.roadmapit defer social login` |
| `reprioritize` | Review and change priorities | `/doit.roadmapit reprioritize` |
| (empty) | Interactive update | `/doit.roadmapit` |

### File Locations

- Command: `.claude/commands/doit.roadmapit.md`
- Roadmap template: `.doit/templates/roadmap-template.md`
- Archive template: `.doit/templates/completed-roadmap-template.md`
- Runtime storage: `.doit/memory/roadmap.md` and `.doit/memory/completed_roadmap.md`

### Integration Points

1. **Scaffoldit**: New projects include the roadmapit command (10 commands total)
2. **Checkin**: Completed features trigger archiving of matching roadmap items
3. **Constitution**: AI suggestions align with project principles when constitution exists

## Files Changed

### New Files
- `.claude/commands/doit.roadmapit.md` - Main command file
- `.doit/templates/roadmap-template.md` - Content template for new roadmaps
- `.doit/templates/completed-roadmap-template.md` - Archive template
- `.doit/templates/commands/doit.roadmapit.md` - Template copy
- `templates/commands/doit.roadmapit.md` - Distribution copy

### Modified Files
- `.claude/commands/doit.scaffoldit.md` - Updated from 9 to 10 commands
- `.claude/commands/doit.checkin.md` - Added step 6 for roadmap archiving
- `README.md` - Added roadmapit to Optional Commands table

## Testing

### Manual Tests (5/5 Passed)

| Test | Description | Result |
|------|-------------|--------|
| MT-001 | Create new roadmap | PASS |
| MT-002 | Add item to existing roadmap | PASS |
| MT-003 | Defer roadmap item | PASS |
| MT-004 | Reprioritize items | PASS |
| MT-005 | AI enhancement suggestions | PASS |

### Automated Tests

No automated tests required per plan.md - manual verification via command execution.

## Usage Examples

```bash
# Create a new roadmap
/doit.roadmapit create a task management app

# Add a new item
/doit.roadmapit add user authentication

# Defer an item
/doit.roadmapit defer dark mode

# Reprioritize items
/doit.roadmapit reprioritize

# Interactive update
/doit.roadmapit
```

## Related Issues

No GitHub issues associated with this feature.

---

*Generated by `/doit.checkin` workflow*
