v1.3.3

[1.3.3] - 2026-03-12

Bug Fix

Agents on fresh installs did not know to reset XP on level-up

When installing to a new project, agents only receive the .opencode folder — not the CHANGELOG. This meant the level-up and XP carry-over behaviour documented in v1.3.0 was never communicated to the agent, so XP would just keep accumulating past level thresholds with no reset.

What was broken:

• All 4 agent files (security, testing, docs, code-review) showed a "Level Thresholds" table with cumulative XP values (0, 150, 450, 900, 1500, 3000) — inconsistent with xp.json which stores per-level XP (150, 300, 450, 1500, 3000)
• No instruction anywhere told the agent to reset xp to 0 on level-up or carry overflow forward
• All 4 skill files (SKILL.md) had the same gap — "Update XP" step with no level-up logic

What was fixed:

• Corrected the Level Thresholds table in all 4 agent files — column renamed from XP Required (cumulative) to XP to Next Level (per-level), values now match xp.json
• Added a mandatory Level-Up Rule block to all 4 agent files and all 4 skill files with explicit step-by-step instructions:
  1. Subtract xpToNextLevel from total XP to get carry-over
  2. Increment level, update title
  3. Set xp to carry-over (never accumulate across levels)
  4. Save to xp.json
  5. Chain if carry-over also exceeds the next threshold

Example now documented directly in every agent and skill file:

Level 1 (xpToNextLevel = 150), earn 230 XP → carry-over = 80 → Save: level = 2, title = "Apprentice", xp = 80