Default page

View File Name : VARIABLE_USAGE_ANALYSIS.txt

═══════════════════════════════════════════════════════════════════════════════
  VARIABLE USAGE ANALYSIS
  Which Variables Are Declared vs Used in Final Prompt
═══════════════════════════════════════════════════════════════════════════════

This analysis shows:
1. Variables DECLARED in config files but NOT USED in final prompt
2. Variables USED in final prompt but NOT DECLARED in config files
3. Variables DECLARED and USED correctly


FILES ANALYZED:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. prompts/system_prompt.txt (88 lines) - Main prompt template
2. prompts/image_prompt.txt (25 lines) - Image prompt guidelines  
3. prompts/prompt_variables.conf (85 lines) - Variable declarations


═══════════════════════════════════════════════════════════════════════════════
  SECTION 1: VARIABLES DECLARED BUT NOT USED IN FINAL PROMPT
═══════════════════════════════════════════════════════════════════════════════

These variables are declared in prompt_variables.conf but NOT used in 
system_prompt.txt (the main prompt that goes to AI):

┌─────────────────────────────────────────────────────────────────────────────┐
│ ⚠️  UNUSED VARIABLES                                                        │
└─────────────────────────────────────────────────────────────────────────────┘

1. AUTHOR_EXPERIENCE_YEARS
   ├─ Declared in: prompt_variables.conf (line 12)
   ├─ Value: "25"
   ├─ Used in: ❌ NOWHERE (not in system_prompt.txt)
   └─ Recommendation: Either use it in the prompt or remove it

2. COMPANY_DESCRIPTION
   ├─ Declared in: prompt_variables.conf (line 13)
   ├─ Value: "leading software development & IT Services Company..."
   ├─ Used in: ❌ NOWHERE (not in system_prompt.txt)
   └─ Recommendation: Either use it in the prompt or remove it

3. CONTENT_BLOCK_CLASSES
   ├─ Declared in: prompt_variables.conf (line 57)
   ├─ Value: "content-block image-left, content-block image-right, content-block text-only"
   ├─ Used in: ❌ NOWHERE (not in system_prompt.txt)
   ├─ Note: The actual class names are hard-coded in system_prompt.txt
   └─ Recommendation: Either use it in the prompt or remove it

4. IMAGE_QUALITY_SUFFIX
   ├─ Declared in: prompt_variables.conf (line 78)
   ├─ Value: "high resolution, highly detailed, professional grade"
   ├─ Used in: ❌ NOT in system_prompt.txt
   ├─ Used in: ✅ image_prompt.txt (lines 6-15, 21)
   └─ Note: Only used in image_prompt.txt, which is NOT directly sent to AI
           The image_prompt.txt is a reference file, not used in actual generation

5. IMAGE_PROMPTS_INSTRUCTION
   ├─ Declared in: prompt_variables.conf (line 84)
   ├─ Value: "You must generate exactly ${TOTAL_IMAGE_PROMPTS}..."
   ├─ Used in: ❌ NOWHERE
   ├─ Note: There's a DIFFERENT variable used in system_prompt.txt
   └─ Confusion: system_prompt.txt uses ${IMAGE_PLACEHOLDER_INSTRUCTIONS} (plural)
               but conf declares IMAGE_PROMPTS_INSTRUCTION (different name)


═══════════════════════════════════════════════════════════════════════════════
  SECTION 2: VARIABLES USED BUT NOT DECLARED IN CONFIG FILES
═══════════════════════════════════════════════════════════════════════════════

These variables are used in system_prompt.txt but NOT declared in 
prompt_variables.conf (they are dynamically generated by the script):

┌─────────────────────────────────────────────────────────────────────────────┐
│ ✅ DYNAMICALLY GENERATED VARIABLES (This is OK)                             │
└─────────────────────────────────────────────────────────────────────────────┘

1. IMAGE_PLACEHOLDER_INSTRUCTIONS (note: plural "INSTRUCTIONS")
   ├─ Used in: system_prompt.txt (line 24)
   ├─ Declared in: ❌ NOT in prompt_variables.conf
   ├─ Generated by: blog_generator.sh (lines 182-198)
   ├─ Generation logic:
   │   if content_total=0 → "NO IMAGE PLACEHOLDERS"
   │   if content_total=1 → "Use EXACTLY 1 image placeholder: {{IMAGE_PROMPT_1}}"
   │   if content_total=2 → "Use EXACTLY 2 image placeholders: {{IMAGE_PROMPT_1}} and {{IMAGE_PROMPT_2}}"
   └─ Status: ✅ CORRECT - Should be dynamically generated

2. TOTAL_IMAGE_PROMPTS
   ├─ Used in: system_prompt.txt (lines 62, 68, 72, 77, 88)
   ├─ Declared in: ❌ NOT in prompt_variables.conf
   ├─ Generated by: blog_generator.sh (lines 547-553)
   ├─ Calculation: 
   │   total = CONTENT_TOTAL + (IS_FEATURED ? 1 : 0) + 
   │           (IS_HERO ? 1 : 0) + (IS_SLIDER_POST ? 1 : 0) + SLIDER_TOTAL
   │   Example: 1 content + 1 featured = 2 total
   └─ Status: ✅ CORRECT - Should be dynamically calculated

3. IMAGE_PLACEHOLDERS_COUNT
   ├─ Used in: system_prompt.txt (lines 23, 26, 73, 81, 86)
   ├─ Declared in: ⚠️  YES in prompt_variables.conf (line 31) with value "1"
   ├─ BUT OVERRIDDEN by: blog_generator.sh (calculated from CONTENT_TOTAL)
   ├─ Value from conf: "1" (static)
   ├─ Value in script: Equals CONTENT_TOTAL (dynamic)
   └─ Status: ⚠️  CONFUSION - Declared statically but should be dynamic
              The script calculates it dynamically, so the conf value is ignored


═══════════════════════════════════════════════════════════════════════════════
  SECTION 3: VARIABLES CORRECTLY DECLARED AND USED
═══════════════════════════════════════════════════════════════════════════════

These variables are properly declared in prompt_variables.conf and used in 
system_prompt.txt:

┌─────────────────────────────────────────────────────────────────────────────┐
│ ✅ CORRECTLY USED VARIABLES                                                 │
└─────────────────────────────────────────────────────────────────────────────┘

Author & Company (4 used out of 5 declared):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ AUTHOR_NAME                  - Used in system_prompt.txt (lines 1, 4, 45)
✅ COMPANY_NAME                 - Used in system_prompt.txt (lines 1, 9, 45)
✅ AUTHOR_TITLE                 - Used in system_prompt.txt (line 1)
❌ AUTHOR_EXPERIENCE_YEARS      - NOT USED
❌ COMPANY_DESCRIPTION          - NOT USED

Writing Style (4 used out of 4 declared):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ WRITING_TONE                 - Used in system_prompt.txt (line 83)
✅ LANGUAGE_STYLE               - Used in system_prompt.txt (line 4)
✅ HINGLISH_USAGE               - Used in system_prompt.txt (line 4)
✅ STORY_STARTERS               - Used in system_prompt.txt (line 7)

Content Structure (5 used out of 6 declared):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ ARTICLE_LENGTH               - Used in system_prompt.txt (line 81)
✅ MAX_TITLE_WORDS              - Used in system_prompt.txt (lines 51, 56)
✅ MAX_SECTION_TITLE_WORDS      - Used in system_prompt.txt (lines 18, 81)
⚠️  IMAGE_PLACEHOLDERS_COUNT    - Declared but overridden by script calculation
✅ REQUIRED_STORIES_COUNT       - Used in system_prompt.txt (lines 7, 81)
✅ ENGAGEMENT_PROMPTS_COUNT     - Used in system_prompt.txt (lines 48, 81)

Team & Clients (4 used out of 4 declared):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ INDIAN_CITIES                - Used in system_prompt.txt (line 11)
✅ INDIAN_TEAM_NAMES            - Used in system_prompt.txt (line 11)
✅ GLOBAL_CITIES                - Used in system_prompt.txt (line 9)
✅ CLIENT_NAMES                 - Used in system_prompt.txt (line 9)

Engagement (1 used out of 1 declared):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ ENGAGEMENT_HOOKS             - Used in system_prompt.txt (line 15)

HTML Structure (3 used out of 4 declared):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ ALLOWED_HEADINGS             - Used in system_prompt.txt (line 18)
✅ FORBIDDEN_HEADINGS           - Used in system_prompt.txt (lines 18, 81)
✅ SECTION_DIVIDER_CLASS        - Used in system_prompt.txt (line 18)
❌ CONTENT_BLOCK_CLASSES        - NOT USED

Image Styles (10 used out of 10 declared):
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
✅ STYLE_TECHNOLOGY             - Used in system_prompt.txt (line 75)
✅ STYLE_BUSINESS               - Used in system_prompt.txt (line 75)
✅ STYLE_LEADERSHIP             - Used in system_prompt.txt (line 75)
✅ STYLE_TRAVEL                 - Used in system_prompt.txt (line 75)
✅ STYLE_EDUCATION              - Used in system_prompt.txt (line 75)
✅ STYLE_CREATIVE               - Used in system_prompt.txt (line 75)
✅ STYLE_HEALTH                 - Used in system_prompt.txt (line 75)
✅ STYLE_STARTUP                - Used in system_prompt.txt (line 75)
✅ STYLE_SCIENCE                - Used in system_prompt.txt (line 75)
✅ STYLE_CARTOON                - Used in system_prompt.txt (line 75)


═══════════════════════════════════════════════════════════════════════════════
  SECTION 4: image_prompt.txt ANALYSIS
═══════════════════════════════════════════════════════════════════════════════

NOTE: image_prompt.txt is a REFERENCE FILE only. It is NOT directly used in 
blog generation. The script doesn't load or send this file to AI.

Variables used in image_prompt.txt:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

${IMAGE_PLACEHOLDERS_COUNT}     - Line 2 (for documentation)
${STYLE_TECHNOLOGY}             - Line 6
${STYLE_BUSINESS}               - Line 7
${STYLE_LEADERSHIP}             - Line 8
${STYLE_TRAVEL}                 - Line 9
${STYLE_EDUCATION}              - Line 10
${STYLE_CREATIVE}               - Line 11
${STYLE_HEALTH}                 - Line 12
${STYLE_STARTUP}                - Line 13
${STYLE_SCIENCE}                - Line 14
${STYLE_CARTOON}                - Line 15
${IMAGE_QUALITY_SUFFIX}         - Lines 6-15, 21, 24

Status: ⚠️  This file exists but is NOT parsed by the script during blog generation.
        It appears to be documentation or a reference for manual use.
        The variables in this file do NOT affect the actual prompts sent to AI.


═══════════════════════════════════════════════════════════════════════════════
  SECTION 5: SUMMARY & RECOMMENDATIONS
═══════════════════════════════════════════════════════════════════════════════

TOTAL VARIABLES DECLARED: 33 variables in prompt_variables.conf
TOTAL VARIABLES USED IN PROMPT: 30 variables in system_prompt.txt
DYNAMIC VARIABLES (calculated): 2 (TOTAL_IMAGE_PROMPTS, IMAGE_PLACEHOLDER_INSTRUCTIONS)

┌─────────────────────────────────────────────────────────────────────────────┐
│ USAGE BREAKDOWN                                                             │
├─────────────────────────────────────────────────────────────────────────────┤
│ ✅ Declared & Used Correctly:  27 variables (82%)                          │
│ ❌ Declared but NOT Used:        5 variables (15%)                          │
│ ✅ Dynamically Generated:        2 variables (6%)                           │
│ ⚠️  Confusion (name mismatch):   1 variable (3%)                            │
└─────────────────────────────────────────────────────────────────────────────┘


RECOMMENDATIONS:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

1. REMOVE UNUSED VARIABLES from prompt_variables.conf:
   ❌ AUTHOR_EXPERIENCE_YEARS (not used anywhere)
   ❌ COMPANY_DESCRIPTION (not used anywhere)
   ❌ CONTENT_BLOCK_CLASSES (not used anywhere)

2. FIX VARIABLE NAME CONFUSION:
   ⚠️  Either:
       - Remove IMAGE_PROMPTS_INSTRUCTION from prompt_variables.conf (it's not used)
       - OR rename to match what system_prompt.txt uses: IMAGE_PLACEHOLDER_INSTRUCTIONS
       Currently: Declared as IMAGE_PROMPTS_INSTRUCTION but used as IMAGE_PLACEHOLDER_INSTRUCTIONS

3. CLARIFY IMAGE_PLACEHOLDERS_COUNT:
   ⚠️  This is declared in prompt_variables.conf but the script overrides it.
       Either:
       - Remove from prompt_variables.conf (since script calculates it)
       - OR add comment explaining it's a default that gets overridden

4. DECIDE ON IMAGE_QUALITY_SUFFIX:
   ⚠️  Currently declared but only used in image_prompt.txt (which isn't used)
       Either:
       - Use it in system_prompt.txt
       - OR remove it from prompt_variables.conf

5. CLARIFY image_prompt.txt PURPOSE:
   ⚠️  This file exists but isn't used by the script.
       Either:
       - Delete it (if not needed)
       - OR add clear documentation that it's reference-only


CLEAN-UP SUGGESTION:
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Remove these 5 lines from prompt_variables.conf to clean up unused variables:

Line 12:  AUTHOR_EXPERIENCE_YEARS="25"
Line 13:  COMPANY_DESCRIPTION="leading software development..."
Line 31:  IMAGE_PLACEHOLDERS_COUNT="1"  (calculated by script)
Line 57:  CONTENT_BLOCK_CLASSES="content-block image-left..."
Line 78:  IMAGE_QUALITY_SUFFIX="high resolution..."
Line 84:  IMAGE_PROMPTS_INSTRUCTION="You must generate..."

This will leave only the variables that are actually used in the prompts.


═══════════════════════════════════════════════════════════════════════════════
  SECTION 6: VARIABLE FLOW DIAGRAM
═══════════════════════════════════════════════════════════════════════════════

prompt_variables.conf                system_prompt.txt              Final Prompt
━━━━━━━━━━━━━━━━━━━━━              ━━━━━━━━━━━━━━━━━━━━             ━━━━━━━━━━━━
                                                                   
AUTHOR_NAME="Sandeep Mundra"  →    ${AUTHOR_NAME}          →      "Sandeep Mundra"
COMPANY_NAME="IndiaNIC"       →    ${COMPANY_NAME}         →      "IndiaNIC"
WRITING_TONE="confident..."   →    ${WRITING_TONE}         →      "confident..."
[27 more variables...]        →    [27 more ${VARS}...]    →      [Real values...]

❌ AUTHOR_EXPERIENCE_YEARS     →    (not used)              →      (not in prompt)
❌ COMPANY_DESCRIPTION          →    (not used)              →      (not in prompt)
❌ CONTENT_BLOCK_CLASSES        →    (not used)              →      (not in prompt)

blog_generator.sh (script)         system_prompt.txt              Final Prompt
━━━━━━━━━━━━━━━━━━━━━━━━━━         ━━━━━━━━━━━━━━━━━━━━             ━━━━━━━━━━━━

Calculates dynamically         →   ${TOTAL_IMAGE_PROMPTS}  →      "2"
Calculates dynamically         →   ${IMAGE_PLACEHOLDER...} →      "Use EXACTLY 1..."

(not in any file)              →   (used in prompt)         →      (value generated)


═══════════════════════════════════════════════════════════════════════════════
  END OF ANALYSIS
═══════════════════════════════════════════════════════════════════════════════