πŸ“– User Guide

Master PostFlow-AI: From basic settings to advanced optimization techniques

πŸ“‘ Table of Contents

1. Basic Settings Guide

Each setting in PostFlow-AI serves a specific purpose. Understanding what to enterβ€”and whyβ€”will dramatically improve your output quality.

πŸ’‘ Not sure what to write?

Try this: Give ChatGPT or Claude a brief self-introduction including your business, goals, target audience, and strengths. Then ask it to help you fill out each field.

Example prompt:

I'm a [your profession] who helps [target audience] achieve [their goals]. My strengths are [your strengths] and my business offers [your services/products].

Based on this, help me write the following for my social media automation tool:
- Brand Name
- Persona (who is speaking)
- Target Audience
- Value Proposition
- Writing Style/Tone

This can save you hours and give you a solid starting point to refine.

Output Language

Select the language that matches your target audience. This determines the language of all generated content.

Brand Name

Enter your business or brand name. You can include both formal and informal versions.

πŸ’‘ Tip

Example: "Apex Coaching" β€” Use a name that's recognizable to your audience.

Persona Name

Define who is "speaking" in your posts. Include your role and expertise.

Good Example Why It Works
Business strategist and productivity coach who helps entrepreneurs build sustainable businesses without burnout Establishes expertise and perspective
Fitness coach with 10 years of experience Builds credibility

Target Audience

Describe who you're writing for. Focus on interests and needs rather than demographics.

πŸ’‘ Example

"Solo entrepreneurs and small business owners who want to scale their online business while maintaining work-life balance"

⚠️ Caution

Avoid overly narrow geographic targeting (e.g., "people in Tokyo") if you serve customers nationwide or globally. This limits your reach.

Value Proposition

What makes you unique? Focus on benefits that matter to your audience.

πŸ’‘ Example

"Grow your business without sacrificing your well-being. I help solo entrepreneurs build profitable, sustainable businesses using proven systems β€” so you can work smarter, not harder."

Voice

Describe your writing tone. Leave blank if using Style Sample (they can conflict).

Voice Description Result
Warm, encouraging, and practical β€” like advice from a trusted mentor Friendly expert tone
Professional, concise, data-driven Business-focused tone

Style Sample

Paste 1-3 examples of your best writing. AI will learn your unique voice from these samples.

🚫 Avoid Including
  • Time-sensitive announcements (holiday specials, limited offers)
  • Specific dates or prices
  • Poetic or overly flowery titles
  • Business hours or administrative notices
βœ… Good to Include
  • Posts about your daily work or passion
  • Customer appreciation posts
  • Posts showing your expertise or philosophy

Character limit: 4,000 characters

CTA (Call to Action)

What action do you want readers to take? Keep it natural and non-pushy.

Example: "Order from our online shop" or "Book your consultation today"

CTA Frequency

Setting When to Use
1.0 (every post) Direct sales focus, e-commerce
0.5 (half of posts) Balanced approach
0.2-0.3 Brand building, awareness focus

Reference URL

The URL where you want to direct readers. Usually your website, shop, or booking page.

2. Topics & Content Angles

What Are Topics?

Topics are the main themes you want to post about. Design them based on your business goals.

πŸ“ Example: Business Coaching

Goal: Attract coaching clients and build authority

Topic Purpose
Productivity tips for busy entrepreneurs Provide value, showcase expertise
Building authentic client relationships Build trust, demonstrate approach
Work-life balance strategies Connect with audience pain points

What Are Content Angles?

Angles are different perspectives on the same topic. They create variety in your content.

Format: Angle Name | keyword1, keyword2, keyword3

πŸ’‘ Example Angles for "Productivity tips"
Time Management | schedule, calendar, prioritize, focus
Mindset Shifts | perspective, habits, beliefs, growth
Systems & Tools | automation, workflow, apps, templates
Energy Management | rest, boundaries, sustainability

The keywords help AI understand what angle to take when writing. The same topic can produce very different posts depending on the angle.

3. Vector Store Best Practices

What Is Vector Store?

Vector Store is your knowledge base. AI searches it to find relevant facts and details when generating content. Think of it as AI's reference library about your business.

Common Mistake: One Store for Everything

🚫 What Went Wrong

User uploaded 30 past posts into one Vector Store and used it for all topics.

Result: AI created "kitchen sink" posts mixing unrelated products and ideas. Posts lacked focus and felt scattered.

Best Practice: Separate Stores by Category

βœ… Recommended Approach

Create separate Vector Stores for each topic or category:

  • "Productivity Content" β†’ connect to Productivity topic
  • "Client Relationship Tips" β†’ connect to Relationships topic
  • "Work-Life Balance" β†’ connect to Balance topic

How to Structure Your Data

AI works better with structured data than plain paragraphs.

❌ Avoid (plain text):

The Pomodoro Technique is great for busy entrepreneurs. 
You work for 25 minutes then take a 5 minute break. 
It helps with focus and prevents burnout...

βœ… Recommended (structured):

【Topic】
Time Management for Entrepreneurs

【Category】
Productivity / Focus Techniques

【Overview】
The Pomodoro Technique helps busy entrepreneurs maintain 
focus while preventing burnout through structured breaks.

【Key Points】
- Work in 25-minute focused blocks
- Take 5-minute breaks between sessions
- After 4 sessions, take a longer 15-30 minute break
- Track completed "pomodoros" to measure productivity

【Benefits】
- Reduces decision fatigue
- Creates natural stopping points
- Makes large projects feel manageable
- Builds sustainable work habits

【Best For】
Entrepreneurs who struggle with focus or feel overwhelmed

【Related URL】
https://apexcoaching.example.com/productivity

Adding Reference Post Examples

Adding a "Reference Post" section helps AI understand your ideal output style.

【Reference Post Example】
"Here's a game-changer for your productivity: stop trying to 
work for hours straight. Your brain wasn't designed for that. 
Try this instead..."

This teaches AI the casual, warm tone you wantβ€”something that's hard to convey through structure alone.

πŸ’‘ Save time: Let AI structure your data

Manually converting dozens of plain text entries into structured format is tedious. Use ChatGPT or Claude to do it for you!

Example prompt:

Convert the following text into a structured format for a Vector Store. Use these sections:
- 【Topic】
- 【Category】
- 【Overview】
- 【Key Points】(as bullet points)
- 【Benefits】(as bullet points)
- 【Best For】
- 【Reference Post Example】(write a casual, engaging example based on the content)

Here's the text:
[Paste your plain text here]

You can process multiple entries at once by pasting several texts and asking AI to structure them all.

Style Sample vs. Vector Store

Element Purpose What to Include
Style Sample Teaches HOW to write Past posts showing your voice and tone
Vector Store Provides WHAT to write about Facts, product details, features

4. The Feedback Loop

"It's Not Perfect" Is Normal

When you first use PostFlow-AI, the output might not match your expectations. This is completely normal.

PostFlow-AI improves as you teach it. The more good examples you provide, the better it gets. Think of it as training an assistant who gets smarter every day.

How the Feedback Loop Works

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ β”‚ β”‚ β‘  AI generates content β”‚ β”‚ ↓ β”‚ β”‚ β‘‘ You edit and improve it β”‚ β”‚ ↓ β”‚ β”‚ β‘’ Add the improved version to Vector Store β”‚ β”‚ ↓ β”‚ β”‚ β‘£ AI uses your good examples as reference β”‚ β”‚ ↓ β”‚ β”‚ β‘€ Next output is higher quality β”‚ β”‚ ↓ β”‚ β”‚ Back to β‘  (quality improves each cycle) β”‚ β”‚ β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

Step-by-Step Process

Step 1: Generate First Draft

Start with minimal settings and generate a post. Accept that it might only be "60% there."

Step 2: Edit the Output

Look For Action
Unnatural phrasing Rewrite in your voice
Missing information Add what's needed
Unnecessary content Remove it
Wrong tone Adjust to match your style

Step 3: Save Good Examples to Vector Store

When you create something you're proud of, add it to Vector Store:

  1. Go to Training Data tab
  2. Create new entry via Manual Entry
  3. Format it with clear labels (Topic, Angle, Example Post)
  4. Save and merge with existing Vector Store

Step 4: Generate Again and Compare

After adding good examples, generate new content with the same settings. You should notice improvements in structure, tone, and relevance.

14-Day Trial Roadmap

Days Focus Goal
1-3 Complete basic settings, create minimal Vector Store Get it running
4-7 Generate many posts (use short intervals in Basic Settings), edit and save the best ones to Vector Store Build a solid library of good examples
8-11 Add more angles, refine Style Sample Increase variety
12-14 Production testing, final adjustments Ready for daily use

By Day 7, you should notice significant improvement in output quality.

Before & After Example

Before (first attempt):

"Productivity is important for entrepreneurs. You should manage your time well. Visit my website for more tips."

β†’ Generic, could be anyone's post

After (with feedback loop):

"Stop Deciding the Same Thing Twice: Your One-Page System for Reclaiming Time. Busy entrepreneurs don't need more willpowerβ€”they need fewer decisions. Every time you ask 'How long should this meeting be?' or 'When should I check email?'β€”that's a decision draining your energy. Here's what changed everything for me..."

β†’ Specific, personal, compelling

The difference comes from:

5. Troubleshooting

Posts Mix Too Many Topics

Symptom: Generated posts mention multiple unrelated products or ideas.

Solution
  • Split Vector Store by category
  • Ensure each entry focuses on ONE thing
  • Connect specific Vector Stores to specific topics

Writing Style Doesn't Match

Symptom: Output tone differs from your actual voice.

Solution
  • Check Style Sample length (should be substantial)
  • Remove time-sensitive content from Style Sample
  • Leave Voice field empty if using Style Sample
  • Remove poetic or unusual phrases that AI might mimic

Output Is Too Flowery or Dramatic

Symptom: Posts use grandiose language you'd never use.

Solution
  • Remove poetic titles from Style Sample
  • Add more matter-of-fact examples
  • Include "Reference Post Examples" in Vector Store data

API Error: 529 Overloaded

Symptom: Generation fails with server overload message.

Solution
  • Wait 5-10 minutes and try again
  • Avoid peak hours (US daytime = Asia late night)
  • Scheduler will automatically retry on next cycle

Posts Suddenly Stop Generating

Symptom: Everything was working fine, but now posts fail to generate.

Possible Cause: API Credit Limit Reached
  • Check your OpenAI credits at platform.openai.com
  • Check your Anthropic credits at console.anthropic.com
  • Go to Plans & Billing β†’ Add credits if needed
  • Note: Claude.ai (chat) and Anthropic API Console are separate services with separate billing

Checking Debug Logs

For advanced troubleshooting, check the data/ folder:

File Contents
data/scheduler.log Scheduler activity and error messages
data/debug/gpt5_drafts_*.txt Initial drafts generated by GPT-5
data/debug/claude_rewritten_*.txt Rewritten versions by Claude

These help identify where unwanted expressions enter the pipeline.

πŸ“§ Contacting Support?

When reaching out to support@postflow-ai.app, please attach your scheduler.log file. This helps us identify the issue much faster.

6. How to Update

When a new version of PostFlow-AI is released:

  1. Download the new version
  2. Stop PostFlow-AI β€” close the console window (the black window that opens when you run the app)
  3. Replace the following files and folders:
    • PostFlow-AI.exe
    • PostFlow-AI-Scheduler.exe
    • _internal/ folder
  4. Restart PostFlow-AI
βœ… Your Data Is Safe

The following are NOT replaced during updates and will be preserved:

  • config/ β€” Your settings
  • data/ β€” Your content and Vector Stores
  • .env β€” Your API keys
⚠️ Important

Do NOT delete the config/ or data/ folders during updates. This would erase all your settings and training data.

Ready to get started?

πŸ“˜ Quick Start Guide 🏠 Back to Home