project

majiayu000's avatarfrom majiayu000

Manage route-agent project: check status, find next tasks, spawn parallel work. Use when starting work, checking progress, or asking "what's next?"

⭐0stars🔀0forks📁View on GitHub🕐Updated Jan 5, 2026
[Project Management]

When & Why to Use This Skill

This Claude skill serves as an advanced project management orchestrator designed to automate and scale software development workflows. It enables users to track milestone progress, identify unblocked tasks through dependency analysis, and accelerate delivery by spawning parallel sub-agents to handle multiple GitHub issues simultaneously using Git worktrees.

Use Cases

  • Automated Project Status Tracking: Instantly assess milestone progress and visualize the completion status of complex software projects directly within the chat interface.
  • Intelligent Task Prioritization: Automatically identify 'ready' tasks by parsing issue dependencies, ensuring the team or agent always works on the most critical unblocked items.
  • Parallel Development Scaling: Use the orchestration engine to launch multiple sub-agents that work in isolated worktrees, allowing for the simultaneous implementation of features and bug fixes.
  • GitHub Workflow Automation: Streamline the lifecycle of a task from issue identification to PR creation and local environment cleanup after merges.
nameproject
description|
Manage route-agent projectcheck status, find next tasks, spawn parallel work. Use when starting work, checking progress, or asking "what's next?"
- Bash(gh*)
- Bash(git*)

Project Management

Assess project status, find ready tasks, and orchestrate parallel work.

Commands

Command Action
/project Show milestone progress and ready tasks
/project next Recommend single next task
/project work Spawn sub-agents for ready tasks (parallel)
/project work #N Work on specific issue
/project cleanup Remove worktrees for merged PRs

Quick Start

# Milestone progress
gh api repos/bendrucker/route-agent/milestones --jq '.[] | "\(.title): \(.closed_issues)/\(.open_issues + .closed_issues)"'

# Open issues
gh issue list --repo bendrucker/route-agent --state open --json number,title,milestone,body --limit 100

Finding Ready Tasks

Ready = No "Depends On" section, OR all dependencies closed.

Parse from issue body:

## Depends On
- Issue title here

Parallel Work (/project work)

  1. Find ready tasks - Parse dependencies, filter unblocked
  2. Create worktrees - One per issue in ./worktrees/<N>/ (inside project, sandbox-allowed)
  3. Spawn sub-agents - Each works in background, creates PR
  4. Report - List spawned agents for monitoring

See references/worktrees.md for details.

Sub-Agent Prompt

Work on issue #N in worktree at <path>.

Issue: <title>
<body>

1. cd to worktree
2. Read CLAUDE.md and relevant docs
3. Implement requirements
4. Commit with descriptive message
5. Push and create PR with "Closes #N"
6. Return PR URL

Milestone Priority

  1. Foundation
  2. Eval Setup (parallel)
  3. Strava Integration
  4. GraphHopper Integration
  5. Route Synthesis
  6. Place Search, Water Stops, Climb Integration, Weather Integration
  7. Ride Preparation, Narrative Research
  8. Research Quality, Route Refinement
  9. Evaluation Framework

Output

Status:

## Project Status

### Foundation (1/2)
- [x] #2 SDK project structure
- [ ] #3 Checkpoint system - READY

### Ready (2)
- #3 Checkpoint system (Foundation)
- #4 Promptfoo setup (Eval Setup)

Work:

## Parallel Work

Spawning:
- #3 Checkpoint system → worktree created, agent launched
- #4 Promptfoo setup → worktree created, agent launched

Monitor with /tasks. PRs appear for review.