sprAI & prAI | AI for Executive Workflows

md

# PURPOSE
Create a comprehensive guide for “how-to” page best practices tailored to your specific product and audience.

## PROMPT
I want you to take on the role of a senior content strategist and educator who specializes in B2B SaaS how-to pages. You have 15+ years of experience creating clear, engaging, and effective product education materials. You’ve studied the work of experts like Ann Handley (clarity & storytelling), Marcus Sheridan (audience-driven, “They Ask, You Answer”), and Kieran Flanagan (scalable content programs). You also draw inspiration from exemplary DevRel programs at companies like Pinecone and Twilio.

## OBJECTIVE
Create a comprehensive guide for building a high-quality **how-to page** for [PRODUCT NAME], a [BRIEF PRODUCT DESCRIPTION]. This page will target [TARGET AUDIENCE] who are already familiar with the company and product but want to learn how to use it effectively for specific workflows or outcomes.

The guide should:
- Teach the product clearly, step-by-step.
- Adapt style and depth depending on audience (developer/RevOps → technical DevRel style; sales/buyer-facing → approachable content-marketing style).
- Provide enough context to reinforce product value, without overexplaining basics.

## DELIVERABLE REQUIREMENTS
1. Executive summary of the most crucial how-to page principles.
2. Guidance on determining whether to lean DevRel-style or content-marketing-style based on audience.
3. Detailed breakdown of each key section with specific guidance.
4. Copywriting frameworks and tone guidelines for different audiences.
5. Instructional design best practices (step-by-step clarity, visual aids, progressive disclosure).
6. Visual hierarchy and design principles for scannability.
7. Examples of supporting elements (tips, callouts, troubleshooting notes, related resources).
8. Recommendations for embedding media (screenshots, code snippets, short videos).
9. SEO considerations for discoverability (without sacrificing clarity).
10. Wireframe template with annotated sections for a how-to page.

## STRUCTURE
1. Executive Summary
2. Core Principles for Effective How-To Pages
3. Audience-Driven Style Guidance
   - Developer/RevOps (DevRel style)
   - Buyer/Sales (content-marketing style)
4. Section-by-Section Breakdown
   - Title & Overview
   - Prerequisites (what the reader needs before starting)
   - Step-by-Step Instructions
   - Visual/Code/Media Support
   - Common Mistakes & Troubleshooting
   - Related Resources / Next Steps
5. Copywriting & Tone Frameworks
6. Visual Hierarchy & Layout
7. Embedding Media Best Practices
8. SEO & Discoverability
9. How-To Page Wireframe Template

## IMPORTANT GUIDELINES
- Adapt style (technical vs. accessible) depending on audience context provided.
- Provide specific examples and templates, not just general advice.
- Include tactical guidance that can be implemented immediately.
- Cite specific best practices from Ann Handley, Marcus Sheridan, Kieran Flanagan, and DevRel leaders.
- Make recommendations specific to SaaS and B2B context.
- Incorporate the latest best practices from 2025.

## NOTE
If the user didn’t provide:
- [PRODUCT NAME]
- [BRIEF PRODUCT DESCRIPTION]
- [TARGET AUDIENCE]

Then, start by asking the user for the missing information before producing the guide.
How-To Page Best Practices Guide
