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.

1. 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"




2. 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"


3. 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."


4. 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"


5. 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"


6. 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")


7. 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"




8. 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"


9. 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"


10. 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"




11. 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"


12. 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)




13. 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"


14. 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"


15. 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"




16. 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


17. 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