Skip to content

FOLDER_STRUCTURE.md

Latest commit

 

History

History
274 lines (223 loc) · 9.39 KB

FOLDER_STRUCTURE.md

File metadata and controls

274 lines (223 loc) · 9.39 KB

10X Content Expert - Folder Structure Guide

This document explains where to put your files for the Content Expert to work with.

Quick Reference

What You Want To Do Where To Put Files
Edit a PPTX/DOCX/PDF/XLSX file input/
Provide transcripts to learn from references/transcripts/
Show content examples to learn from references/examples/
Define your brand voice references/brand-voice/
Add visual style references samples/

Complete Folder Structure

10x-Content-Expert/
│
├── input/                          # FILES YOU WANT TO EDIT
│   ├── README.md                   # Instructions
│   ├── presentations/              # PPTX files to modify
│   │   └── sales_deck.pptx
│   ├── documents/                  # DOCX files to modify
│   │   └── proposal.docx
│   ├── pdfs/                       # PDF files to modify
│   │   └── brochure.pdf
│   └── spreadsheets/               # XLSX files to modify
│       └── content_calendar.xlsx
│
├── references/                     # CONTENT TO LEARN FROM (TEXT/WRITTEN)
│   ├── README.md                   # Instructions
│   │
│   ├── transcripts/                # Video/audio transcripts
│   │   ├── training/               # Training session transcripts
│   │   │   └── course_module_1.txt
│   │   ├── webinars/               # Webinar transcripts
│   │   │   └── product_launch.txt
│   │   ├── interviews/             # Expert interview transcripts
│   │   │   └── ceo_interview.txt
│   │   └── podcasts/               # Podcast episode transcripts
│   │       └── episode_42.txt
│   │
│   ├── examples/                   # High-performing content examples
│   │   ├── emails/                 # Email examples
│   │   │   ├── welcome/            # Welcome sequence emails
│   │   │   ├── sales/              # Sales emails
│   │   │   └── newsletters/        # Newsletter examples
│   │   ├── social/                 # Social media examples
│   │   │   ├── linkedin/           # LinkedIn posts
│   │   │   ├── twitter/            # Twitter posts/threads
│   │   │   └── instagram/          # Instagram captions
│   │   ├── presentations/          # Presentation examples
│   │   └── blogs/                  # Blog post examples
│   │
│   ├── brand-voice/                # Brand guidelines
│   │   ├── tone-guide.md           # Voice & tone documentation
│   │   ├── messaging-framework.md  # Core messages
│   │   ├── keywords.txt            # Power words to use
│   │   └── avoid-list.txt          # Words to avoid
│   │
│   └── templates/                  # Content templates
│       ├── email/
│       ├── social/
│       ├── ppt/
│       └── blog/
│
├── samples/                        # VISUAL/DESIGN REFERENCES
│   ├── README.md                   # Instructions
│   ├── brand-kits/                 # Brand configuration
│   │   └── brand-config.json
│   ├── images/                     # Image design samples
│   │   ├── social-media/
│   │   ├── posters/
│   │   ├── logos/
│   │   └── banners/
│   ├── presentations/              # PPT design samples
│   │   ├── pitch-decks/
│   │   └── reports/
│   ├── color-palettes/
│   └── fonts/
│
├── output/                         # WHERE RESULTS GO (AUTO-GENERATED)
│   ├── README.md                   # Instructions
│   ├── content/                    # Generated content
│   │   ├── emails/
│   │   ├── social/
│   │   ├── presentations/
│   │   ├── blogs/
│   │   ├── sequences/
│   │   └── hooks/
│   ├── analysis/                   # Analysis results
│   │   ├── themes/
│   │   ├── quotes/
│   │   └── voice/
│   ├── plans/                      # Content plans
│   ├── working/                    # Temporary working copies
│   ├── pdf/                        # Edited PDFs
│   ├── pptx/                       # Edited PPTXs
│   ├── docx/                       # Edited DOCXs
│   ├── xlsx/                       # Edited XLSXs
│   └── logs/                       # Operation logs
│
├── scripts/                        # Python utilities (DON'T MODIFY)
├── .claude/                        # Skills & agents (DON'T MODIFY)
├── .claude-plugin/                 # Plugin config (DON'T MODIFY)
│
├── setup.py                        # Run this first!
├── requirements.txt                # Python dependencies
└── README.md                       # Main documentation

Detailed Explanations

input/ - Files To Edit

Purpose: Put any files here that you want the Content Expert to edit and modify.

What goes here:

  • PowerPoint presentations (.pptx, .ppt)
  • Word documents (.docx, .doc)
  • PDF files (.pdf)
  • Excel spreadsheets (.xlsx, .xls)

IMPORTANT: Your original files are NEVER modified. The system creates a copy in output/working/, makes all changes there, and saves the final result to the appropriate output/ subfolder.

Example:

input/
├── client_presentation.pptx    # Your original (never touched)
└── quarterly_report.docx       # Your original (never touched)

After editing:

output/
├── pptx/
│   └── client_presentation_modified.pptx  # Your edited version
└── docx/
    └── quarterly_report_modified.docx     # Your edited version

references/ - Content To Learn From

Purpose: Put written content here that you want the AI to learn from and reference.

references/transcripts/

Transcripts from videos, webinars, podcasts, or meetings. The Content Expert extracts:

  • Key themes and insights
  • Quotable moments
  • Content ideas
  • Patterns and frameworks

File formats: .txt, .md

Example:

references/transcripts/training/
├── sales_methodology_course.txt
├── marketing_fundamentals.txt
└── leadership_workshop.txt

references/examples/

Your best-performing content that the AI learns from to match your style.

Example:

references/examples/emails/welcome/
├── best_welcome_email_v1.txt
├── best_welcome_email_v2.txt
└── notes.txt  # Why these worked well

references/examples/social/linkedin/
├── viral_post_jan2024.txt
├── high_engagement_post.txt
└── style_notes.txt

references/brand-voice/

Your brand guidelines that ensure consistent voice across all content.

Key files to create:

  • tone-guide.md - Voice and tone documentation
  • messaging-framework.md - Core messages and value props
  • keywords.txt - Words to use frequently
  • avoid-list.txt - Words to never use

samples/ - Visual/Design References

Purpose: Put visual examples here that show your design aesthetic and brand style.

What goes here:

  • Brand assets (logos, colors)
  • Design examples you like
  • Visual style references
  • PPT design templates

Difference from references/:

  • samples/ = Visual/design focused
  • references/ = Written content focused

output/ - Results (Auto-Generated)

Purpose: All generated content and edited files appear here automatically.

You don't need to create anything here. The system organizes outputs by type.

Safety Rules

NEVER Modified

These locations are READ-ONLY - the system never changes files here:

  • input/ - Your original files to edit
  • references/ - Your learning materials
  • samples/ - Your design samples

Always Modified

All changes go to:

  • output/ - All generated content, edited files, analysis results

The Copy Pattern

Original File (input/)  →  Working Copy (output/working/)  →  Result (output/[type]/)
   PROTECTED                   ALL EDITS HERE                    YOUR OUTPUT
   Never touched               Safe to modify                    Final file

Getting Started

  1. Run setup first:

    python setup.py

  2. Add your transcripts to references/transcripts/

  3. Add your content examples to references/examples/

  4. Fill out brand voice guide in references/brand-voice/

  5. Put files to edit in input/

  6. Start Claude Code and use /content command

Example Workflow

"I want to create content from my training videos"

  1. Get transcripts of your training videos
  2. Put them in references/transcripts/training/
  3. Ask: "Analyze my training transcripts and create LinkedIn posts"
  4. Find results in output/content/social/linkedin/

"I want to update my sales presentation"

  1. Put your PPTX in input/sales_deck.pptx
  2. Ask: "Update sales_deck.pptx - change Q3 to Q4"
  3. Original stays in input/ (untouched)
  4. Find edited version in output/pptx/sales_deck_modified.pptx

"I want emails that match my brand voice"

  1. Add example emails to references/examples/emails/
  2. Fill out references/brand-voice/tone-guide.md
  3. Ask: "Create a welcome email sequence in my brand voice"
  4. Find results in output/content/sequences/