Analyze project milestone health with actionable insights, target date assessment, risk analysis, and specific recommendations
Generates a comprehensive health report for project milestones with risk analysis and actionable recommendations.
/plugin marketplace add coalesce-labs/catalyst/plugin install catalyst-pm@catalystinheritGenerates a comprehensive health report for a project milestone.
Reports Include:
Philosophy: Provide insights and recommendations for milestone planning, not just data dumps.
# 1. Validate thoughts system (REQUIRED)
if [[ -f "scripts/validate-thoughts-setup.sh" ]]; then
./scripts/validate-thoughts-setup.sh || exit 1
else
# Inline validation if script not found
if [[ ! -d "thoughts/shared" ]]; then
echo "ā ERROR: Thoughts system not configured"
echo "Run: ./scripts/humanlayer/init-project.sh . {project-name}"
exit 1
fi
fi
# 2. Determine script directory with fallback
if [[ -n "${CLAUDE_PLUGIN_ROOT}" ]]; then
SCRIPT_DIR="${CLAUDE_PLUGIN_ROOT}/scripts"
else
# Fallback: resolve relative to this command file
SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)/scripts"
fi
# 3. Check PM plugin prerequisites
if [[ -f "${SCRIPT_DIR}/check-prerequisites.sh" ]]; then
"${SCRIPT_DIR}/check-prerequisites.sh" || exit 1
else
echo "ā ļø Prerequisites check skipped (script not found at: ${SCRIPT_DIR})"
fi
Option A: User provides milestone name
MILESTONE_NAME="Q1 Launch"
PROJECT_NAME="Mobile App"
Option B: Interactive prompt
Which milestone would you like to analyze?
- Milestone name: [user input]
- Project name (optional, helps scope lookup): [user input]
Use Task tool with catalyst-dev:linear-research agent:
Prompt: "Get milestone '${MILESTONE_NAME}' details for project '${PROJECT_NAME}' with all issues (limit 100)"
Model: haiku (fast data gathering)
If milestone not found or ambiguous, report error and ask user to clarify.
Use Task tool with milestone-analyzer agent:
Input:
Agent returns: Structured markdown with:
Format the analyzer output into final report:
# Milestone Health Report: [Milestone Name]
**Project**: [Project Name]
**Target Date**: [YYYY-MM-DD] ([X] days remaining)
**Generated**: [YYYY-MM-DD HH:MM]
---
## š¢/š”/š“ Health Assessment
**Takeaway**: [One-sentence summary with target date assessment]
**Current State**:
- Progress: X% complete (Y/Z issues done)
- Target: [YYYY-MM-DD] ([N] days remaining)
- Projected completion: [YYYY-MM-DD] (based on current velocity)
- Risk level: [On track / Behind by N days / Critical]
---
## š Progress Tracking
[Progress bars, velocity, time remaining]
---
## ā ļø Risks & Blockers
[Target date risks, blockers, at-risk issues]
---
## š” Recommendations
[Priority-ordered actions]
---
**Next Review**: [Suggested date based on target date proximity]
REPORT_DIR="thoughts/shared/reports/milestones"
mkdir -p "$REPORT_DIR"
# Sanitize milestone name for filename
MILESTONE_SLUG=$(echo "$MILESTONE_NAME" | tr '[:upper:]' '[:lower:]' | tr ' ' '-')
REPORT_FILE="$REPORT_DIR/$(date +%Y-%m-%d)-${MILESTONE_SLUG}.md"
# Write formatted report
# ...
echo "ā
Report saved: $REPORT_FILE"
# Update workflow context
if [[ -f "${SCRIPT_DIR}/workflow-context.sh" ]]; then
"${SCRIPT_DIR}/workflow-context.sh" add reports "$REPORT_FILE" "${TICKET_ID:-null}"
fi
šÆ Milestone Health: [Milestone Name] - [š¢/š”/š“]
Target Date: [YYYY-MM-DD] ([X] days remaining)
Progress: āāāāāāāāāā [X]% ([Y]/[Z] issues)
Status: [On track / Behind by N days]
Priority Actions:
1. [Action 1]
2. [Action 2]
3. [Action 3]
Full report: thoughts/shared/reports/milestones/YYYY-MM-DD-milestone.md