gsd-list-milestones

<objective> Display completed milestones from the MILESTONES.md registry.

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>

<context> Registry file: - `.planning/MILESTONES.md` — Milestone completion registry </context> <process> <step name="check_registry_exists"> Check if milestone registry exists using bash:

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>

<step name="display_milestones"> Display milestone history from registry:

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 "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━"

</step> </process>

<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>