26 KiB
IGNY8 UX Improvement Instructions for Claude Sonnet 4.5 Overview This document contains detailed instructions for improving text clarity, labels, and user-friendliness across all pages of the IGNY8 application. The changes focus on making the interface more intuitive for non-technical users by simplifying language, adding helpful explanations, and clarifying feature purposes.
- DASHBOARD PAGE Current Issues:
"Your Progress" section title is vague "Overall Completion" metric needs context about what it measures Icon labels are too formal/technical
Instructions for Improvement: Section A: Header Area
Change "Dashboard" heading to add a short welcome: "Your Content Creation Dashboard" Change "Last updated" label to: "Last checked: [timestamp]" (more conversational) Add tooltip to "Refresh" button: "Click to get the latest updates on your content creation progress"
Section B: Main Banner
Keep "AI-Powered Content Creation Workflow" but add subtitle explanation below current text:
Add: "Your complete toolkit for finding topics, creating content, and publishing it to your site - all automated"
Change "2/5 Sites" to "2 of 5 Sites Active" (clearer fraction meaning)
Section C: Your Progress Card
Change "Your Progress" to "Your Content Journey" (more relatable) Change "Track your content creation workflow completion" to:
"See how far you've come in creating and publishing content"
Add a progress explanation right above the bar:
"Overall Completion: 83% - You're making great progress!" Add micro-explanation: "(This shows your progress from keywords through to published content)"
Section D: Metric Cards (Site & Sectors, Keywords, Clusters, Ideas, Content, Published)
For each card, keep the main number but enhance the description:
Site & Sectors: Change "Industry & sectors configured" to "Niches you're targeting - Industry & sectors set up" Keywords: Change "Keywords added from opportunities" to "Search terms to target - Keywords added from research" Clusters: Change "Keywords grouped into clusters" to "Topic groups - Keywords organized by theme" Ideas: Change "Content ideas and outlines" to "Article outlines ready - Ideas and outlines created" Content: Change "Content pieces + images created" to "Articles created - Written content + images ready" Published: Change "Content published to site" to "Live on your site - Articles published and active"
Section E: Bottom Cards (Quick Actions area)
Make titles more action-oriented and clear:
"Keyword Research" → "Find Keywords to Rank For" + add: "Search for topics your audience wants to read about" "Clustering & Ideas" → "Organize Topics & Create Outlines" + add: "Group keywords and create article plans" "Content Generation" → "Write Articles with AI" + add: "Generate full articles ready to publish" "Internal Linking" → "Connect Your Articles" + add: "Automatically link related articles for better SEO" "Content Optimization" → "Make Articles Better" + add: "Improve readability, keywords, and search rankings" "Image Generation" → "Create Article Images" + add: "Generate custom images for your content" "Automation" → "Run Everything Automatically" + add: "Set up schedules to create and publish content on its own" "Prompts" → "Customize Your AI Writer" + add: "Create custom instructions for how AI writes your content"
- ADD KEYWORDS PAGE Current Issues:
"Select a Sector to Add Keywords" instruction is confusing Column headers use technical jargon Status like "Added" needs context
Instructions for Improvement: Section A: Page Header
Change title to: "Find & Add Keywords to Target" Change description "Select a sector from the dropdown above to enable adding keywords..." to:
"Pick a topic area first, then add keywords - You need to choose what you're writing about before adding search terms to target"
Section B: Sector Selector
Change label "Sector: All Sectors" to: "What topic area? - All Sectors" Add helpful text below: "Select a niche or topic - This tells our AI what type of content you create"
Section C: Table Headers
"KEYWORD" → "Search Term" (what people actually search for) "SECTOR" → "Topic Area" (the category) "VOLUME" → "How Often Searched" (what this metric means) "DIFFICULTY" → "Competition Level" (easier to understand than "difficulty") "COUNTRY" → "Target Location" (clearer purpose) "STATUS" column: Add tooltip explaining "Added" means "Selected for your content plan"
Section D: Show Filters Button
Keep button but add tooltip: "Click to filter keywords by search volume, difficulty, or other details"
Section E: Bulk Actions
Change "Bulk Actions" label to: "Do Multiple at Once" with tooltip: "Select keywords and perform actions on all of them together"
- SITES MANAGEMENT PAGE Current Issues:
Page layout is good but labels could be clearer "Dashboard" and "Content" buttons' purposes aren't obvious
Instructions for Improvement: Section A: Page Header
Change "Sites Management" to: "Your Websites" Change description to: "Manage all your websites here - Add new sites, configure settings, and track content for each one"
Section B: Add Site Button
Change "Add Site" to: "+ Add Another Website" Add tooltip: "Connect a new WordPress or Shopify site to create content for it"
Section C: Filter Dropdowns
"All Types" → "Show All Types" "All Hosting" → "Show All Hosting" "All Status" → "Show All Status" Add micro-helper text: "Filter by site type, hosting provider, or active status"
Section D: Site Cards
Keep the site card design but clarify buttons:
"Dashboard" → "View Site Dashboard" with tooltip: "See overview and statistics for this site" "Content" → "Manage Content" with tooltip: "Add, edit, or view all articles for this site" "Settings" → "Configure Site" with tooltip: "Update connection details and publishing settings"
Section E: Active/Inactive Status
Add explanation near toggle: "Active sites can receive new content. Inactive sites are paused."
- THINKER (AI PROMPTS MANAGEMENT) PAGE Current Issues:
"Thinker" is an abstract/unclear name for this feature "Prompts" is jargon-heavy for non-technical users Tabs could have better explanations
Instructions for Improvement: Section A: Page Header
Change "AI Prompts Management" to: "Customize Your AI Writer" Change description "Configure AI prompt templates..." to:
"Tell our AI how you want it to write - Create custom instructions and templates for different types of content"
Section B: Tab Labels
"Prompts" → "Writing Styles" (easier to understand) "Author Profiles" → "Writing Voices" (clearer) "Strategies" → "Content Strategies" (more descriptive) "Image Testing" → "Test Image Settings" (clearer action)
Section C: Prompts Sub-Sections
"Planner Prompts" → "AI Instructions for Planning"
Add explanation: "These instructions tell our AI how to organize your keywords into topics and create outlines"
"Clustering Prompt" → "How to Organize Keywords"
Add description: "This tells our AI how to group related keywords into topic clusters"
"Ideas Generation Prompt" → "How to Create Article Outlines"
Add description: "This tells our AI how to generate article ideas and outlines for each topic cluster"
"Writer Prompts" section → "AI Instructions for Writing"
Add explanation: "These control how our AI writes your full articles"
Section D: Prompt Editor Buttons
"Reset to Default" → "Restore Original" "Save Prompt" → "Save My Custom Instructions"
- PLANNER PAGE (Keywords View) Current Issues:
"Pipeline readiness at 22%" is confusing without context Column headers are technical Warning messages use jargon
Instructions for Improvement: Section A: Page Header
Change title to: "Organize Your Keywords" Change description to: "Group keywords into topic clusters and plan your content - Get keywords ready to write about"
Section B: Status Alerts
Current: "Pipeline readiness at 22% - Most keywords need clustering..." Change to: "You're 22% ready to start writing - Next step: Group your keywords by topic (36 keywords are ready to organize)"
Section C: Top Statistics
Display bar shows: KEYWORDS, CLUSTERS, UNMAPPED, VOLUME Change "UNMAPPED" to "READY TO ORGANIZE" (clearer) Add tooltip to each stat explaining what it means
Section D: Bulk Actions Button
Change to: "Do Multiple at Once" Add tooltip: "Select keywords and apply actions to all of them together"
Section E: Table Headers
"KEYWORD" → "Search Term" "SECTOR" → "Topic Area" "VOLUME" → "Monthly Searches" (clearer) "CLUSTER" → "Grouped Under" or "Topic Group" "DIFFICULTY" → "Competition Level" "COUNTRY" → "Target Country" "STATUS" → "Prep Status" "CREATED" → "Date Added"
Section F: Import Button
Change label to: "+ Import More Keywords"
- PLANNER PAGE (Clusters View) Current Issues:
"Clusters" is abstract for non-technical users Navigation between Keywords and Clusters tabs needs better clarity
Instructions for Improvement: Section A: Tab Area
"Keywords" tab → keep but add small label: "Keywords (individual terms)" "Clusters" tab → change to "Topics (keyword groups)" Add short explanation at top: "See your keyword groups - Clusters are groups of related keywords organized by topic"
Section B: Cluster Items
Display of clusters should include a clear purpose statement Add count of keywords in each cluster with explanation: "5 keywords in this group" (instead of just "5")
- WRITER PAGE (Content Queue) Current Issues:
"Content Queue" is vague Tab names don't clearly indicate what content state they represent Status indicators like "Queued" need explanation
Instructions for Improvement: Section A: Page Header
Change title to: "Write Your Articles" Change description to: "Create and manage all your article content - Write, review, and publish articles one by one or all at once"
Section B: Status Alerts
Current: "1 tasks in queue - Content generation pipeline is active..." Change to: "You have 1 article waiting to be written - Our AI is ready to create it. High completion rate (82%) - 9 pieces of content are ready to review"
Section C: Tab Names
"Queue" → "Ready to Write" (clearer - these are articles waiting) "Drafts" → "Finished Drafts" (clearer - these are completed) "Images" → "Article Images" (more specific) "Review" → "Review Before Publishing" (clearer action)
Section D: Bulk Actions
Change to: "Do Multiple at Once"
Section E: Table Headers & Status
"TITLE" → "Article Title" "SECTOR" → "Topic Area" "CLUSTER" → "Topic Group" "TYPE" → "Content Type" (Post, Page, etc.) "STRUCTURE" → "Article Format" "STATUS" → "Current State" "WORD COUNT" → "Word Count" Change status labels:
"Completed" → "Done - Ready to Review" "Queued" → "Waiting to be Written" "Failed" → "Error - Needs Help"
Section F: Content Type Examples
Add explanation popup for content types:
"Post" = "Blog article (standard format)" "Page" = "Standalone page (no categories)" "Guide" = "Comprehensive how-to guide" "Tutorial" = "Step-by-step instructional content"
- AUTOMATION PAGE (AI Automation Pipeline) Current Issues:
Visual pipeline is good but stage names are vague "Ready to Run" status and 34 items isn't clear about what they are Stage descriptions are too technical
Instructions for Improvement: Section A: Page Header
Change title to: "Automate Everything" Change description to: "Set your content on automatic - Let our AI create and publish content on a schedule"
Section B: Status Badge
"Ready to Run - 34 items in pipeline" → "Ready to Go! 34 items waiting - Everything is queued up and ready for the next run"
Section C: Schedule Display
Current: "Daily at 02:00:00 | Last: Never | Est: 5 credits" Change to: "Runs every day at 2:00 AM | Last run: Never | Uses about 5 credits per run"
Section D: Pipeline Statistics
Add explanatory text above stats:
"Here's what's in your automation pipeline:"
Keep numbers but change labels:
"Keywords 46" → "46 Search Terms (waiting to organize)" "Clusters 4" → "4 Topic Groups (ready for ideas)" "Ideas 16" → "16 Article Ideas (waiting to write)" "Content 10" → "10 Articles (in various stages)" "Images 10" → "10 Images (created and waiting)"
Section E: Stage Names & Explanations Replace technical names with clear actions + explanations:
Stage 1: Keywords → Clusters
Change to: "ORGANIZE KEYWORDS" Description: "Group related search terms into topic clusters"
Stage 2: Clusters → Ideas
Change to: "CREATE ARTICLE IDEAS" Description: "Generate article titles and outlines for each cluster"
Stage 3: Ideas → Tasks
Change to: "PREPARE WRITING JOBS" Description: "Convert ideas into tasks for the AI writer"
Stage 4: Tasks → Content
Change to: "WRITE ARTICLES" Description: "AI generates full, complete articles"
Stage 5: Content → Image Prompts
Change to: "CREATE IMAGE DESCRIPTIONS" Description: "Generate descriptions for AI to create images"
Stage 6: Image Prompts → Images
Change to: "GENERATE IMAGES" Description: "AI creates custom images for your articles"
Stage 7: Manual Review Gate + Publishing
Change to: "REVIEW & PUBLISH ⚠️" Description: "Review 3 articles before they go live" (manual approval needed)
Final: Published
Change to: "LIVE ON YOUR SITE" Description: "Articles are now published and visible"
Section F: Configuration Button
Change "Configure" to: "⚙️ Adjust Settings" Add tooltip: "Change when this automation runs and how many credits it uses"
Section G: Run Now Button
Keep "Run Now" but add tooltip: "Start the automation immediately instead of waiting for the scheduled time"
- ACCOUNT SETTINGS PAGE Current Issues:
Labels are formal/corporate Sections could use more context Billing-related fields aren't clear about their purpose
Instructions for Improvement: Section A: Page Header
Change title to: "Your Account Info" Change description to: "Keep your information updated - Your account name, email, and billing address"
Section B: Account Information Section
Change section title to: "Basic Account Details" "Account Name" → "Your Account Name" + helper: "This is how you'll see your account (for you only)" "Account Slug" → "Account URL Name" + helper: "Used in web addresses (usually matches your company name)" "Billing Email" → "Email for Receipts" + helper: "Where invoices and billing updates will be sent"
Section C: Billing Address Section
Change to: "Where to Send Invoices" Add intro text: "Tell us your official business address for billing" "Address Line 1" → "Street Address" "Address Line 2" → "Apartment, Suite, etc. (optional)" "City" → "City" "State/Province" → "State or Province" "Postal Code" → "ZIP or Postal Code" "Country" → "Country"
- TEAM MANAGEMENT PAGE Current Issues:
"Users" vs "Invitations" tabs are okay but could be clearer "Access Control" is abstract
Instructions for Improvement: Section A: Page Header
Change title to: "Your Team" Change description to: "Manage who can access your account - Add team members and control what they can do"
Section B: Tab Navigation
"Users" → "Team Members (Active)" "Invitations" → "Pending Invites (Waiting to Join)" "Access Control" → "Permissions (What they can do)"
Section C: Users Tab Content
"Name" column → "Member Name" "Email" column → "Email Address" "Status" column → "Account Status" (with "Active" explanation) "Role" column → "Permission Level" "Joined" column → "Date Joined" "Last Login" column → "Last Active" "Actions" column → keep but add tooltip: "Remove this person's access"
Section D: Invite Button
Change "Invite Team Member" to: "+ Invite Someone" Add tooltip: "Send an invitation to someone to join your team"
Section E: Permission Levels (in Access Control)
Explain each role simply:
"Admin" = "Full access to everything" "Member" = "Can create and edit content" "Viewer" = "Can only view reports"
- PLANS & BILLING PAGE Current Issues:
"Growth" plan name is vague Feature limits and metrics need context Tab purposes could be clearer
Instructions for Improvement: Section A: Page Header
Change title to: "Your Subscription" Change description to: "Manage your plan and payments - View what's included, upgrade, or buy more credits"
Section B: Current Plan Section
Change "Your Current Plan" to: "What You're Using Now" "Growth" → "Growth Plan (Our most popular)" Change "Select a plan to unlock full access" to: "Want more? Upgrade your plan for more content limits and features"
Section C: Plan Features Card
"Included Features" → "What's in Your Plan" List items with context:
"5 Sites" → "5 Websites - You can manage up to 5 websites" "1000 Keywords" → "1,000 Keywords - You can track up to 1,000 search terms per month" "3000 Credits" → "3,000 Credits - Credits are used to run automation and create content" "300K Words" → "300,000 Words - About how much content you can generate per month" "200 Clusters" → "200 Topic Groups - You can organize keywords into up to 200 clusters" "900 Images" → "900 Images - AI can generate up to 900 images per month"
Section D: Tab Names
"Current Plan" → keep (it's clear) "Plan Limits" → "Your Limits (What you can do)" "Credits" → "Credits & Balance (How much you have left)" "Purchase/Upgrade" → "Buy More (Get more credits or upgrade)" "History" → "Billing History (Past invoices and charges)"
Section E: Buttons
"Purchase Credits" → "+ Buy More Credits" + tooltip: "Add credits to your account for more content generation" "View Limits" → "See Your Limits" + tooltip: "Check how much of each feature you're using"
- USAGE & ANALYTICS PAGE Current Issues:
Statistics are presented but lack context "Usage %" without explanation of what 39% means Section titles are vague
Instructions for Improvement: Section A: Page Header
Change title to: "Your Usage" Change description to: "See how much you're using - Track your credits, content limits, and API activity"
Section B: Stats Cards at Top
"Current Balance 835" → "Credits Left: 835" + explanation: "You have 835 credits available" "Used This Month 1,165" → "Credits Used This Month: 1,165" + explanation: "How many credits you've spent so far" "Monthly Allocation 3,000" → "Your Monthly Limit: 3,000" + explanation: "Total credits you get each month" "Usage % 39%" → "39% Used" + explanation: "You've used 39% of your monthly credits. You have 61% left"
Section C: Tab Names
"Plan Limits & Usage" → "Your Limits & Usage (What you're using)" "Credit Activity" → "Credit History (Where credits go)" "API Usage" → "API Activity (Technical requests)"
Section D: Account Limits Section
Change title to: "Your Account Limits" Add intro: "Here's how much of each feature you're using:" Display each limit as a category card:
"Sites" → "Websites: 2 of 5 Used" with explanation: "You're using 40% of your site limit" "Team Users" → "Team Members: 2 of 3 Used" with explanation: "You can add 1 more person" "Keywords" → "Search Terms: 46 of 1,000 Used" with explanation: "You're using 5% of your keyword limit" "Clusters" → "Topic Groups: 4 of 200 Used" with explanation: "Plenty of room for more topics"
Section E: Monthly Usage Limits
Change title to: "What You Can Create This Month" Add intro: "These reset on the 1st of each month:"
"Content Ideas" → "Article Ideas: 105 of 900 Used" (chart showing usage) "Content Words" → "Article Words: 41,377 of 300,000 Used" (chart showing usage) "Basic Images" → "AI Images: 81 of 900 Used" (chart showing usage)
- PROFILE SETTINGS PAGE Current Issues:
"Personal Information" is clear but could be more friendly Language/timezone settings are important but buried
Instructions for Improvement: Section A: Page Header
Change title to: "Your Profile" Change description to: "Update your personal settings - Your name, preferences, and notification choices"
Section B: Personal Information Section
Change section title to: "About You" "First Name" → "First Name" "Last Name" → "Last Name" "Email" → "Email Address" "Phone" → "Phone Number (optional)"
Section C: Preferences Section
Change to: "How You Like It" "Timezone" → "Your Timezone" + explanation: "We use this to show you times that match your location" "Language" → "Language" + explanation: "The language we'll use to talk to you"
Section D: Notifications Section
Change to: "What You Want to Hear About" Add intro: "Choose what emails you want to receive:" "Email Notifications" → "Important Updates" + explanation: "Get notified about important changes to your account" "Marketing Emails" → "Tips & Product Updates (optional)" + explanation: "Hear about new features and content tips"
Section E: Save Button
Change "Save Changes" to: "✓ Save My Settings"
- PUBLISHING SETTINGS PAGE Current Issues:
"Default Publishing Destinations" is clear but could use more context "Auto-Sync" is technical jargon
Instructions for Improvement: Section A: Page Header
Change title to: "Where to Publish" Change description to: "Set up automatic publishing - Tell us where your content should go"
Section B: Default Publishing Destinations
Change title to: "Where Should Articles Go?" Change description to: "Choose which platforms get your articles - You can pick multiple" Add explanation: "When you publish an article, it will go to all the platforms you check here" Checkboxes:
"IGNY8 Sites" → "Publish to My Sites (using IGNY8)" "WordPress" → "Publish to WordPress (your self-hosted WordPress site)" "Shopify" → "Publish to Shopify (your Shopify store)"
Section C: Auto-Publish Settings
Change title to: "Automatic Publishing" Change description to: "Publish articles without asking me" Add checkbox label: "Automatically publish articles when they're finished and reviewed" Add explanation: "When you turn this on, articles will publish to your site right away. You can still review them first if you want"
Section D: Auto-Sync Settings
Change title to: "Keep Everything Updated" Change description to: "Automatically sync articles between platforms" Add checkbox label: "Automatically update articles on all my platforms if I make changes" Add explanation: "When you edit an article, this updates it everywhere - on your site, WordPress, etc."
Section E: Publishing Rules
Change title to: "Advanced Publishing Rules" Change description to: "Set specific rules for different types of content" Add button: "+ Add a Publishing Rule" Add explanation: "Example: Publish blog posts to WordPress but guides to your main site"
- IMPORT / EXPORT PAGE Current Issues:
Page says "Coming Soon" with vague description Users don't understand what this feature will do
Instructions for Improvement: Section A: Coming Soon Banner
Change title to: "Coming Soon: Manage Your Data" Change description from "Data management" to clearer explanation:
"Import and Export Your Content - Backup your keywords, articles, and settings. Move your content to other platforms. Download everything safely."
Add sub-points explaining what will be available:
"✓ Export your keywords as a file (backup or share)" "✓ Export all your articles in different formats" "✓ Import keywords from other sources" "✓ Backup and restore your entire account" "✓ Download your settings and configurations"
- HELP & DOCUMENTATION PAGE Current Issues:
Page is good but "Table of Contents" could be friendlier Some section titles use module names instead of plain English
Instructions for Improvement: Section A: Page Header
Keep "Help & Documentation" but improve description:
Change to: "Learn How to Use IGNY8 - Step-by-step guides and answers to common questions"
Section B: Table of Contents
Change "Table of Contents" to: "What Do You Want to Learn?" Reorganize and rename sections:
"Getting Started" → "I'm New - Help Me Get Started!"
Links: Quick Start Guide, Workflow Overview
"Planner Module" → "How to Organize Keywords"
Links: Keywords Management, Keyword Clusters, Content Ideas
"Writer Module" → "How to Write Content"
Links: Tasks Management, Content Generation, Image Generation
"Automation Setup" → "Set Up Automation"
Links: (same)
"Frequently Asked Questions" → "Common Questions Answered"
Section C: Quick Start Guide
Change introduction text:
Current: "Welcome to IGNY8! Follow these steps to get started with content creation:" New: "Let's Get You Creating Content! Follow these simple steps:"
Section D: Step Descriptions
"Set Up Your Site" → "Step 1: Connect Your Website"
Explanation: "Tell IGNY8 which website you want to create content for"
"Discover Keywords" → "Step 2: Find Search Terms to Target"
Explanation: "Search for keywords people are looking for in your topic area"
All other steps follow same pattern: Simple number, action, and plain-English explanation
Section E: Module Descriptions
"Planner Module" → "Organizing Phase" "Writer Module" → "Writing Phase" "Automation" → "Automatic Phase" Add descriptions in plain English for each
- SIDEBAR NAVIGATION Current Issues:
Section headers (SETUP, WORKFLOW, ACCOUNT, SETTINGS, HELP & DOCS) are okay but could be more intuitive Some menu items don't clearly indicate what they do
Instructions for Improvement: Section A: Section Headers
"SETUP" → "GET STARTED" (clearer that this is initial setup) "WORKFLOW" → "CREATE CONTENT" (clearer about the main activities) "ACCOUNT" → "MANAGE ACCOUNT" (clear) "SETTINGS" → "CONFIGURATION" (clearer than just "SETTINGS") "HELP & DOCS" → "HELP & LEARNING" (friendlier)
Section B: Menu Item Names
"Add Keywords" → "Find Keywords" (clearer action) "Thinker" → "AI Writer Setup" (explains what it is) "Planner" → "Organize Keywords" (explains the action) "Writer" → "Write Articles" (clearer) "Automation" → "Automate Everything" (clearer value)
Section C: Icons
Keep visual icons but add small text labels on hover explaining each one
Summary of Key Principles Applied:
Remove Jargon: Replace technical terms with everyday language Add Context: Explain WHY users need to do something, not just HOW Clarify Status: Explain what status badges and messages mean Use Friendly Tone: "Let's get started" instead of "Configure" Add Micro-Explanations: One-line helper text on key elements Action-Oriented Labels: "Write Articles" not "Writer Module" Number + Meaning: "39% Used - You have 61% left" not just "39%" Tooltip Helpers: Hover explanations for complex concepts Simple Descriptions: Use active voice and clear actions Progressive Disclosure: Hide advanced features but make them discoverable