feat: improve CLI UX with enhanced post-scaffold guidance and clearer prompts

[carlevison]

Summary

Improves the CLI user experience by addressing feedback from DOC-10676, DOC-10677, and DOC-10679. The changes make the CLI more helpful and guide users through next steps with clearer messaging and actionable prompts.

Changes Made

DOC-10676: Post-scaffold next-steps checklist

• Added comprehensive post-setup guidance with visual separators (━━━)
• Included clear numbered steps for what to do after scaffolding completes
• Added actionable example AI prompts users can try:
  • "Add an image gallery with transformations"
  • "Add a video player component"
  • "Implement image optimization"
• Different messaging based on whether dev server starts automatically or needs manual start

DOC-10677: Upload preset setup clarity

• Added clear explanation: "An unsigned upload preset allows users to upload files directly from your app."
• Added explicit instruction: "(Set signing mode to 'Unsigned' when creating)"
• Removed confusing line about transformations vs uploads
• Removed redundant "Transformations will work with sample images" message

DOC-10679: AI context files explanation

• Enhanced section title: "AI assistant configuration files created"
• Added explanation of what the files do
• Added "💡 How to use these files" section with practical guidance
• Proper singular/plural handling based on actual file count (not just tool count)

Additional Improvements

• Made "What you can do" bullets more action-oriented and aligned with documentation
• Changed from generic advice to specific actions like "see the Cloudinary features being used"
• Updated example prompts to showcase more varied Cloudinary features
• Improved grammar to correctly handle singular/plural for file counts

Testing

• ✅ Syntax validated
• ✅ Tested with various AI tool combinations (single/multiple)
• ✅ Tested with/without upload preset
• ✅ Tested with/without automatic dep installation
• ✅ Verified all messaging displays correctly

Screenshots

All three tickets have been addressed with improved messaging that guides users through setup and helps them get started quickly with actionable next steps.

Made with Cursor