Instructions to upgrade from v2.3 to v2.4 do not reference all USER paths required for a complete upgrade

[bde-dev]

Link to instructions: https://github.com/danielmiessler/Personal_AI_Infrastructure/blob/main/Releases/v2.4/README.md#upgrading-from-v23

Current Instructions:

v2.4 is a significant upgrade. Recommended approach:

# 1. Backup your current installation
mv ~/.claude ~/.claude-v2.3-backup

# 2. Install v2.4
cp -r .claude ~/

# 3. Run the wizard
cd ~/.claude && bun run PAIInstallWizard.ts

# 4. Migrate personal content
# Copy USER/ and MEMORY/ from backup if desired

Problem

The above instructions make no reference to the TELOS system in ~/.claude/skills/CORE/USER/TELOS, or anything in ~/.claude/skills/CORE/USER for that matter.

This a key set of folders for users to carry over during an upgrade as it is the foundational concept of the PAI system - aligning a DA to the users goals.

Unsure of other folders that may be missed if using the above instructions as I have only been using PAI for 4 days.

[wojteksbt]

I've been trying to understand this, and I've come to the conclusion that there is no .claude/USER directory defined in PAI. Every time Daniel mentions the /USER directory, he means .claude/skills/CORE(now PAI)/USER. I searched the repository for any proof that there are two separate USER locations and haven't found any.

I'm wondering whether this was something that used to exist and was removed in a later version, or if it's a misunderstanding of Daniel's intention.

Another piece of evidence that (1) this is a common mistake (or a legacy artifact) and (2) only .claude/skills/CORE(now PAI)/USER is canonical: the pai-personal-data repo. It defines two directories (USER/ and CORE_USER/), and describes USER/ as holding files like CONTACTS.md and DAIDENTITY.md — but in PAI itself, those files live in skills/CORE/USER/. The USER/ directory in that repo contains nothing but a .gitkeep. This suggests the author assumed a split that doesn't exist upstream.

@danielmiessler I'd be grateful if you could confirm or correct my understanding. This seems like a point of confusion that might be worth clarifying in the system files.

[danielmiessler]

Thanks for this feedback! We're currently working on PAI v3.0, which includes significant architectural changes. We're evaluating this issue in the context of the new architecture and will provide an update once v3.0 is closer to release.

Please stand by — we haven't forgotten about this and appreciate your contribution to making PAI better!

[kaimagnus]

Thanks for the thorough writeup! The upgrade path from v2.3→v2.4 is now obsolete with v3.0 released. v3.0 has a fresh installer that handles all setup. Please upgrade directly to v3.0.

[wojteksbt]

Well, the newest migration guide (https://github.com/danielmiessler/Personal_AI_Infrastructure/blob/main/Releases/v3.0/README.md#upgrading-from-v25) mentions ~/.claude/USER and not skills/PAI/USER. If it isn't super stale, copied guide, I understand nothing now.

@kaimagnus @danielmiessler Any clarification from your side would be very appreciated. Thank you!

[kaimagnus]

Good catch, @wojteksbt! You're right — the migration guide had the wrong path for USER/.

In v3.0, the correct location is ~/.claude/skills/PAI/USER/ (not ~/.claude/USER). The MEMORY path at ~/.claude/MEMORY was correct.

Fixed in commit 5b294a4 — the upgrade instructions now point to the right path:

cp -r ~/.claude-v2.5-backup/USER ~/.claude/skills/PAI/USER
cp -r ~/.claude-v2.5-backup/MEMORY ~/.claude/MEMORY

Thank you for flagging this!