gsd-list-milestones

name: gsd-list-milestones description: Display completed milestones from the MILESTONES.md registry allowed-tools: Read, Bash

Purpose: Show milestone history without scanning filesystem. Output: Formatted list of completed milestones with key accomplishments. </objective>

<execution_context> @.github/get-shit-done/references/ui-brand.md </execution_context>

if [ ! -f .planning/MILESTONES.md ]; then
    echo ""
    echo "No milestones completed yet."
    echo ""
    echo "Complete your first milestone with:"
    echo "  /gsd-complete-milestone"
    echo ""
    exit 0
fi

If registry doesn't exist: Show friendly message and exit. If registry exists: Continue to display step. </step>

echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo " GSD ► MILESTONE HISTORY"
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"
echo ""

# Display registry content
cat .planning/MILESTONES.md

echo ""
echo "───────────────────────────────────────────────────────────────"
echo ""
echo "Archived milestones are in: .planning/history/"
echo ""
echo "To view archived files:"
echo "  ls .planning/history/v1.0/"
echo "  cat .planning/history/v1.0/ROADMAP.md"
echo ""
echo "To start new milestone:"
echo "  /gsd-new-milestone"
echo ""
echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

<success_criteria>

• Registry existence checked before display
• Friendly message if no milestones completed yet
• MILESTONES.md content displayed directly (no parsing)
• Helpful bash commands shown for accessing archives
• User knows next command (complete-milestone or new-milestone)
• Template variables (/gsd-) used for cross-platform support </success_criteria>