`.opencode/USER` directory mismatch vs upstream PAI

[wojteksbt]

The OpenCode PAI layout includes a .opencode/USER directory intended to mirror the original PAI .claude/USER directory structure.

However, in upstream/original PAI, .claude/USER no longer exists (and may not have existed in the documented form ever). A proof here danielmiessler/LifeOS#524 (comment). This creates confusion about what the canonical directory layout should be and what should be loaded/injected as “USER context”.

I'm not sure if anything in pai-opencode uses it instead of .opencode/skills/PAI/USER, but if not, can it be removed?

[Steffen025]

🔍 Test result (v3.0 integration)

Status: Structure problem confirmed and scheduled for PAI-OpenCode v3.0

Findings

Structure mismatch between PAI-OpenCode and Upstream PAI v4.0.3 verified:

Location	Upstream PAI v4.0.3	PAI-OpenCode (current)	Status
Root-USER	Does NOT exist	Exists (incorrect)	🔴
PAI-USER	Exists	Exists	✅

Problem: PAI-OpenCode has an additional .opencode/USER/ at the root that does not exist in upstream. This fragments the structure.

Reference

Upstream PAI v4.0.3 only has USER under .claude/PAI/USER/ (or .opencode/PAI/USER/):

• ACTIONS/
• BUSINESS/
• FLOWS/
• PIPELINES/
• PROJECTS/
• TELOS/
• WORK/
• etc.

Integration in v3.0

• WP1 (Algorithm): Initial structure check
• WP4 (Skill Hierarchy): USER directory consolidation with upstream
• Migration: Removal of root USER, consolidation under PAI/USER

Proposed solution

1. Check and migrate contents of .opencode/USER/
2. Merge duplicates under .opencode/skills/PAI/USER/
3. Remove root USER or treat as symlink
4. Alignment with PAI v4.0.3 structure

Next steps

See Epic #31 for complete v3.0 plan. This structure issue is addressed in WP1 and WP4.

---

References: Epic #31 (PAI-OpenCode v3.0 Community Port)

[wojteksbt]

Thank you @Steffen025! Or Danke shön😉

[Steffen025]

@wojteksbt - yeah sry - my ai forgot that we only speak English in GitHub repos ;P

[wojteksbt]

btw. the location has changed again in v4.0 (of the whole PAI directory). It's no longer in skills, but in main path. Are you going to follow that pattern?

[Steffen025]

yes - look at the issue V3.0 Epic - I will restructure pai-opencode to represent pai 4.0.3