docs(cmd/r): update for new s instructions, polish

Amolith and Crush created

Co-authored-by: Crush <crush@charm.land>

Change summary

cmd/r.go | 16 ++++++++++------
1 file changed, 10 insertions(+), 6 deletions(-)

Detailed changes

cmd/r.go 🔗

@@ -41,13 +41,17 @@ func runResume(cmd *cobra.Command, args []string) error {
 
 	// Print instructions for resuming work
 	_, _ = fmt.Fprintln(cmd.OutOrStdout(), strings.Repeat("-", 80))
-	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "\nResuming session. To continue:")
-	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "1. Check the goal description above for any bug/issue/ticket ID. If present, read that ticket for full context.")
-	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "2. Read the files and symbols referenced in the pending tasks to understand what work remains.")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "Resuming session. To continue:")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "1. Thoroughly consider the goal and its description.")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "2. Read the referenced files and symbols, especially in the pending tasks, to understand what work remains.")
 	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "3. Add more tasks if needed. For multi-line descriptions, use literal newlines:")
-	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "     Single: `np t a -t \"task title\" -d \"details\"`")
-	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "     Batch:  np t a -t \"first\" -d \"step 1 details\" -t \"second\" -d \"step 2 with")
-	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "     \nmore details\" -t \"third\" -d \"step three\"`")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "       # Single")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "       np t a -t \"task title\" -d \"details\"")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "       # Batch (preferred for multiple additions)")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "       np t a -t \"first\" -d \"step 1 details\" -t \"second\" -d \"step 2 with")
+	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "       more details\" -t \"third\" -d \"step three\"`")
 	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "4. Update task status as you work:")
 	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "     Single: `np t u -i <task-id> -s <status>`")
 	_, _ = fmt.Fprintln(cmd.OutOrStdout(), "     Batch:  `np t u -i <id1> -s <status1> -i <id2> -s <status2>`")