New description after feedback

Co-authored by: Tom Bamford

Author: bserem

commands/host/tw-description

@@ -90,20 +90,35 @@ if [ -z "$MR_LINK" ]; then
     exit 1
 fi
 
-# Prompt for deploy state/notes - pre-fill default checklist items for inline editing
-echo_yellow "Edit deploy checklist (arrow keys to edit, clear a line to remove it, empty line to finish):"
+# Prompt for deploy state - pre-fill default checklist items for inline editing
+echo_yellow "Edit deploy state checklist (arrow keys to edit, clear a line to remove it, empty line to finish):"
 DEPLOY_ITEMS=()
-for default_item in "* [ ] Merge Dev" "* [ ] Merge Production"; do
+for default_item in "* [ ] Deployed to Dev" "* [ ] Deployed to Production"; do
     read -e -i "$default_item" -r line
     [ -n "$line" ] && DEPLOY_ITEMS+=("$line")
 done
-echo_yellow "Add more items (empty line to finish):"
+echo_yellow "Add more state items (empty line to finish):"
 while IFS= read -r line; do
     [ -z "$line" ] && break
     DEPLOY_ITEMS+=("$line")
 done
 DEPLOY_STATE=$(printf '%s\n' "${DEPLOY_ITEMS[@]}")
 
+# Prompt for deployment steps (checklist, optional)
+DEPLOY_STEPS_ITEMS=()
+echo_yellow "Enter deployment steps (arrow keys to edit, empty line to finish, leave blank to skip):"
+while IFS= read -r line; do
+    [ -z "$line" ] && break
+    # Auto-prefix with checkbox if not already
+    [[ "$line" == "* [ ]"* ]] || line="* [ ] $line"
+    DEPLOY_STEPS_ITEMS+=("$line")
+done
+if [ ${#DEPLOY_STEPS_ITEMS[@]} -eq 0 ]; then
+    DEPLOY_STEPS="_no manual steps required/provided_"
+else
+    DEPLOY_STEPS=$(printf '%s\n' "${DEPLOY_STEPS_ITEMS[@]}")
+fi
+
 # Prompt for test notes (multiline, optional)
 TEST_NOTES=""
 echo_yellow "Enter test notes/plan (empty line to finish, leave blank to skip):"
@@ -181,23 +196,29 @@ else
 fi
 
 # Build new section to append
-NEW_SECTION="## Deployment Notes ($(date +%Y-%m-%d))
-
-**MR: ${MR_LINK}**
+NEW_SECTION="## Deployment notes
 
-#### Branch
-
-\`\`\`
-${branch_name}
-\`\`\`
+- Date: $(date +%Y-%m-%d)
+- MR: ${MR_LINK}
+- Branch: \`${branch_name}\`
 
 #### State
 
 ${DEPLOY_STATE}
 
-#### Test / Code Review Notes
+#### Testing
 
-${TEST_NOTES}"
+${TEST_NOTES}
+
+#### Deployment steps
+
+${DEPLOY_STEPS}
+
+#### Approval
+
+* [ ] Code Review and approved
+* [ ] Internal QA successful
+* [ ] Client acceptance (or N/A)"
 
 # Combine existing and new
 FULL_DESCRIPTION="${EXISTING_DESC}${NEW_SECTION}"