zhongwei/gh-coalesce-labs-catalyst-plugins-dev

Files

Zhongwei Li bb966f5886 Initial commit

2025-11-29 18:14:39 +08:00

3.2 KiB

Raw Permalink Blame History

description, category, tools, model, version, status

description	category	tools	model	version	status
Review project roadmap and milestone progress	project-task-management	Bash(linearis *), Read, Write, TodoWrite	inherit	1.0.0	placeholder

Roadmap Review

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

Planned Functionality

This command will help you review your roadmap by:

Listing all active projects
Showing milestone progress for each project
Identifying project dependencies
Calculating project completion
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

/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

3.2 KiB Raw Permalink Blame History