Roadmap Review

Status: Placeholder for v1.0 - Full implementation coming in future release

Planned Functionality

This command will help you review your roadmap by:

1. Listing all active projects
2. Showing milestone progress for each project
3. Identifying project dependencies
4. Calculating project completion
5. Generating roadmap summary

Current Workaround

Use Linearis CLI directly:

# List projects
linearis projects list --team TEAM

# Parse project status from JSON
linearis projects list --team TEAM | jq '.[] | {name, status, progress}'

# List tickets for specific project
linearis issues list --team TEAM | jq '.[] | select(.project.name == "Project Name")'

Example Workflow

# 1. List all active projects
linearis projects list --team ENG | \
  jq '.[] | select(.state != "completed") | {name, lead, targetDate}'

# 2. Get project details with ticket counts
for project in $(linearis projects list --team ENG | jq -r '.[].name'); do
  echo "Project: $project"

  # Count tickets by status
  linearis issues list --team ENG | \
    jq --arg proj "$project" '
      [.[] | select(.project.name == $proj)] |
      group_by(.state.name) |
      map({status: .[0].state.name, count: length})
    '
done

# 3. Identify project dependencies
# (Manual - look at project descriptions or ticket relationships)

# 4. Calculate overall progress
# total_tickets in project
# completed_tickets in project
# progress = (completed / total) * 100

# 5. Identify at-risk projects
# - No tickets completed in last 2 weeks
# - Target date approaching with <50% completion
# - Blocked tickets preventing progress

Future Implementation

When fully implemented, this command will:

• Project overview - Show all projects with key metrics
• Milestone tracking - Group tickets by milestone with progress
• Dependency visualization - Show project relationships and blockers
• Risk analysis - Identify at-risk projects (delayed, under-resourced)
• Timeline view - Show project timelines and conflicts
• Resource allocation - Show team members assigned to projects
• Summary generation - Create roadmap document in thoughts/
• Trend analysis - Compare progress month-over-month

Track progress at: https://github.com/coalesce-labs/catalyst/issues

Configuration

Uses .claude/config.json:

{
  "linear": {
    "teamKey": "ENG",
    "defaultTeam": "Backend"
  }
}

Tips

• Review roadmap monthly or quarterly
• Update target dates based on actual velocity
• Document dependencies explicitly in project descriptions
• Identify resource constraints early
• Communicate delays proactively to stakeholders
• Use milestones to track major deliverables
• Archive completed projects to reduce noise
• Link projects to company OKRs for alignment

Related Commands

• /cycle-plan - Plan work within cycles for a project
• /cycle-review - Review cycle progress
• /catalyst-dev:linear - Manage individual tickets
• /create-plan - Create implementation plans for tickets