Characters Folder

Purpose

This folder contains YOUR personal character progress trackers - living documents that track your journey through Path of Exile with each character.

This is NOT for:

❌ Completed build guides (use builds/ folder)
❌ Reference builds you're researching (use builds/ folder)
❌ Build templates or theory (use builds/ or research/)

This IS for:

✅ Your active characters you're playing right now
✅ Progress tracking (current act, current goals, next steps)
✅ Gear progression logs
✅ Personal notes, learnings, achievements
✅ Budget tracking, currency goals
✅ "Where am I and what am I doing next?"

Folder Structure

characters/
├── index.md (this file)
├── keepers/                      # Current league
│   ├── bitch-my-bad.md          # Character 1
│   └── character-2-name.md      # Character 2
├── settlers/                     # Previous league
│   └── old-character.md
└── standard/                     # Standard league / Retired
    └── archived-character.md

Naming Convention:

League folders: [league-name]/ (lowercase, kebab-case)
Character files: [character-name].md (lowercase, kebab-case)
One file per character (no folders)
Organize by league first, then by character file

Template Requirements

Required Template: templates/character-progress-template.md

Required Frontmatter Fields:

yaml

template: "templates/character-progress-template.md"
document_type: "character-progress"
character_name: "CharacterName"
character_class: "Witch"
ascendancy: "Necromancer"
league: "3.27"
status: "leveling|mapping|endgame|retired|rerolled"
current_progress: "campaign|white-maps|yellow-maps|red-maps|t16-farming|endgame-bosses|uber-content"

Creation Workflow

1. Create League Folder (if needed)

bash

# Create folder for the league if it doesn't exist
mkdir characters/[league-name]

2. Get Template

bash

Read("templates/character-progress-template.md")

3. Create Character File

bash

Write("characters/[league-name]/[character-name].md", content)

4. Update Regularly

Update your progress tracker as you:

Complete acts
Reach new milestones
Get major gear upgrades
Accomplish goals
Learn lessons

Document Philosophy

This is YOUR journal

These documents are:

Personal - Write in your own voice
Living - Update frequently as you progress
Flexible - Add sections that help YOU
Honest - Track failures and learnings too

Focus on the journey

Track:

Where you are right now
What you're working toward
What you learned today
Gear upgrades that made a difference
Currency goals and progress
Memorable moments (good and bad)

Naming Conventions

League Folder Names

Format: [league-name] (kebab-case, lowercase)

Examples:

keepers/ (current league - 3.27)
settlers/ (previous league - 3.26)
standard/ (permanent league / retired characters)
hardcore-keepers/ (hardcore variant)

Character File Names

Format: [league-name]/[character-name].md (kebab-case, lowercase)

Examples:

keepers/bitch-my-bad.md (your Necromancer)
keepers/zoom-zoom-raider.md
settlers/bonk-jugg.md
standard/glass-cannon-deadeye.md

Note: Each character is a single markdown file - no subfolders needed

Character Status Lifecycle

Status	Meaning	When to Use
leveling	Campaign (Acts 1-10)	Character in campaign
mapping	White/Yellow/Red maps	Entered maps, farming
endgame	T16s, pinnacle bosses	Endgame content focus
retired	Not playing anymore	League ended, rerolled, stopped
rerolled	Switched builds	Used Regret orbs, changed build

Progress Stages

Stage	Description
campaign	Acts 1-10
white-maps	T1-T5 maps
yellow-maps	T6-T10 maps
red-maps	T11-T16 maps
t16-farming	Comfortably farming T16s
endgame-bosses	Pinnacle boss progression
uber-content	Uber bosses, T17s

Quality Checklist

Before creating a character tracker:

[ ] Read this index.md for conventions
[ ] Used templates/character-progress-template.md
[ ] Created league folder: characters/[league-name]/ (if needed)
[ ] Created character file: characters/[league-name]/[character-name].md
[ ] Included template: field in frontmatter
[ ] Set correct character_class and ascendancy
[ ] Set current league (must match folder name)
[ ] Set current status and progress stage
[ ] Used absolute paths for relationships
[ ] Added current goals and next steps

Examples

Good Character Structure

characters/
├── index.md
└── keepers/                   # League folder
    ├── bitch-my-bad.md       # Character progress tracker
    └── zoom-zoom-raider.md   # Another character

Good Progress Tracker

Characteristics:

✅ Updated regularly (after each session or major milestone)
✅ Clear current status and next steps
✅ Tracks gear upgrades with dates and costs
✅ Documents learnings and mistakes
✅ Personal voice and observations

Tips for Effective Tracking

Update Frequency

Recommended:

After each play session (quick update)
After major milestones (detailed notes)
After significant gear upgrades
When you learn something important

At Minimum:

Once per act (campaign)
Once per map tier transition
After major purchases
After boss kills

What to Track

Essential:

Current location/progress
Next immediate goals
Current gear (major pieces)
Current wealth

Nice to Have:

Detailed gear progression log
Currency tracking
Death log (lessons learned)
Build evolution notes
Personal reflections

What Makes a Great Tracker

Clear "Where am I now?" - Anyone (including future you) can quickly understand your current state
Actionable next steps - You know exactly what to do when you log in
Progress visibility - You can see how far you've come
Lessons captured - You document what works and what doesn't
Goal tracking - You have clear objectives and track progress

Retiring Characters

When a character is done (league ended, rerolled, etc.):

Update status to retired or rerolled
Add final reflection in "Personal Reflection" section
Option A: Keep in league folder (recommended for league history)
Option B: Move to characters/standard/[character-name].md (for permanent league)

League End Process:

When a league ends, all characters migrate to Standard
You can either:
- Keep the league folder intact as historical record
- Move active characters to characters/standard/
- Archive the entire league folder

Difference: Characters vs Builds

Characters Folder	Builds Folder
Personal progress tracking	Reference build guides
Work in progress	Completed/polished
Updated frequently	Updated when patches change
YOUR journey	Community resource
Flexible structure	Strict template structure
"Where am I?"	"How do I build this?"

Example:

characters/keepers/bitch-my-bad.md - YOUR Act 6 Necromancer journey in Keepers league
builds/witch/spectre-necromancer.md - Polished Spectre Necro build guide

Relationships

Character trackers can reference build guides:

yaml

relationships:
  reference_builds:
    - path: "builds/witch/spectre-necromancer.md"
      title: "Spectre Necromancer Build Guide"
      reason: "Following this guide"

  reference_guides:
    - path: "research/strategy/best-spectres-corpses-3-27.md"
      title: "Best Spectres Guide"
      reason: "Spectre selection reference"

Additional Resources

Template: templates/character-progress-template.md
Build Guides: builds/ folder
Strategy Guides: research/strategy/ folder
Validation: Use /validate skill to check compliance

Questions?

Q: How is this different from builds folder? A: builds/ = reference guides. characters/ = YOUR personal journey tracking.

Q: Do I need to follow the template exactly? A: Use the template as a starting point, but feel free to add/remove sections that help YOU track progress.

Q: Should I track every character? A: Track the characters you're actively playing. Don't worry about one-off tests or quick rerolls.

Q: Can I have multiple characters in one league? A: Yes! Each gets its own file within the league: characters/keepers/char1.md, characters/keepers/char2.md, etc.

Q: What if I respec my character? A: Update status to rerolled, document the change in your progress tracker, and continue tracking.

Happy tracking! This is YOUR journey - make it count!

Characters Folder ​

Purpose ​

Folder Structure ​

Template Requirements ​

Creation Workflow ​

1. Create League Folder (if needed) ​

2. Get Template ​

3. Create Character File ​

4. Update Regularly ​

Document Philosophy ​

This is YOUR journal ​

Focus on the journey ​

Naming Conventions ​

League Folder Names ​

Character File Names ​

Character Status Lifecycle ​

Progress Stages ​

Quality Checklist ​

Examples ​

Good Character Structure ​

Good Progress Tracker ​

Tips for Effective Tracking ​

Update Frequency ​

What to Track ​

What Makes a Great Tracker ​

Retiring Characters ​

Difference: Characters vs Builds ​

Relationships ​

Additional Resources ​

Questions? ​

Characters Folder

Purpose

Folder Structure

Template Requirements

Creation Workflow

1. Create League Folder (if needed)

2. Get Template

3. Create Character File

4. Update Regularly

Document Philosophy

This is YOUR journal

Focus on the journey

Naming Conventions

League Folder Names

Character File Names

Character Status Lifecycle

Progress Stages

Quality Checklist

Examples

Good Character Structure

Good Progress Tracker

Tips for Effective Tracking

Update Frequency

What to Track

What Makes a Great Tracker

Retiring Characters

Difference: Characters vs Builds

Relationships

Additional Resources

Questions?